Sus estadísticas de llamadas, en lenguaje natural.

Conectarse

Dos formas de conectarse. Con un token: la dirección del endpoint y la cabecera Authorization: Bearer <token> (Claude Code, Claude Desktop, Le Chat, API de OpenAI). Con OAuth, sin token que copiar: solo la dirección y, después, un inicio de sesión con su cuenta VoxoLib (claude.ai, ChatGPT). Elija su cliente.

claude mcp add --transport http voxolib-stats https://mcp-dev2.agent.voxolib.com/mcp?lang=es \
  --header "Authorization: Bearer <token>"Copiar

{
  "type": "mcp",
  "server_label": "voxolib-stats",
  "server_url": "https://mcp-dev2.agent.voxolib.com/mcp?lang=es",
  "headers": { "Authorization": "Bearer <token>" },
  "require_approval": "never"
}

curl -i -X POST https://mcp-dev2.agent.voxolib.com/mcp?lang=es \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1"}}}'

Herramientas

Cada herramienta consulta la API VoxoLib con su token y devuelve un JSON agregado por día, semana o mes. Los estados son los de la API, sin reclasificación. El servidor publica además una guía de uso para el agente (campo instructions del protocolo, disponible también como recurso voxolib://guide): productos, periodos, significado de campos y estados, errores. El agente no tiene nada que adivinar.

Periodos

day acepta today, yesterday, last7days, last30days o una fecha AAAA-MM-DD, y prevalece sobre start_date + end_date (como máximo 180 días entre las dos fechas, más si su cuenta dispone de un límite CDR superior: period.max_days lo indica en cada respuesta). group_by fija la granularidad: day por defecto, week (semanas desde el lunes) o month (meses naturales); las filas llevan entonces period_start y period_end. La zona horaria tz es un nombre IANA, Europe/Paris por defecto.

Idioma del agente

Las descripciones de las herramientas, la guía de uso y los mensajes de error se envían al agente en francés por defecto. Para recibirlos en inglés o en español, añada ?lang=en o ?lang=es a la dirección del endpoint (clientes con token: Claude Code, Le Chat, API de OpenAI, curl). Las cifras y los nombres de los campos son los mismos en todos los idiomas.

Autenticación y datos

El token

Se aceptan dos formas. El token MCP dedicado, de la forma vxmcp_…, lo entrega VoxoLib solo para este servidor: da acceso únicamente a las estadísticas y se revoca sin afectar a sus demás integraciones. El token Enhanced de la API v2 también funciona:

token = api_public_key + "." + HMAC_SHA256(api_public_key + "cdr", client_secret_key)

El inicio de sesión OAuth

Los clientes que no pueden enviar una cabecera (claude.ai, ChatGPT, Claude Desktop en modo conector) pasan por el servidor de autorización VoxoLib, https://dev-app.voxolib.com, descubierto automáticamente gracias a los metadatos /.well-known/oauth-protected-resource. Flujo authorization code con PKCE, registro dinámico de clientes, un solo scope: stats:read. Inicia sesión con su cuenta de espacio de cliente y da su consentimiento una vez. El token de acceso entregado al cliente es un token MCP dedicado vxmcp_…, limitado a las estadísticas, renovado por el cliente y revocable desde su espacio de cliente.

Qué hace el servidor

Verifica el token ante la API VoxoLib al abrir la sesión y lo reenvía en cada llamada a una herramienta. No almacena ningún secreto ni conserva ningún dato. Sin token, o con un token rechazado, la conexión se rechaza con 401 y una cabecera WWW-Authenticate que indica a los clientes OAuth dónde autorizarse. El servidor nunca ve su contraseña: el inicio de sesión se realiza en el servidor de autorización VoxoLib.

Qué sale

Recuentos de llamadas y desgloses por estado, por día, semana o mes. Nunca un número de teléfono, una grabación ni una transcripción. Se aplican las cuotas de la API: por cuenta, 500 solicitudes por hora por defecto en las estadísticas.

Estado y versión

Servicio

leyendo /healthz…

Versión del servidor

0.3.5

Transporte

MCP Streamable HTTP, sesiones por cabecera Mcp-Session-Id

Legible por máquinas

Ficha del servidor, formato del registro MCP

/.well-known/mcp/server.json

Recurso protegido OAuth (RFC 9728)

/.well-known/oauth-protected-resource

Salud

/healthz

Ayuda

Con OAuth (claude.ai, ChatGPT) no hay nada que solicitar: bastan sus credenciales del espacio de cliente, y el acceso se revoca desde ese espacio. Para un token MCP que copiar (Claude Code, Le Chat, API de OpenAI), lo crea VoxoLib en su ficha de cliente: para obtenerlo, renovarlo o revocarlo, diríjase a su contacto habitual de VoxoLib. Una duda sobre las cifras devueltas: son idénticas a las de la API v2 y de su espacio de cliente, con el mismo periodo y la misma zona horaria.