Cómo conectar Telegram Bot a Microsoft Copilot vía MCP

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

Telegram Bot + Microsoft Copilot

Envía mensajes, fotos, álbumes, documentos, audio, vídeo, animaciones, stickers, contactos, lugares, ubicaciones y encuestas de Telegram desde cualquier agente IA mediante la Telegram Bot API. 21 herramientas, autenticación con el token del bot. Envío saliente más una lectura ligera de las actualizaciones recientes (sin long polling).

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:

TELEGRAM_BOT_TOKEN

Paso 1 — Obtener credenciales

1. En Telegram, abre un chat con @BotFather, envía /newbot y elige un nombre visible y un nombre de usuario que termine en bot.
2. BotFather responde con un token como 123456789:ABCdef.... Trátalo como un secreto: quien lo tenga puede enviar mensajes como tu bot.
3. Pega el token completo en TELEGRAM_BOT_TOKEN e instala el conector. Telegram espera el token en la dirección de la petición, y el conector lo coloca ahí por ti.
4. Empieza con telegram_bot_get_me para comprobar que el token funciona.

A quién puede llegar el bot: cada chat tiene un chat_id numérico. Un usuario debe haber enviado /start a tu bot al menos una vez, y en grupos y canales primero hay que añadir el bot. Los canales públicos también aceptan @channelusername; los privados necesitan el id numérico, que empieza por -100. telegram_bot_get_updates muestra los mensajes entrantes recientes con sus chat ids.

Qué envía: mensajes de texto (el formato HTML es la opción más segura), fotos, álbumes, documentos, archivos de audio, notas de voz, vídeos, animaciones GIF, stickers, tarjetas de contacto, lugares, ubicaciones (también en tiempo real) y encuestas o cuestionarios. También puede editar y borrar sus propios mensajes y leer los detalles de un chat.

Álbumes: telegram_bot_send_album envía de 2 a 10 fotos y vídeos como un único mensaje agrupado, o de 2 a 10 documentos, o de 2 a 10 archivos de audio; los documentos y el audio no se pueden mezclar con otros tipos. El pie de foto va en el primer elemento. Si Telegram devuelve WEBPAGE_CURL_FAILED para un elemento, no pudo descargar ese archivo: el enlace debe ser público y apuntar directamente al archivo, no a una página web.

Archivos: los medios se envían por enlace HTTPS (hasta 5 MB para fotos y 20 MB para otros archivos) o por el file_id de algo enviado antes. No se puede subir un archivo desde tu ordenador en la misma llamada.

¿Ya lo tienes instalado? Las herramientas de álbumes, animaciones, stickers, contactos y lugares llegan a un conector instalado antes mediante su actualización de catálogo: abre el conector en AnythingMCP y, en Catalog update available, revisa la lista de herramientas nuevas y haz clic en Apply update. Tu token del bot y las herramientas que añadiste tú se quedan como están.

Límites de envío: unos 30 mensajes por segundo entre chats distintos, 1 por segundo al mismo chat y 20 por minuto al mismo grupo. Ante un 429, Telegram indica cuánto esperar.

El conector lee las actualizaciones recientes cuando se lo pides y no ejecuta un chatbot que responda por su cuenta, algo que necesita un webhook alojado por ti. Los pagos, el modo inline, los juegos y la gestión de packs de stickers no están cubiertos.

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 Telegram Bot.
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

• "Envía las fotos de estos cuatro enlaces como un solo álbum al canal del equipo, con el pie 'Nueva colección, disponible desde hoy'."
• "Publica una encuesta en el grupo de ventas: ¿qué día va mejor para la revisión trimestral, martes o jueves?"
• "Envía la dirección de nuestra tienda como lugar al chat del cliente para que pueda abrirla en su app de mapas."
• "Muéstrame los mensajes que recibió el bot en la última hora y quién los envió."

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