Resumen
Deja que tu IA trabaje con tu sistema telefónico sipgate: el historial de llamadas, mensajes de voz, SMS y faxes, usuarios, dispositivos, números de teléfono, desvíos y grupos, la agenda, llamadas en curso y el saldo. El envío de SMS y el inicio de llamadas están incluidos pero desactivados. Token de acceso personal.
Configuración guiada
Conecta sipgate a Gemini en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta sipgate con la configuración guiada y añade tu URL MCP a Gemini. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para sipgate
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → sipgate, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
sipgate + Gemini
Deja que tu IA trabaje con tu sistema telefónico sipgate: el historial de llamadas, mensajes de voz, SMS y faxes, usuarios, dispositivos, números de teléfono, desvíos y grupos, la agenda, llamadas en curso y el saldo. El envío de SMS y el inicio de llamadas están incluidos pero desactivados. Token de acceso personal.
Requisitos previos
Consulta las instrucciones completas de configuración incluidas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
SIPGATE_TOKEN_ID, SIPGATE_TOKEN
Paso 1 — Obtener credenciales
La configuración tarda unos 3 minutos.
- Inicia sesión en https://app.sipgate.com y abre https://app.sipgate.com/personal-access-token (en el menú: tu usuario, Tokens de acceso personal).
- Crea un token, dale un nombre y selecciona los ámbitos que necesitas (lista a continuación). sipgate muestra un Token ID (se parece a
token-AB12CD) y el token en sí (un código largo), el token solo una vez. - Pega el Token ID en
SIPGATE_TOKEN_IDy el token enSIPGATE_TOKEN. Se envían como credenciales HTTP Basic (Token ID como nombre de usuario, token como contraseña).
Ámbitos a seleccionar (los ámbitos de lectura son suficientes para cada herramienta que está activada, excepto notas y nuevos contactos)
- Siempre útil:
account:read,balance:read,users:read,devices:read,numbers:read,phonelines:read,phonelines:forwardings:read. - Historial:
history:read;history:writepara notas, estrellas y archivo. - Agenda:
contacts:read;contacts:writepara agregar contactos. - Otros:
voicemails:read,blacklist:read,groups:read,groups:users:read,rtcm:read(llamadas en curso),sms:read. - Solo si activas las herramientas de pago:
sessions:sms:write(enviar SMS) ysessions:calls:write(iniciar llamadas). Una llamada que necesita un ámbito que el token no tiene responde con 403.
Por dónde empezar: sipgate_get_user_info verifica el token y devuelve tu id de usuario (sub, por ejemplo, w0). sipgate_list_history es la lista de llamadas; sipgate_list_users y sipgate_list_numbers muestran cómo está configurada la cuenta.
Cuenta: sipgate_get_account, sipgate_get_balance, sipgate_list_users, sipgate_get_user, sipgate_list_devices, sipgate_get_device, sipgate_list_numbers, sipgate_list_user_numbers, sipgate_list_phonelines, sipgate_list_forwardings, sipgate_list_groups, sipgate_list_group_users, sipgate_list_blocklist.
Llamadas y mensajes: sipgate_list_history (filtrar por tipo, dirección, tiempo y número), sipgate_get_history_entry, sipgate_update_history_entry (nota, leer, marcar, archivar), sipgate_list_active_calls, sipgate_list_voicemails (las bandejas; los mensajes son entradas de historial de tipo VOICEMAIL).
Agenda: sipgate_list_contacts, sipgate_get_contact, sipgate_create_contact.
Acciones de pago, desactivadas al instalar: sipgate_send_sms (necesita el id de sipgate_list_sms_extensions) y sipgate_start_call.
Notas de campo
- Los ids son una letra y un número: usuarios
w0, teléfonos VoIPe0, dispositivos móvilesy0, dispositivos externosx0, líneas telefónicasp0, gruposg0, extensiones SMSs0, buzones de vozv0, líneas de faxf0. - Los números de teléfono están en formato internacional con
+(por ejemplo,+4915799912345). - Los tiempos en el historial son ISO 8601 en UTC. sipgate mantiene el historial solo mientras lo indique el plan (
historyLifeTimede la cuenta: ninguno, 30 días o ilimitado). - La cantidad del saldo está en diez milésimas: divide por 10000 para obtener euros o libras.
- Un token ve lo que su usuario ve. Las entradas de otros usuarios (
include_all_users) y la lista completa de usuarios necesitan un administrador. - sipgate limita a los clientes que consultan rápidamente; solicita una página filtrada del historial en lugar de leer todo de nuevo.
- No cubierto: cambiar desvíos, dispositivos o números, envío de faxes y la configuración más reciente de IA y webhook.
Paso 2 — Instalar el adaptador
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 — Agregar el conector en Gemini
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 muestraYOUR_SERVER_ID.
Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de
YOUR_MCP_API_KEY. - Guarda el archivo y reinicia
gemini. - Ejecuta
/mcpdentro de Gemini CLI (ogemini mcp listen tu terminal):anythingmcpdebería aparecer como conectado. - Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de
sipgate.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
sipgate_get_user_info | Lee a quién pertenece el token de acceso: sub (el id de usuario, por ejemplo, w0, necesario para las herramientas por usuario), dominio (sipgate.de o sipgate.co.uk)… |
sipgate_get_account | Lee la cuenta de sipgate: empresa, nombre y apellido del titular de la cuenta y correo electrónico, mainProductType (BASIC, TEAM, TRUNKING, etc.)… |
sipgate_get_balance | Lee el saldo prepago de la cuenta: cantidad y moneda. La cantidad está en diez milésimas de la unidad monetaria: 35000 significa 3.50 EUR… |
sipgate_list_users | Lista los usuarios de la cuenta: id (w0, w1, etc.), nombre, apellido, correo electrónico, admin, defaultDevice, busyOnBusy, directDialIds y… |
sipgate_get_user | Lee un usuario de la cuenta: nombre, apellido, correo electrónico, admin, defaultDevice, busyOnBusy, addressId, directDialIds y zona horaria. Ámbito… |
sipgate_list_devices | Lista los dispositivos de un usuario: id (e para un teléfono VoIP, y para una SIM móvil, x para un número externo, seguido de un número), alias, tipo… |
sipgate_get_device | Lee un dispositivo: alias, tipo, en línea, dnd y las líneas telefónicas y grupos activos a los que está conectado. Ámbito devices:read. Solo lectura |
sipgate_list_numbers | Lista los números de teléfono de la cuenta: número (formato internacional), localizado, tipo (LANDLINE, MOBILE, QUICKDIAL, INTERNATIONAL), y… |
sipgate_list_user_numbers | Lista los números de teléfono asignados a un usuario: número, localizado, tipo, endpointId y endpointAlias. Ámbito numbers:read. Solo lectura |
sipgate_list_phonelines | Lista las líneas telefónicas (conexiones) de un usuario: id (p0, p1, etc.) y alias. Una línea telefónica lleva los números, desvíos y buzones de voz… |
sipgate_list_forwardings | Lista las reglas de desvío de llamadas de una línea telefónica: destino (un número o un dispositivo), alias, tiempo de espera (segundos hasta que suene el siguiente paso) y… |
sipgate_list_history | Lista el historial de llamadas: llamadas, mensajes de voz, SMS y faxes, los más recientes primero. Cada entrada tiene id, tipo, dirección (INCOMING, OUTGOING… |
sipgate_get_history_entry | Lee una entrada del historial (una llamada, mensaje de voz, SMS o fax) por su id: tipo, dirección, estado, fuente, destino, creado, los endpoints… |
sipgate_update_history_entry | Cambia la contabilidad de una entrada del historial: escribe una nota sobre una llamada, márcala como leída, márcala o archívala. Solo los campos que pases… |
sipgate_list_contacts | Lista los contactos de la agenda: id, nombre, nombre de pila, apellido, números (número y tipo), correos electrónicos, direcciones, organización, nota… |
sipgate_get_contact | Lee un contacto de la agenda por su id: nombre, números, correos electrónicos, direcciones, organización, nota y ámbito. Ámbito contacts:read.… |
sipgate_create_contact | Agrega un contacto a la agenda, para que las llamadas desde sus números muestren el nombre. Responde con estado 201 y un cuerpo vacío. Un SHARED… |
sipgate_list_voicemails | Lista los buzones de voz de la cuenta: id (v0, etc.), alias y la línea telefónica o grupo al que pertenecen. Los mensajes grabados… |
sipgate_list_blocklist | Lista los números bloqueados para llamadas entrantes: phoneNumber y isBlock (true cuando cada número que comienza con él está bloqueado, lo que bloquea un… |
sipgate_list_groups | Lista los grupos de llamadas (grupos de búsqueda) de la cuenta: id (g0, etc.) y alias. Con user_id solo los grupos en los que está ese usuario. Un grupo suena… |
sipgate_list_group_users | Lista los miembros de un grupo de llamadas: id, nombre y apellido de cada usuario. Ámbito groups:users:read. Solo lectura |
sipgate_list_active_calls | Lista las llamadas que están conectadas en este momento: callId, los participantes con sus números de teléfono, y si la llamada está en silencio, en espera o… |
sipgate_list_sms_extensions | Lista las extensiones SMS de un usuario: id (s0, etc.), alias y callerId (el número del remitente). El id es el sms_id que sipgate_send_sms… |
sipgate_send_sms | Envía un SMS desde una extensión SMS de la cuenta. sipgate cobra cada SMS al saldo de la cuenta, por lo que la herramienta se instala desactivada… |
sipgate_start_call | Inicia una llamada telefónica (clic para llamar): sipgate primero llama al dispositivo del que llama y, una vez que se responde, marca al destinatario. Una llamada real es… |
Ejemplos de mensajes
- "¿Qué llamadas hemos perdido hoy y de qué números?"
- "Muestra los nuevos mensajes de voz de esta semana con el llamante y la hora."
- "¿Quién está en qué número de teléfono y dónde están configurados los desvíos?"
- "¿Cuál es el saldo actual de nuestra cuenta sipgate?"
- "Agrega una nota a la llamada de ayer desde +4930123456: devolvió la llamada, oferta enviada."
Preguntas frecuentes
¿De dónde proviene el token? En la aplicación web de sipgate abre Tokens de acceso personal, crea un token, dale un nombre y selecciona los ámbitos que necesitas. sipgate muestra un Token ID (que comienza con token-) y el token en sí, el token solo una vez. Un token ve lo que su usuario ve; las entradas de otros usuarios y la lista completa de usuarios necesitan un administrador.
¿Qué cubre? Una cuenta de sipgate (equipo, trunking o básica, en Alemania o el Reino Unido): cuenta y saldo, usuarios, dispositivos, números de teléfono, líneas telefónicas y desvíos, el historial de llamadas, mensajes de voz, SMS y faxes con notas, estrellas y archivo, la agenda, grupos de llamadas, llamadas en curso y la lista de bloqueos. Cambiar desvíos, dispositivos o números y enviar faxes no están cubiertos.
¿Qué herramientas se instalan desactivadas? sipgate_send_sms y sipgate_start_call, porque ambas cuestan dinero. También necesitan los ámbitos sessions:sms:write y sessions:calls:write. Actívalas en la página del conector solo si la IA debe usarlas.
¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.
Próximos pasos
¿Te ha sido útil esta guía?