Cómo conectar Telnyx a Gemini vía MCP

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

Telnyx + Gemini

Deja que tu IA trabaje con Telnyx: consulta saldo y consumo, lista y busca números de teléfono, envía SMS y MMS, haz llamadas que leen un mensaje, revisa grabaciones de llamadas y registros detallados, consulta números, envía y comprueba códigos de un solo uso con Verify y revisa tus asistentes de IA.

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:

TELNYX_API_KEY

Paso 1 — Obtener credenciales

1. Inicia sesión en el Mission Control Portal en https://portal.telnyx.com.
2. Abre Account settings → Keys & Credentials → API Keys y haz clic en Create API Key. La clave empieza por KEY y Telnyx solo la muestra una vez.
3. Pégala en TELNYX_API_KEY tal como la muestra Telnyx, sin la palabra Bearer, e instala el conector. La clave solo se envía a api.telnyx.com.
4. Comprueba la configuración con telnyx_get_balance: es gratis y muestra tu saldo, el límite de crédito y la moneda.

Quién ve qué: la clave actúa para toda la cuenta de Telnyx, saldo incluido. Comparte el servidor MCP solo con personas que puedan gastar dinero en ella.

Cuesta dinero y llega a personas reales, así que la IA pregunta antes: Telnyx cobra telnyx_send_message (SMS y MMS), telnyx_dial_call (por minuto), telnyx_speak_text (texto a voz) y telnyx_send_verification (por verificación). Antes de cada una, la IA te muestra el destinatario, el remitente y el contenido y espera tu sí. telnyx_lookup_number se cobra por consulta, así que la IA te avisa antes de consultar muchos números. Enviar, llamar y comprar requieren una cuenta con saldo.

Desactivada al instalar: telnyx_order_phone_numbers, que compra números con un precio inicial y una cuota mensual por número. Un administrador la activa de forma deliberada; después la IA muestra cada número con sus costes y solo compra cuando lo confirmas. Buscar números con telnyx_search_available_numbers es gratis.

SMS: un número solo envía SMS si está asignado a un messaging profile (telnyx_list_messaging_profiles muestra los perfiles y los países a los que cada uno puede enviar). Un mensaje nuevo empieza como queued; más tarde telnyx_get_message muestra el estado de entrega por destinatario. Con enlaces a archivos multimedia el mensaje se convierte en MMS (EE. UU. y Canadá).

Las llamadas necesitan una Call Control application: crea una en el Mission Control Portal y asígnale el número desde el que llamas. telnyx_list_call_control_applications da el connection_id que necesita telnyx_dial_call. La IA marca, comprueba con telnyx_get_call_status hasta que contestan, lee tu mensaje con telnyx_speak_text y cuelga con telnyx_hangup_call. Un límite de tiempo en la llamada pone tope al coste. Los eventos de la llamada van a la URL de webhook de la application, que este conector no recibe. Grabaciones: telnyx_list_recordings y telnyx_get_recording (los enlaces de descarga caducan a los pocos minutos).

Verify: crea una vez un Verify profile en el portal, en Verify; telnyx_list_verify_profiles lo lista. telnyx_send_verification envía un código por SMS, llamada de voz o WhatsApp, y telnyx_check_verification_code comprueba lo que escribió la persona.

Consumo y costes: telnyx_search_detail_records lista mensajes y llamadas sueltos con su coste; telnyx_get_usage_report_options y telnyx_get_usage_report dan los totales por producto de hasta 31 días. Los asistentes de IA son de solo lectura: telnyx_list_ai_assistants y telnyx_get_ai_assistant.

Números: siempre en E.164, es decir, +, el prefijo del país y el número sin espacios (+34612345678).

Errores comunes: 401 (10009): la clave es incorrecta, se borró o se pegó con un prefijo; crea una nueva en el portal. 403: la cuenta aún no puede usar esta función (por ejemplo, enviar a un país o comprar números antes de verificar la cuenta), o a la clave le falta el permiso. 404 (10005): ese recurso no existe en esta cuenta. 422: un parámetro no es válido, por ejemplo el remitente no tiene messaging profile, la llamada aún no se ha contestado o un número no está en E.164. 429: demasiadas peticiones; espera y vuelve a intentarlo.

El conector no cubre la portabilidad de números, la configuración y liberación de números, SIP trunking, TeXML, conferencias, fax, plantillas de WhatsApp, el registro 10DLC de marcas y campañas, la creación o modificación de asistentes de IA ni los webhooks.

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 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 muestra YOUR_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" }
    }
  }
}

1. 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.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Telnyx.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuál es nuestro saldo en Telnyx y cuánto hemos gastado en mensajes este mes, por país?"
• "Envía un SMS desde nuestro número de Madrid al +34612345678 diciendo que el pedido está listo para recoger. Muéstrame antes remitente, destinatario y texto."
• "Llama al +34612345678 desde nuestra línea de soporte, di que el técnico llega a las 15:00 y cuelga. Que la llamada no pase de un minuto."
• "Busca tres números móviles en España que puedan enviar SMS y muéstrame el coste inicial y mensual de cada uno."
• "¿Qué mensajes de ayer no se entregaron? Revisa los registros detallados y muéstrame el estado y el coste."

FAQ

¿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.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT