IA - Inteligencia Artificial - Servidor MCP de Voipstudio
El servidor MCP (Model Context Protocol) de Voipstudio proporciona a asistentes de IA como Claude y ChatGPT un acceso directo y seguro a los datos de tu cuenta de Voipstudio, incluidos grabaciones, CDRs, llamadas en curso, mensajes de voz y el historial de tus conversaciones con un número. Una vez conectado, el asistente 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 en gran medida el trabajo que tiene que hacer la IA, lo que mantiene bajo el consumo de tokens y hace que los costes sean más predecibles.
URL del servidor MCP
URL del servidor MCP
Se trata de un servidor MCP remoto (transporte Streamable HTTP). Se conecta iniciando sesión con tu cuenta de Voipstudio: no hay ninguna clave API que crear ni pegar.
Cómo funciona la conexión
Cuando añades el servidor a una aplicación de IA, la aplicación abre una página de inicio de sesión de Voipstudio:
- Inicia sesión con tu correo electrónico y tu contraseña de Voipstudio, junto con tu código 2FA si tienes activada la autenticación de dos factores, o con Google, Microsoft o Apple si tu cuenta utiliza el inicio de sesión único. La cuenta debe existir previamente: desde esta página no se puede crear una cuenta nueva.
- Una página de consentimiento muestra quién solicita el acceso. Indica la dirección que recibirá el acceso y, si la aplicación es conocida (Claude, ChatGPT) o se ejecuta en tu propio ordenador, también su nombre. Cualquier otro sitio web se muestra con una advertencia: concede el acceso solo si reconoces la dirección.
- Haz clic en Allow para conectar, o en Cancel para no conectar nada.
A partir de ese momento, el asistente puede ver lo mismo que tu usuario de Voipstudio, y nada más.
La clave API que recibe cada aplicación
Al hacer clic en Allow, el servidor crea una clave API de Voipstudio para esa aplicación en la sección API Keys de tu usuario. Su nombre empieza por VoIPstudio MCP - seguido de la aplicación, por ejemplo VoIPstudio MCP - Claude (claude.ai) [1a2b3c4d].
- Cada aplicación conectada tiene su propia clave. Si vuelves a iniciar sesión desde la misma aplicación, solo se sustituye la clave de esa aplicación, por lo que tus demás aplicaciones siguen conectadas.
- Un usuario puede tener hasta 10 de estas claves. Al conectar una undécima aplicación, se elimina la que lleva más tiempo sin usarse.
- Una clave caduca tras 30 días sin usarse. El uso normal, incluida la renovación del inicio de sesión que la aplicación realiza en segundo plano, la mantiene activa.
- Para desconectar una aplicación, quita el conector en la aplicación o elimina su clave en API Keys. Una vez eliminada la clave, las invocaciones de herramientas de la aplicación informan de que se ha eliminado la conexión, y la aplicación te pide que vuelvas a iniciar sesión.
Conexión con Claude
En Claude (web o aplicación de escritorio), añade Voipstudio como conector personalizado:
- Abre Settings → Connectors y elige Add custom connector. En los planes Team y Enterprise, es un propietario quien añade el conector para la organización.
- Introduce un nombre, por ejemplo
Voipstudio, y la URL del servidor MCP indicada arriba. - Haz clic en Connect y completa los pasos de inicio de sesión y consentimiento descritos anteriormente.
Claude ya puede utilizar las herramientas de Voipstudio en cualquier conversación. La primera vez que se invoca una herramienta, Claude te pide confirmación. Elige Always allow para no volver a ver este aviso.
Claude Code
claude mcp add --transport http voipstudio https://mcp.voipstudio.com/mcp
claude mcp login voipstudio
Tu navegador abre la página de inicio de sesión. Tras hacer clic en Allow, haz clic en Continue para devolver el inicio de sesión a Claude Code.
En un equipo sin navegador, por ejemplo a través de SSH, ejecuta en su lugar claude mcp login voipstudio --no-browser. Abre en un navegador de cualquier ordenador la dirección que muestra el comando, inicia sesión y permite el acceso, y después copia la dirección que aparece en la página final y pégala en Claude Code cuando se te solicite.
Conexión con otras plataformas de IA
Cualquier aplicación de IA compatible con servidores MCP remotos con inicio de sesión (OAuth) puede conectarse mediante la URL anterior; por ejemplo, ChatGPT, si tu plan permite conectores personalizados. Busca en la configuración de la aplicación una opción llamada custom connector, custom MCP o remote MCP, introduce la URL y completa los pasos de inicio de sesión y consentimiento. Los menús exactos dependen de la aplicación y de tu plan.
Las aplicaciones que solo pueden enviar una clave API fija no pueden conectarse: este servidor solo acepta el inicio de sesión que emite él mismo.
Para desarrolladores
El servidor implementa la autorización de MCP:
- Flujo de código de autorización de OAuth 2.1 con PKCE (
S256) y registro dinámico de clientes. Los metadatos se publican enhttps://mcp.voipstudio.com/.well-known/oauth-authorization-serveryhttps://mcp.voipstudio.com/.well-known/oauth-protected-resource/mcp. - Los tokens de acceso son válidos durante una hora y se renuevan con un token de actualización. Un token de actualización sigue siendo válido mientras se utilice al menos una vez cada 30 días.
- Solo
initializeytools/listfuncionan sin token. No se acepta una clave API de Voipstudio como token de tipo bearer. - Las solicitudes están limitadas por dirección de cliente: 20 registros de cliente por hora, y 50 solicitudes de token y 100 solicitudes de autorización cada 15 minutos.
Para llamar al servidor a través del conector MCP de la API de Claude, tu aplicación obtiene un token de acceso mediante el flujo anterior y lo pasa como authorization_token del servidor. Consulta la documentación del conector MCP de Anthropic para conocer el formato de la solicitud.
CX Addon
Sin el CX Addon, las grabaciones llegan como metadatos sin procesar. La IA debe transcribir y analizar cada llamada por sí misma, lo que consume una cantidad considerable de tokens por grabación.
Con el CX Addon, Voipstudio se encarga de la transcripción, la generación de resúmenes, el análisis de sentimiento, la extracción de acciones y el cálculo de la puntuación CX en su propia infraestructura, con un coste mensual fijo, sin cargos por llamada y sin límites de transcripción. La IA recibe información ya procesada, lista para analizarla de inmediato.
| Sin CX Addon | Con CX Addon | |
|---|---|---|
| Transcripción | La IA debe descargar el audio y transcribir/traducir | ✓ Incluida, con identificación de interlocutores |
| Resumen | La IA debe generarlo | ✓ Incluido |
| Sentimiento | La IA debe inferirlo | ✓ Incluido |
| Acciones recomendadas | La IA debe extraerlas | ✓ Incluidas |
| Puntuación CX | No disponible | ✓ De 1 a 10 en cada llamada |
| Tokens aprox./llamada | 10.000–15.000 | 300–500 |
| Modelo de costes | Gasto variable en IA | Suscripción mensual fija |
Campos habilitados por el CX Addon
| Campo | Tipo | Descripción |
|---|---|---|
transcript | string | Transcripción completa palabra por palabra |
transcript_speakers | object | Segmentos de transcripción con identificación de interlocutores |
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 acciones extraídas de la llamada |
Referencia de herramientas
Con MCP no necesitas aprender la API de Voipstudio: preguntas en lenguaje natural y la IA elige las herramientas y lee los datos por ti.
Para los usuarios técnicos que quieran saber qué ocurre "bajo el capó", el servidor ofrece las seis herramientas que se describen a continuación. Todas ellas solo leen datos.
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 temporal. Sin el complemento, estos campos son null.
Parámetros
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
filters | array | — | Objetos de filtro; consulta Filtrado, ordenación y paginación más abajo |
sort | object | — | { "by": "<field>", "dir": "ASC" } o "DESC" |
limit | number | 10 | Registros por página (1–1000) |
page | number | 1 | Número de página |
Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
id | number | Identificador único de la grabación |
call_id | number | Vinculado al call_id del CDR |
timestamp | string | Inicio de la grabación (UTC, YYYY-MM-DD HH:mm:ss) |
caller | string | Número del llamante |
called | string | Número llamado |
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 (ej. LOCAL_USER, QUEUE) |
transcript | string | null | Transcripción completa (CX Addon) |
transcript_speakers | object | null | Transcripción por interlocutores (CX Addon) |
summary | string | null | Resumen de la llamada (CX Addon) |
sentiment | string | null | Sentimiento del cliente (CX Addon) |
cx_score | number | null | Puntuación CX de 1 a 10 (CX Addon) |
metadata.timeline | array | null | Eventos y acciones clave (CX Addon) |
Ejemplo – Puntuaciones CX bajas esta semana
Pregunta: "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."
La IA invoca la herramienta con:
{
"filters": [
{ "property": "timestamp", "operator": "gte", "value": "2026-11-09 00:00:00" },
{ "property": "cx_score", "operator": "lt", "value": 6 }
],
"sort": { "by": "cx_score", "dir": "ASC" },
"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: los mismos que get_recordings (filters, sort, limit, page)
Campos principales de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
call_id | number | Identificador único de llamada |
calldate | string | Fecha y hora de inicio de la llamada (UTC) |
src_name | string | Nombre del agente o llamante |
dst_name | string | Nombre del destino |
billsec | number | Segundos facturables |
duration | number | Segundos totales, incluido el timbrado |
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 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. Acepta los mismos parámetros filters, sort, limit y page que get_recordings.
Campos principales: caller, callerid, dialled (el número marcado), origtime (momento en que se dejó el mensaje), duration, folder, is_new, transcript
get_recording_audio
Devuelve la dirección del audio MP3 de una grabación, junto con el llamante, el número llamado, la hora y la duración.
Parámetro: id (number) — el campo id de una respuesta de get_recordings.
La dirección apunta a la API de Voipstudio. La descarga requiere una clave API de Voipstudio enviada en la cabecera x-auth-token, por lo que la IA recibe la dirección, no el audio.
get_history_for_number
Enumera las conversaciones (llamadas y SMS) de tu cuenta con un número de teléfono.
Parámetros
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
number | string | — | El número de teléfono (obligatorio) |
fromDateTime | string | — | Inicio opcional, YYYY-MM-DD HH:mm:ss |
toDateTime | string | — | Fin opcional, YYYY-MM-DD HH:mm:ss |
Campos de respuesta (una entrada por llamada o mensaje): channel, date, direction (Inbound o Outbound), src, dst, src_name, dst_name, content
Ejemplo: "Muéstrame todas las llamadas y SMS de este mes con el +44 20 7946 0000."
Filtrado, ordenación y paginación
get_recordings, get_cdrs y get_voicemails aceptan un array filters opcional. Cada objeto de filtro contiene tres propiedades:
| Propiedad | Descripción |
|---|---|
property | Cualquier campo de la respuesta de la herramienta (ej. calldate, cx_score, src_name) |
operator | eq, ne, lt, lte, gt, gte, in, like, notlike (también funcionan los símbolos =, !=, <, <=, >, >=) |
value | Cadena, número o array (para el operador in) |
El campo de fecha varía según la herramienta: calldate para los CDRs, timestamp para las grabaciones y origtime para los mensajes de voz.
Los resultados se ordenan con sort, por ejemplo { "by": "calldate", "dir": "DESC" }, y se paginan con limit (10 por defecto, 1000 como máximo) y page (1 por defecto).
Ejemplos habituales
Rango de fechas (CDRs)
[
{ "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 (grabaciones)
[{ "property": "cx_score", "operator": "gte", "value": 8 }]
Agente específico
[{ "property": "src_name", "operator": "eq", "value": "Jane Ryder" }]
Solo llamadas conectadas (CDRs)
[{ "property": "disposition", "operator": "eq", "value": "CONNECTED" }]
Llamadas entrantes de más de 5 minutos (CDRs)
[
{ "property": "type", "operator": "eq", "value": "I" },
{ "property": "billsec", "operator": "gt", "value": 300 }
]
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 un sentimiento negativo?"
Lista de seguimiento de llamadas perdidas
"Enumera todas las llamadas entrantes perdidas de las últimas 24 horas con el identificador del llamante, para poder priorizar las devoluciones de llamada."
Historial del cliente
"Muéstrame todas las llamadas y SMS que hemos tenido con el +44 20 7946 0000 este año y resume de qué se habló."
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 hay alguna llamada que lleve más de 20 minutos en curso?"
Eficiencia de tokens
Cada llamada que la IA analiza sin el CX Addon le exige procesar el contenido de audio y generar su propia transcripción y análisis. El CX Addon traslada por completo este trabajo a Voipstudio:
Lo que gestiona Voipstudio (coste mensual fijo, llamadas ilimitadas):
- Transcripción de audio
- Identificación de interlocutores
- Resumen de llamadas
- Clasificación de sentimiento
- Extracción de acciones recomendadas
- Puntuación CX
Lo que recibe la IA: campos de texto limpios y estructurados, listos para razonar, comparar y elaborar informes.
Esto significa que puedes pedir a la IA que analice cientos de llamadas en una sola sesión por una fracción del coste en tokens, lo que hace 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.