• Un compte API Voxolib avec les droits report activés (WCB et/ou DID) : api_public_key + client_secret_key.
• Un token Enhanced (persistant) calculé ainsi :
  access_token = api_public_key + "." + HMAC_SHA256(api_public_key + "cdr", client_secret_key)
• Transport : HTTP streamable. Endpoint : https://mcp.agent.voxolib.com/mcp
• Auth : en-tête Authorization: Bearer <access_token>

# bash / openssl
PK=votre_api_public_key ; SECRET=votre_client_secret_key
HMAC=$(printf "%s" "${PK}cdr" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')
echo "${PK}.${HMAC}"

# python
import hmac, hashlib
token = f"{pk}." + hmac.new(secret.encode(), (pk+"cdr").encode(), hashlib.sha256).hexdigest()

Paramètres (tools d'appels) : start_date, end_date (YYYY-MM-DD, ≤90 j), tz (défaut Europe/Paris). voxolib_dids : sans paramètre.

Claude Code (CLI) :

claude mcp add --transport http voxolib-stats https://mcp.agent.voxolib.com/mcp \
  --header "Authorization: Bearer <access_token>"

Claude Desktop : Réglages → Connectors → Add custom connector → URL https://mcp.agent.voxolib.com/mcp, en-tête Authorization: Bearer <access_token>.

API (Responses / Agents) — déclarer un outil de type mcp :

{
  "type": "mcp",
  "server_label": "voxolib-stats",
  "server_url": "https://mcp.agent.voxolib.com/mcp",
  "headers": { "Authorization": "Bearer <access_token>" },
  "require_approval": "never"
}

ChatGPT (Pro/Business, mode développeur) : Paramètres → Connectors → connecteur MCP personnalisé → même URL + en-tête.

Le Chat : Paramètres → Connecteurs / MCP → ajouter un serveur MCP distant → URL https://mcp.agent.voxolib.com/mcp + en-tête Authorization: Bearer <access_token>.

SDK (Agents API) : rattacher un serveur MCP distant via mcp_servers (transport HTTP streamable) avec le même endpoint et l'en-tête d'autorisation.