Cómo conectar Ringostat a Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Ringostat.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

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

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

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