Voipstudio MCP

AI - Inteligencia Artificial - Servidor MCP de VoIPstudio

El servidor MCP (Model Context Protocol) de VoIPstudio le da a Claude AI acceso directo y seguro a los datos de tu cuenta 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ñade el CX Addon y cada grabación llega preenriquecida con 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 tu consumo de tokens y haciendo los costes más predecibles.

Cómo obtener una clave API

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

Para generar una clave:

1. En el panel de administración, abre el usuario para el que quieres generar un token.
2. Ve a la sección API Keys.
3. Introduce un nombre para la clave — por ejemplo, Claude MCP.
4. Haz clic en Add.
5. Haz clic en el icono del ojo para revelar la clave API / user_token. Copia este valor.
6. Para ver más detalles o eliminar la clave, haz clic en el icono de engranaje y selecciona Show Details.

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

Consulta la documentación de la API REST

Conexión con Claude

VoIPstudio no aparece actualmente en el directorio de conectores de Claude.ai. Debes añadirlo manualmente como servidor MCP personalizado.

URL del servidor MCP

[!info] URL del servidor MCP https://mcp.voipstudio.workers.dev/sse

Pasos (Claude.ai)

1. En Claude.ai, ve a Settings → Integrations (o al panel de conectores, según tu plan).
2. Elige Add custom MCP server (o equivalente).
3. Introduce la URL del servidor MCP indicada arriba.
4. Cuando se te solicite autenticación, proporciona tu clave API de VoIPstudio.
5. Guarda y autoriza 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 te pedirá que confirmes el intercambio de datos. Haz clic en Always allow para omitir esta solicitud 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"
    }]
  })
});

Conexión con otras plataformas de IA

La mayoría de las plataformas de IA que admiten MCP externos pueden conectarse al servidor MCP de VoIPstudio usando la misma URL y clave API. Los pasos exactos de configuración varían según la plataforma. Busca una opción etiquetada como external MCP server, custom MCP o remote MCP en las integraciones o ajustes de tu 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 una cantidad significativa de tokens por grabación.

Con el CX Addon, VoIPstudio gestiona 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 cargos por llamada y sin límites de transcripción. Claude recibe inteligencia ya procesada, lista para razonar de inmediato.

	Sin CX Addon	Con CX Addon
Transcripción	Claude debe obtener el audio y transcribir/traducir	✓ Incluida, con diarización de hablantes
Resumen	Claude debe generarlo	✓ Incluido
Sentimiento	Claude debe inferirlo	✓ Incluido
Elementos de acción	Claude debe extraerlos	✓ Incluidos
Puntuación CX	No disponible	✓ 1–10 en cada llamada
Aprox. tokens/llamada	10.000–15.000	300–500
Modelo de coste	Gasto variable de IA	Suscripción mensual fija

Campos desbloqueados por CX Addon

Campo	Tipo	Descripción
transcript	string	Transcripción completa palabra por 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: positive, neutral, negative
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 comprender 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 adecuada.

Sin embargo, algunos usuarios más técnicos pueden querer saber qué ocurre "bajo el capó", así que a continuación se ofrece 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, el resumen, el sentimiento, la puntuación CX y la línea de tiempo. Sin el addon, estos campos devuelven null.

Parámetros

Parámetro	Tipo	Predeterminado	Descripción
filters	array	—	Objetos de filtro — consulta Filtering
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	Enlace al CDR call_id
timestamp	string	Inicio de la grabación (UTC, YYYY-MM-DD HH:mm:ss)
caller	string	Número de la parte que llama
called	string	Número de la parte llamada
src_name	string	Nombre del agente (origen)
dst_name	string	Nombre del destino
duration	number	Duración en segundos
type	string	I \= entrante, O \= saliente
context	string	Contexto de la llamada (p. 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

Pídele 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 lo que 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 bruto de cada tramo de llamada. Úsalo 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 clave de respuesta

Campo	Tipo	Descripción
call_id	number	Identificador único de llamada
calldate	string	Marca de tiempo de inicio de la llamada (UTC)
src_name	string	Nombre del agente / llamante
dst_name	string	Nombre del destino
billsec	number	Segundos facturables
duration	number	Segundos totales incluyendo el 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 / user-agent 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 tu 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 buzón de voz. Misma interfaz de filters, limit y page que las otras herramientas.

Campos clave filtrables: 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 de get_recordings.

[!info] Información Las URL de audio tienen validez limitada en el tiempo. Úsalas con prontitud; no las almacenes en caché durante períodos prolongados.

Filtrado y paginación

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

Propiedad	Descripción
property	Nombre del campo sobre el que filtrar (p. 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

"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 peor puntuación 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 responder?"

Análisis de tendencia de sentimiento

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

Lista de seguimiento de llamadas perdidas

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

Revisión de costes y facturación

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

Comprobación de operaciones en vivo

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

Eficiencia de tokens

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

Lo que gestiona VoIPstudio (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 recibe Claude: Campos de texto limpios y estructurados, listos para razonar, comparar y generar informes.

Esto significa que puedes pedirle a Claude que analice cientos de llamadas en una sola sesión a una fracción del coste en tokens, haciendo viables los informes de control de calidad a gran escala, el análisis de tendencias y los informes de coaching de agentes sin un gasto impredecible en IA.