Saltar al contenido principal

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​

información

URL del servidor MCP

https://mcp.voipstudio.com/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:

  1. 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.
  2. 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.
  3. 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:

  1. 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.
  2. Introduce un nombre, por ejemplo Voipstudio, y la URL del servidor MCP indicada arriba.
  3. 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 en https://mcp.voipstudio.com/.well-known/oauth-authorization-server y https://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 initialize y tools/list funcionan 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 AddonCon CX Addon
TranscripciónLa IA debe descargar el audio y transcribir/traducir✓ Incluida, con identificación de interlocutores
ResumenLa IA debe generarlo✓ Incluido
SentimientoLa IA debe inferirlo✓ Incluido
Acciones recomendadasLa IA debe extraerlas✓ Incluidas
Puntuación CXNo disponible✓ De 1 a 10 en cada llamada
Tokens aprox./llamada10.000–15.000300–500
Modelo de costesGasto variable en IASuscripción mensual fija

Campos habilitados por el CX Addon​

CampoTipoDescripción
transcriptstringTranscripción completa palabra por palabra
transcript_speakersobjectSegmentos de transcripción con identificación de interlocutores
summarystringResumen conciso del resultado de la llamada
sentimentstringSentimiento del cliente: positive, neutral, negative
cx_scorenumber (1–10)Puntuación de experiencia del cliente
metadata.timelinearrayMomentos 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ámetroTipoPredeterminadoDescripción
filtersarray—Objetos de filtro; consulta Filtrado, ordenación y paginación más abajo
sortobject—{ "by": "<field>", "dir": "ASC" } o "DESC"
limitnumber10Registros por página (1–1000)
pagenumber1Número de página

Campos de respuesta

CampoTipoDescripción
idnumberIdentificador único de la grabación
call_idnumberVinculado al call_id del CDR
timestampstringInicio de la grabación (UTC, YYYY-MM-DD HH:mm:ss)
callerstringNúmero del llamante
calledstringNúmero llamado
src_namestringNombre del agente (origen)
dst_namestringNombre del destino
durationnumberDuración en segundos
typestringI = entrante, O = saliente
contextstringContexto de la llamada (ej. LOCAL_USER, QUEUE)
transcriptstring | nullTranscripción completa (CX Addon)
transcript_speakersobject | nullTranscripción por interlocutores (CX Addon)
summarystring | nullResumen de la llamada (CX Addon)
sentimentstring | nullSentimiento del cliente (CX Addon)
cx_scorenumber | nullPuntuación CX de 1 a 10 (CX Addon)
metadata.timelinearray | nullEventos 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

CampoTipoDescripción
call_idnumberIdentificador único de llamada
calldatestringFecha y hora de inicio de la llamada (UTC)
src_namestringNombre del agente o llamante
dst_namestringNombre del destino
billsecnumberSegundos facturables
durationnumberSegundos totales, incluido el timbrado
dispositionstringCONNECTED, NO ANSWER, BUSY, FAILED
chargenumberCoste de la llamada
typestringI = entrante, O = saliente
src_uastringDispositivo de origen / User-Agent del softphone
labelsarrayEtiquetas 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.

información

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ámetroTipoPredeterminadoDescripción
numberstring—El número de teléfono (obligatorio)
fromDateTimestring—Inicio opcional, YYYY-MM-DD HH:mm:ss
toDateTimestring—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:

PropiedadDescripción
propertyCualquier campo de la respuesta de la herramienta (ej. calldate, cx_score, src_name)
operatoreq, ne, lt, lte, gt, gte, in, like, notlike (también funcionan los símbolos =, !=, <, <=, >, >=)
valueCadena, 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.