Guía de conector9 minutos de lectura33 herramientas MCP7 idiomas

Conectar Telegram MCP con Claude

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. 33 herramientas, autenticación con el token del bot. Envío saliente más una lectura ligera de las actualizaciones recientes (sin long polling).

HCPor el equipo de HelpCodeActualizado 9 min de lectura Código abierto en GitHub

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

Telegram Bot

Telegram Bot

Send Telegram messages, photos, albums, documents, audio, video, animations, stickers, contacts, venues, locations and polls from any AI agent via the Telegram Bot API, react to and pin messages, and manage group titles, invite links and forum topics. Bot-token auth. Outbound plus a lightweight read of recent updates (no long-polling).

herramientas

33

Región

INTL

Categoría

Mensajería

Autenticación

API credentials

Env vars requeridas

TELEGRAM_BOT_TOKEN
Instalar con un clic en Cloud

7 días de prueba gratis · Sin tarjeta de crédito

  • Prueba gratis de 7 días
    Sin tarjeta de crédito
  • RGPD y SOC 2 ready
    Datos en la UE, registros de auditoría
  • Código abierto en GitHub
    Open source · AGPL-3.0
  • Funciona con ChatGPT, Claude, Gemini
    Cualquier cliente compatible con MCP

Resumen

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. 33 herramientas, autenticación con el token del bot. Envío saliente más una lectura ligera de las actualizaciones recientes (sin long polling).

Configuración guiada

Conecta Telegram Bot a Claude en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta Telegram Bot con la configuración guiada y añade tu URL MCP a Claude. Sin código y sin servidores que mantener.

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

AnythingMCP está en el directorio de conectores de Claude: añádelo a Claude con un clic (se abre en una pestaña nueva), inicia sesión y elige qué servidores MCP puede usar Claude.

Prueba a pedir

Prompts de ejemplo para Telegram Bot

Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.

Telegram Bot · live vía MCP
Compartir
Opus 4.7

Claude es IA y puede equivocarse. Verifica siempre las respuestas.

💡 ¿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 + Claude

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

Reacciones, mensajes fijados y gestión de chats: el bot puede reaccionar a un mensaje con un emoji y cambiar el pie de una foto, un vídeo o un documento que envió. En los grupos y canales donde es administrador con el permiso correspondiente (fijar mensajes, cambiar la info del chat, invitar usuarios, gestionar temas), fija y desfija mensajes, cambia el nombre y la descripción del chat, crea enlaces de invitación adicionales (con nombre, con caducidad o limitados a un número de entradas) y abre temas en grupos con foro. También puede reunir imágenes existentes en un nuevo pack de stickers de un usuario y añadirle más stickers. telegram_bot_get_webhook_info muestra si el bot tiene un webhook; mientras haya uno, telegram_bot_get_updates responde 409 Conflict. telegram_bot_remove_webhook borra el webhook y está desactivada al instalar, porque el servicio que lo recibe (un chatbot, una automatización) deja de recibir mensajes: actívala a propósito en la página del conector; la IA pregunta antes de cada cambio.

¿Ya lo tienes instalado? Las nuevas herramientas 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, y telegram_bot_remove_webhook llega desactivada, igual que en una instalación nueva.

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 y los juegos 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 Claude

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.

Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.

  1. En Claude, abre Plugins (en algunos planes aún Customize) → Connectors.
  2. Pulsa + Add y después Add custom connector.
  3. Escribe un nombre, por ejemplo Telegram Bot, y la URL del servidor MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Continue, deja los ajustes detectados y vuelve a pulsar Continue.
  4. Elige Sign in now, pulsa Add e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.

Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.

Herramientas disponibles

ToolWhat it does
telegram_bot_get_meReturn the bot's own user info: id, username, first_name, can_join_groups, can_read_all_group_messages, supports_inline_queries
telegram_bot_send_messageSend a text message to a chat
telegram_bot_send_photoSend a photo (JPG/PNG, ≤5MB via URL) by HTTPS URL or by reusable file_id
telegram_bot_send_documentSend a document (any type, ≤20MB via URL) by HTTPS URL or file_id
telegram_bot_send_audioSend an audio file (MP3, M4A, ≤20MB via URL)
telegram_bot_send_voiceSend a voice note (OGG-Opus encoded)
telegram_bot_send_videoSend a video (MP4, H.264, AAC, ≤20MB via URL)
telegram_bot_send_locationSend a location point
telegram_bot_send_pollSend a poll (regular or quiz)
telegram_bot_edit_message_textEdit the text of a previously-sent message (your bot's own messages only)
telegram_bot_delete_messageDelete a message the bot sent (within ~48 hours for groups, anytime for own DMs)
telegram_bot_get_chatFetch chat info: title, type (private/group/supergroup/channel), photo, description, invite_link, member_count, permissions
telegram_bot_get_updatesLong-poll recent inbound messages (one-shot: pulls all updates since the last offset+1)
telegram_bot_send_albumSend 2 to 10 photos or videos as one album (sendMediaGroup), or 2 to 10 documents, or 2 to 10 audio files; documents and audio cannot be…
telegram_bot_send_animationSend a GIF or a silent MP4 animation by HTTPS URL or file_id; Telegram plays it on a loop
telegram_bot_send_stickerSend a sticker by file_id (any sticker the bot has seen, e.g. from telegram_bot_get_updates) or by HTTPS URL of a .WEBP image
telegram_bot_send_contactSend a phone contact card that the recipient can save or call
telegram_bot_send_venueSend a venue: a map pin with a name and address, e.g. a shop or meeting point
telegram_bot_get_fileLook up a file the bot received (photo, document, voice note, video) by its file_id, from a message in telegram_bot_get_updates
telegram_bot_download_fileDownload a file by the file_path telegram_bot_get_file returned
telegram_bot_fetch_sticker_setRead a sticker set (or custom emoji set) by its name: title, sticker_type (regular, mask, custom_emoji) and every sticker with its emoji…
telegram_bot_react_to_messageSet the bot's reaction on a message (the emoji under a message), or remove it with an empty list
telegram_bot_pin_messagePin a message in a chat, so it shows at the top
telegram_bot_unpin_chat_messageUnpin a pinned message in a chat; without message_id the most recently pinned message is unpinned
telegram_bot_rename_chatChange the title of a group, supergroup or channel (1 to 128 characters); not possible for private chats
telegram_bot_update_chat_descriptionChange the description of a group, supergroup or channel (0 to 255 characters; empty removes it)
telegram_bot_add_forum_topicCreate a topic in a forum supergroup (a group with topics enabled)
telegram_bot_edit_message_captionEdit the caption of a photo, video, document, audio or animation message the bot sent (an empty caption removes it)
telegram_bot_create_chat_invite_linkCreate an additional invite link for a group, supergroup or channel, optionally named, expiring, limited to a number of joins, or requiring…
telegram_bot_create_sticker_setCreate a new sticker set owned by a user, with 1 to 50 first stickers from existing image files
telegram_bot_extend_sticker_setAdd one sticker to a sticker set the bot created (telegram_bot_create_sticker_set)
telegram_bot_get_webhook_infoShow whether the bot has a webhook: its url (empty when none), pending_update_count, the last error date and message, and allowed_updates
telegram_bot_remove_webhookRemove the bot's webhook so updates can be read with telegram_bot_get_updates again

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ó."
  • "Fija en el grupo de clientes el mensaje con el horario de los festivos y reacciona con un pulgar arriba."
  • "Crea un enlace de invitación para el grupo beta que caduque el viernes y admita como máximo 50 entradas."

FAQ

¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Siguientes pasos

¿Te ha sido útil esta guía?

Conecta Telegram Bot a Claude en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta Telegram Bot con la configuración guiada y añade tu URL MCP a Claude. Sin código y sin servidores que mantener.

Guías relacionadas

Conectores

Conectar Telegram MCP con 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. 33 herramientas, autenticación con el token del bot. Envío saliente más una lectura ligera de las actualizaciones recientes (sin long polling).

Conectores

Conectar Telegram MCP con Meta Muse

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. 33 herramientas, autenticación con el token del bot. Envío saliente más una lectura ligera de las actualizaciones recientes (sin long polling).

Conectores

Conectar Telegram MCP con ChatGPT

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. 33 herramientas, autenticación con el token del bot. Envío saliente más una lectura ligera de las actualizaciones recientes (sin long polling).

Conectores

Conectar Telegram MCP con Cursor

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. 33 herramientas, autenticación con el token del bot. Envío saliente más una lectura ligera de las actualizaciones recientes (sin long polling).

Conectores

Conectar Telegram MCP con Gemini CLI

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. 33 herramientas, autenticación con el token del bot. Envío saliente más una lectura ligera de las actualizaciones recientes (sin long polling).

Conectores

Telegram MCP Server: mensajes, archivos y encuestas

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. 33 herramientas, autenticación con el token del bot. Envío saliente más una lectura ligera de las actualizaciones recientes (sin long polling).