Voipstudio MCP Server

IA - Inteligencia Artificial - Servidor MCP de VoIPstudio¶

El servidor MCP (Protocolo de Contexto de Modelo) de VoIPstudio le da a Claude AI acceso directo y seguro a los datos de su cuenta de VoIPstudio, incluyendo grabaciones, CDRs, llamadas en vivo y mensajes de voz. Una vez conectado, Claude puede consultar llamadas, analizar patrones, detectar problemas de rendimiento de agentes y generar informes de control de calidad en lenguaje natural, sin necesidad de desarrollo personalizado.

Añada el CX Addon y cada grabación llegará preenriquecida con una transcripción, resumen, sentimiento, elementos de acción y una puntuación CX. Esto reduce drásticamente el trabajo de IA que Claude necesita hacer, manteniendo bajo el uso de tokens y los costes más predecibles.

Obtener una clave API¶

El servidor MCP se autentica usando un token API de VoIPstudio. Cada clave está limitada a un usuario específico, por lo que Claude solo podrá acceder a los datos a los que ese usuario pueda acceder.

Para generar una clave:

1. En el panel de administración, abra el usuario para el que desea generar un token.
2. Vaya a la sección API Keys.
3. Introduzca un nombre para la clave — por ejemplo, Claude MCP.
4. Haga clic en Add.
5. Haga clic en el icono del ojo para revelar la clave API / user_token. Copie este valor.
6. Para ver más detalles o eliminar la clave, haga clic en el icono del engranaje y seleccione Show Details.

Nota: La clave API permanece válida siempre que se use al menos una vez cada 7 días (tiempo de espera predeterminado). Establezca un tiempo de espera más largo (o ilimitado) si es necesario antes de hacer clic en Add.

Ver documentación de la API REST

Conectar a Claude¶

VoIPstudio no aparece actualmente en el directorio de conectores de Claude.ai. Se añade manualmente como un servidor MCP personalizado.

URL del servidor MCP¶

URL del servidor MCP

https://mcp.voipstudio.workers.dev/sse

Pasos (Claude.ai)¶

1. En Claude.ai, vaya a Settings → Integrations (o al panel de conectores, según su plan).
2. Elija Add custom MCP server (o equivalente).
3. Introduzca la URL del servidor MCP anterior.
4. Cuando se le solicite autenticación, proporcione su clave API de VoIPstudio.
5. Guarde y autorice la conexión.

Claude ahora puede llamar a las herramientas de VoIPstudio en cualquier conversación. La primera vez que se llame a una herramienta en una sesión, Claude le pedirá que confirme el intercambio de datos. Haga clic en Always allow para omitir este aviso en futuras sesiones.

API de Anthropic (para desarrolladores)¶

const response = await fetch("https://api.anthropic.com/v1/messages", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Api-Key": "YOUR_ANTHROPIC_API_KEY"
  },
  body: JSON.stringify({
    model: "claude-sonnet-4-6",
    max_tokens: 1024,
    mcp_servers: [{
      type: "url",
      url: "https://mcp.voipstudio.workers.dev/sse",
      name: "voipstudio",
      authorization_token: "YOUR_VOIPSTUDIO_API_KEY"
    }],
    messages: [{
      role: "user",
      content: "Show me agents with a CX score below 6 this week"
    }]
  })
});

Conectar a otras plataformas de IA¶

La mayoría de las plataformas de IA que admiten MCPs externos pueden conectarse al servidor MCP de VoIPstudio usando la misma URL y clave API. Los pasos exactos de configuración variarán según la plataforma. Busque una opción etiquetada como external MCP server, custom MCP o remote MCP en las integraciones o ajustes de su plataforma.

CX Addon¶

Sin el CX Addon, las grabaciones llegan como metadatos sin procesar. Claude debe transcribir y analizar cada llamada por sí mismo, consumiendo tokens significativos por grabación.

Con el CX Addon, VoIPstudio maneja la transcripción, el resumen, el análisis de sentimiento, la extracción de acciones y la puntuación CX en su propia infraestructura a un coste mensual fijo sin tarifas por llamada y sin límites de transcripción. Claude recibe inteligencia terminada — lista para razonar de inmediato.

Sin CX Addon	Con CX Addon
Transcripción	Claude debe obtener audio y transcribir/traducir	✓ Incluida, con diarización de hablantes
Resumen	Claude debe generar	✓ Incluido
Sentimiento	Claude debe inferir	✓ Incluido
Elementos de acción	Claude debe extraer	✓ Incluidos
Puntuación CX	No disponible	✓ 1–10 en cada llamada
Tokens aprox./llamada	10,000–15,000	300–500
Modelo de coste	Gasto variable en IA	Suscripción mensual fija

Campos desbloqueados por CX Addon¶

Campo	Tipo	Descripción
transcript	string	Transcripción completa a nivel de palabra
transcript_speakers	object	Segmentos de transcripción con diarización de hablantes
summary	string	Resumen conciso del resultado de la llamada
sentiment	string	Sentimiento del cliente: positivo, neutral, negativo
cx_score	number (1–10)	Puntuación de experiencia del cliente
metadata.timeline	array	Momentos clave y elementos de acción extraídos de la llamada

Referencia de Herramientas¶

La simplicidad de la integración MCP significa que no es necesario entender APIs complejas y, en su lugar, simples indicaciones pueden ayudar a la plataforma de IA a dar sentido a los datos proporcionados por Voipstudio y responder con una respuesta apropiada.

Sin embargo, algunos usuarios más técnicos pueden desear saber qué sucede "bajo el capó", por lo que a continuación se muestra una guía de referencia de algunas de las funciones del servidor MCP.

get_recordings¶

Devuelve grabaciones de llamadas. Con el CX Addon activo, cada registro incluye la transcripción, resumen, sentimiento, puntuación CX y línea de tiempo. Sin el addon, estos campos devuelven null.

Parámetros

Parámetro	Tipo	Predeterminado	Descripción
filters	array	—	Objetos de filtro — ver Filtrado
limit	number	10	Registros por página (máx. 1000)
page	number	1	Número de página

Campos de respuesta

Campo	Tipo	Descripción
id	number	ID único de grabación
call_id	number	Enlaza con call_id del CDR
timestamp	string	Inicio de grabación (UTC, YYYY-MM-DD HH:mm:ss)
caller	string	Número de la parte llamante
called	string	Número de la parte llamada
src_name	string	Nombre del agente (origen)
dst_name	string	Nombre de destino
duration	number	Duración en segundos
type	string	I \= entrante, O \= saliente
context	string	Contexto de llamada (ej. LOCAL_USER, QUEUE)
transcript	string	null
transcript_speakers	object	null
summary	string	null
sentiment	string	null
cx_score	number	null
metadata.timeline	array	null

Ejemplo – Puntuaciones CX bajas esta semana

Pregunte a Claude: "Muéstrame todas las grabaciones de esta semana donde la puntuación CX fue inferior a 6, agrupadas por agente, con un resumen de qué salió mal en cada llamada."

Claude llama a la herramienta con:

{
  "filters": [
    { "property": "calldate", "operator": "gte", "value": "2026-06-09 00:00:00" },
    { "property": "cx_score",  "operator": "lt",  "value": 6 }
  ],
  "limit": 100
}

get_cdrs¶

Registros de Detalle de Llamada – el registro sin procesar de cada tramo de llamada. Úselo para estadísticas de volumen, análisis de costes, distribuciones de duración y resúmenes de actividad de agentes. Disponible sin el CX Addon.

Parámetros: igual que get_recordings (filters, limit, page)

Campos de respuesta clave

Campo	Tipo	Descripción
call_id	number	Identificador único de llamada
calldate	string	Marca de tiempo de inicio de llamada (UTC)
src_name	string	Nombre del agente / llamante
dst_name	string	Nombre de destino
billsec	number	Segundos facturables
duration	number	Segundos totales incluyendo tono de llamada
disposition	string	CONNECTED, NO ANSWER, BUSY, FAILED
charge	number	Coste de la llamada
type	string	I \= entrante, O \= saliente
src_ua	string	Dispositivo de origen / agente de usuario del softphone
labels	array	Etiquetas personalizadas aplicadas en VoIPstudio

get_live_calls¶

Devuelve una instantánea en tiempo real de todas las llamadas activas en su cuenta. No requiere parámetros.

Ejemplo: "¿Cuántas llamadas están en curso ahora mismo y qué agentes están en ellas?"

get_voicemails¶

Obtiene mensajes de voz. Misma interfaz de filters, limit y page que otras herramientas.

Campos filtrables clave: src, dst, calldate, duration, listened

get_recording_audio¶

Devuelve una URL de descarga directa para el audio MP3 de una grabación específica.

Parámetro: id (number) — el campo id de una respuesta get_recordings.

Información

Las URLs de audio tienen un tiempo limitado. Úselas con prontitud; no las almacene en caché durante períodos prolongados.

Filtrado y Paginación¶

Todas las herramientas de lista aceptan un array filters opcional. Cada objeto de filtro tiene tres propiedades:

Propiedad	Descripción
property	Nombre del campo a filtrar (ej. calldate, cx_score, src_name)
operator	eq, ne, lt, lte, gt, gte, in, like, notlike
value	String, number o array (para el operador in)

Ejemplos comunes¶

Rango de fechas

[
  { "property": "calldate", "operator": "gte", "value": "2026-06-01 00:00:00" },
  { "property": "calldate", "operator": "lte", "value": "2026-06-30 23:59:59" }
]

Umbral de puntuación CX

[{ "property": "cx_score", "operator": "gte", "value": 8 }]

Agente específico

[{ "property": "src_name", "operator": "eq", "value": "Jane Ryder" }]

Solo llamadas conectadas

[{ "property": "disposition", "operator": "eq", "value": "CONNECTED" }]

Llamadas entrantes de más de 5 minutos

[
  { "property": "type",     "operator": "eq",  "value": "I" },
  { "property": "billsec",  "operator": "gt",  "value": 300 }
]

Casos de Uso¶

Informe de control de calidad del agente¶

"Dame un resumen de control de calidad para cada agente este mes — promedios de puntuación CX, temas de queja comunes y sus tres llamadas con puntuación más baja con resúmenes."

Estadísticas de volumen del centro de llamadas¶

"¿Cuál fue nuestro volumen de llamadas por día esta semana? ¿Cuál fue nuestro tiempo medio de gestión y cuántas llamadas quedaron sin respuesta?"

Análisis de tendencia de sentimiento¶

"¿Está mejorando o disminuyendo el sentimiento del cliente en comparación con el mes pasado? ¿Qué temas de llamadas se correlacionan con sentimiento negativo?"

Lista de seguimiento de llamadas perdidas¶

"Enumera todas las llamadas entrantes perdidas de las últimas 24 horas con identificadores de llamante, para que pueda priorizar las devoluciones de llamada."

Revisión de costes y facturación¶

"¿Qué extensiones han realizado las llamadas salientes más caras este trimestre?"

Verificación de operaciones en vivo¶

"¿Cuántos agentes están actualmente en llamadas y hay alguna llamada que haya estado activa más de 20 minutos?"

Eficiencia de Tokens¶

Cada llamada que Claude analiza sin el CX Addon requiere que Claude procese contenido de audio y genere su propia transcripción y análisis. El CX Addon descarga esto por completo a VoIPstudio:

Lo que VoIPstudio maneja (coste mensual fijo, llamadas ilimitadas):

• Transcripción de audio
• Diarización de hablantes
• Resumen de llamadas
• Clasificación de sentimiento
• Extracción de elementos de acción
• Puntuación CX

Lo que Claude recibe: Campos de texto limpios y estructurados listos para razonamiento, comparación e informes.

Esto significa que puede pedirle a Claude que analice cientos de llamadas en una sola sesión a una fracción del coste en tokens, haciendo prácticos los informes de control de calidad a gran escala, análisis de tendencias y coaching de agentes sin gastos impredecibles en IA.