Cómo conectar Ringostat a Claude vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Ringostat, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Ringostat + Claude

Seguimiento de llamadas y centralita virtual Ringostat: registro de llamadas con fuentes de tráfico, duración, estado, empleados y enlaces a grabaciones, quién está conectado o en llamada, empleados con departamentos, informe SIP diario y estados de Smart Phone. La devolución de llamada viene desactivada.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

RINGOSTAT_AUTH_KEY, RINGOSTAT_PROJECT_ID

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos y requiere un administrador del proyecto en Ringostat.

1. En Ringostat abre Settings, Integrations, Ringostat API y copia la Auth-key en RINGOSTAT_AUTH_KEY. Pertenece a un proyecto y se envía en la cabecera Auth-key.
2. Define RINGOSTAT_PROJECT_ID con el número de ese proyecto: el valor tras project_id= o projectId= en la barra de direcciones de la aplicación web de Ringostat, por ejemplo 39071. Solo lo usan las herramientas de empleados, informe SIP y estados personalizados.
3. Instala el conector; la comprobación ejecuta ringostat_list_online_sip.

Qué lee: el registro de llamadas de un periodo, una fila por llamada con las columnas que pidas: fecha, número que llama y número llamado, tipo de llamada, estado (disposition), tiempo de conversación, duración total y tiempo de espera, nombre y departamento del empleado, pool de números y esquema de desvío, marcas de llamada objetivo y repetida, UTM source, medium, campaign, content y term, landing page y referrer, el motivo de una llamada perdida, valoración CSAT, id de la llamada y enlace a la grabación; las cuentas SIP conectadas ahora mismo y las que están en llamada ahora mismo; los empleados con estado SIP, nombre completo, e-mail, extensión, staffId, departamentos y destinos (cuentas SIP o números principales y de reserva); el tiempo conectado y desconectado por empleado y día; y los estados personalizados de Smart Phone como Comida o Reunión.

Registro de llamadas: ringostat_list_calls acepta from y to como YYYY-MM-DD HH:MM:SS; sin ellos devuelve las últimas 24 horas. La respuesta es un único array con todas las llamadas del periodo, sin paginación, así que en proyectos con mucho tráfico la IA mantiene los periodos cortos (un día o una semana) y pide solo los fields que necesita. El tiempo de conversación es billsec en segundos; call_type es in, out, callback, transitin o transitout; proper_flag y repeated_flag marcan las llamadas objetivo y repetidas. Para estadísticas por empleado, la IA agrupa las filas por employee_fio y suma billsec.

Filtros y orden: los filtros son expresiones de Ringostat separadas por comas, por ejemplo call_type=in,billsec>=30, con =, <>, >, <, >=, <= o ~ (una expresión regular, codificada en base64). order ordena, por ejemplo calldate desc; merge agrupa las llamadas por número que llama por día (1) o en todo el periodo (2).

Datos personales: los números de teléfono y los enlaces a grabaciones son datos personales. Los enlaces en recording y recording_wav siguen disponibles durante un año.

Desactivada al instalar: ringostat_start_callback inicia una llamada real que conecta un número del proyecto con un número de teléfono o el login SIP de un empleado. Marca al instante y consume minutos, así que un administrador la activa deliberadamente. Incluso entonces la IA te muestra los dos números y espera tu sí. Los números van en formato internacional sin +.

Llamadas POST de solo lectura: la lista de empleados, el informe SIP y los estados personalizados son solicitudes POST en la API de Ringostat, pero solo leen.

Errores comunes: 401 o 403 indican una Auth-key ausente o incorrecta, o una clave y un id de proyecto de proyectos distintos. Un error JSON-RPC de las herramientas de empleados, informe o estados suele indicar un RINGOSTAT_PROJECT_ID incorrecto; "User does not exist" significa que el filtro de empleados no encontró a nadie.

El conector no cambia la configuración de la centralita, empleados, pools de números ni esquemas de desvío, y devuelve enlaces a las grabaciones, no el audio.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Claude

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.

1. En Claude, abre Customize → Connectors.
2. Pulsa + y después Add custom connector.
3. Escribe un nombre, por ejemplo Ringostat, y la URL del servidor MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add.
4. Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.

Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuántas llamadas entrantes recibimos ayer, cuántas se perdieron y cuál fue el tiempo medio de conversación?"
• "Agrupa las llamadas de la semana pasada por empleado con el número de llamadas y el tiempo total de conversación."
• "¿Qué fuentes y campañas UTM trajeron llamadas objetivo este mes?"
• "¿Quién está conectado ahora mismo y quién de ellos está en una llamada?"
• "¿Cuánto tiempo estuvo conectado cada empleado por día la semana pasada?"

FAQ

¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Siguientes pasos

• Página del conector
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot