Resumen
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.
Configuración guiada
Conecta Telnyx a Microsoft Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Telnyx con la configuración guiada y añade tu URL MCP a Microsoft Copilot. 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 Telnyx
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.
💡 ¿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 + Microsoft Copilot
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
- Inicia sesión en el Mission Control Portal en
https://portal.telnyx.com. - Abre Account settings → Keys & Credentials → API Keys y haz clic en Create API Key. La clave empieza por
KEYy Telnyx solo la muestra una vez. - Pégala en
TELNYX_API_KEYtal como la muestra Telnyx, sin la palabra Bearer, e instala el conector. La clave solo se envía a api.telnyx.com. - 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 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 muestraYOUR_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.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - 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.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
Telnyx. - 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
| Tool | What it does |
|---|---|
telnyx_get_balance | Read the account balance: balance, pending, credit_limit, available_credit and currency |
telnyx_list_phone_numbers | List the phone numbers the account owns, newest first: id, phone_number (E.164), status, phone_number_type, country, the voice connection… |
telnyx_get_phone_number | Read one owned phone number by its id (from telnyx_list_phone_numbers): status, type, country, voice connection, messaging profile… |
telnyx_search_available_numbers | Search phone numbers that can be bought, by country, area, digits, type and features |
telnyx_order_phone_numbers | Buy phone numbers found with telnyx_search_available_numbers |
telnyx_get_number_order | Read a number order by its id: status (pending, success, failure), the numbers with their own status and whether the regulatory… |
telnyx_send_message | Send an SMS or MMS from a Telnyx number |
telnyx_get_message | Read one message by its id: direction, from, to with per-recipient delivery status (queued, sending, sent, delivered, sending_failed… |
telnyx_list_messaging_profiles | List the messaging profiles: id, name, enabled, webhook_url, whitelisted_destinations (countries the profile may send to), daily spend… |
telnyx_list_call_control_applications | List the Call Control applications (voice connections): id, application_name, active, webhook_event_url and outbound settings.… |
telnyx_dial_call | Place an outbound phone call through a Call Control application |
telnyx_get_call_status | Read the status of a call by its call_control_id: is_alive (false once it ended), call_duration in seconds, start_time and end_time |
telnyx_speak_text | Speak text to the other party on an answered call |
telnyx_hangup_call | Hang up a call that is still in progress |
telnyx_search_detail_records | Search detail records (CDRs and MDRs): one record per message, call leg, verification, recording and so on, with direction, numbers… |
telnyx_get_usage_report_options | List the products of the usage report and, for each, the dimensions and metrics telnyx_get_usage_report accepts (for example product… |
telnyx_get_usage_report | Get aggregated usage and cost for one product over at most 31 days, broken out by dimensions (e.g. date, direction, country) with metrics… |
telnyx_list_recordings | List call recordings, newest first: id, from, to, duration_millis, channels, status, start and end time and download_urls (mp3 and wav… |
telnyx_get_recording | Read one call recording by its id with fresh download_urls (mp3, wav), duration, channels and the call it belongs to |
telnyx_lookup_number | Look up a phone number: country, national format, E.164 form, and with type carrier the carrier name, line type (mobile, landline, voip)… |
telnyx_list_verify_profiles | List the Verify profiles: id, name, language and the settings per channel (sms, call, whatsapp, flashcall) such as code length and… |
telnyx_send_verification | Send a one-time code to a phone number by SMS, voice call or WhatsApp through a Verify profile |
telnyx_check_verification_code | Check the code a person entered against the latest verification sent to that number |
telnyx_get_verification | Read a verification by its id: phone_number, channel type, status (pending, accepted, invalid, expired, error) and when it was created |
telnyx_list_ai_assistants | List the account's Telnyx AI assistants (voice and chat agents): id, name, description, model, greeting, enabled features and creation date |
telnyx_get_ai_assistant | Read one AI assistant by its id: name, model, instructions (system prompt), greeting, tools, voice and transcription settings, telephony… |
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
¿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
¿Te ha sido útil esta guía?