IA - Inteligencia Artificial - Servidor MCP de VoIPstudio¶

El servidor MCP (Model Context Protocol) de VoIPstudio proporciona a Claude AI acceso directo y seguro a los datos de tu cuenta de VoIPstudio, incluidos grabaciones, CDRs, llamadas en curso y mensajes de voz. Una vez conectado, Claude puede consultar llamadas, analizar patrones, detectar problemas de rendimiento de los agentes y generar informes de control de calidad (QA) en lenguaje natural, sin necesidad de desarrollo personalizado.

Añade el CX Addon y cada grabación llegará previamente enriquecida con una transcripción, resumen, análisis de sentimiento, acciones recomendadas y una puntuación CX. Esto reduce drásticamente el trabajo que Claude necesita realizar, disminuyendo el consumo de tokens y haciendo que los costes sean más predecibles.

Obtención de una clave API¶

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

Para generar una clave:

1. En el panel de administración, abre el usuario para el que deseas 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 mostrar la clave API o 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 seguirá siendo válida siempre que se utilice al menos una vez cada 7 días (tiempo de expiración predeterminado). Si es necesario, configura un periodo de expiración más largo (o ilimitado) antes de hacer clic en Add.

Consulta la documentación de la API REST.

Conexión con Claude¶

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

URL del servidor MCP¶

Pasos (Claude.ai)¶

1. En Claude.ai, ve a Settings → Integrations (o al panel de conectores, según tu plan).
2. Selecciona Add custom MCP server (o la opción equivalente).
3. Introduce la URL del servidor MCP indicada anteriormente.
4. Cuando se solicite autenticación, proporciona tu clave API de VoIPstudio.
5. Guarda y autoriza la conexión.

Claude podrá utilizar ahora las herramientas de VoIPstudio en cualquier conversación. La primera vez que se invoque una herramienta durante una sesión, Claude te pedirá confirmar el acceso a los datos. Haz clic en Always allow para evitar 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"
    }]
  })
});

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 utilizando la misma URL y clave API. Los pasos de configuración exactos variarán según la plataforma. Busca opciones como external MCP server, custom MCP o remote MCP dentro de las integraciones o la configuración de tu plataforma.

CX Addon¶

Sin el CX Addon, las grabaciones llegan únicamente 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 se encarga de la transcripción, generación de resúmenes, análisis de sentimiento, extracción de acciones y cálculo de puntuaciones CX en su propia infraestructura, con un coste mensual fijo, sin cargos por llamada y sin límites de transcripción. Claude recibe información ya procesada y lista para analizar.

Campos habilitados por el CX Addon¶

Referencia de herramientas¶

La simplicidad de la integración MCP significa que no es necesario comprender APIs complejas. En su lugar, se pueden utilizar instrucciones sencillas para que la plataforma de IA interprete los datos proporcionados por VoIPstudio y genere respuestas adecuadas.

Sin embargo, algunos usuarios más técnicos pueden querer entender qué ocurre "bajo el capó". A continuación se muestra una referencia de las principales funciones del servidor MCP.

get_recordings¶

Devuelve grabaciones de llamadas. Cuando el CX Addon está activo, cada registro incluye transcripción, resumen, sentimiento, puntuación CX y línea temporal. Sin el complemento, estos campos devuelven null.

Parámetros

Campos de respuesta

Ejemplo – Puntuaciones CX bajas esta semana

Pregunta a Claude:

"Muéstrame todas las grabaciones de esta semana con una puntuación CX inferior a 6, agrupadas por agente, con un resumen de lo que salió mal en cada llamada."

Claude invocará 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 llamadas (Call Detail Records): el registro bruto de cada tramo de llamada. Útil 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: iguales que get_recordings (filters, limit, page)

Campos principales de respuesta

get_live_calls¶

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

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

get_voicemails¶

Obtiene mensajes de voz. Utiliza la misma interfaz de filters, limit y page que las demás herramientas.

Campos filtrables principales: 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 obtenido desde get_recordings.

Filtrado y paginación¶

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

Casos de uso¶

Informe QA de agentes¶

"Genera un resumen de QA para cada agente este mes: medias de puntuación CX, temas recurrentes de quejas y sus tres llamadas con peor puntuación junto con sus 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 tendencias de sentimiento¶

"¿Está mejorando o empeorando el sentimiento de los clientes en comparación con el mes pasado? ¿Qué temas de conversación se correlacionan con sentimientos negativos?"

Lista de seguimiento de llamadas perdidas¶

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

Revisión de costes y facturación¶

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

Supervisión operativa en tiempo real¶

"¿Cuántos agentes están actualmente en llamadas y existen llamadas que lleven más de 20 minutos en curso?"

Eficiencia de tokens¶

Cada llamada que Claude analiza sin el CX Addon requiere procesar el contenido de audio y generar su propia transcripción y análisis. El CX Addon traslada completamente este trabajo a VoIPstudio.

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

• Transcripción de audio
• Identificación de interlocutores (speaker diarisation)
• Resumen de llamadas
• Clasificación de sentimiento
• Extracción de acciones recomendadas
• Puntuación CX

Lo que recibe Claude: Campos de texto limpios y estructurados, listos para realizar análisis, comparaciones e informes.

Esto permite pedir a Claude que analice cientos de llamadas en una sola sesión por una fracción del coste en tokens, haciendo viables los informes de QA a gran escala, los análisis de tendencias y los informes de formación de agentes sin gastos impredecibles en IA.