Servidores MCP de Telegram: userbot o bot (2026)

En resumen. “Telegram MCP” devuelve dos categorías que no comparten más que el nombre. Los servidores userbot — mcp-telegram/mcp-telegram con 181 herramientas, chaindead/telegram-mcp con cinco — inician sesión en tu cuenta personal de Telegram por MTProto y le dan al agente el mismo alcance que tiene la app de tu móvil: chats privados, cualquier grupo, todo el historial. Los instalas tú, la licencia es MIT, no cuestan nada, y uno de los dos avisa en su propio README de que usar mal la API puede costarte la cuenta. Los servidores de bot cubren mucho menos, a propósito: las catorce herramientas de AdminHub leen un workspace, canales y suscriptores y escriben publicaciones, publicadas por el bot que el dueño del canal creó él mismo — nunca un bot compartido de AdminHub y nunca tu cuenta personal. Si lo que quieres es un agente leyendo tus DMs de Telegram, para aquí: eso es trabajo de userbot, y cada sección de abajo lo dice. Proyectos comprobados el 7 de septiembre de 2026.

Busca “telegram mcp” y te sale una página de repositorios que se describen todos igual: conecta tu agente de IA a Telegram. Instala uno al azar y descubres, más o menos por el paso del login, que “conectar a Telegram” significaba “inicia sesión en tu cuenta personal y déjasela al agente”. Es un diseño legítimo, y para toda una clase de tareas es el único que funciona. También es una decisión, y la mayoría de los READMEs la presentan como una instrucción de instalación. Este texto separa primero las dos categorías y nombra los proyectos después, con todo leído en los repositorios de los propios proyectos el 7 de septiembre de 2026.

El protocolo es toda la diferencia

Telegram tiene dos puertas, y cada servidor MCP elige una antes de elegir cualquier otra cosa.

La Bot API es una envoltura HTTP alrededor de una identidad de bot. Coges un token de BotFather, y el software que sostiene ese token actúa como ese bot — pero solo dentro de los chats y canales a los que se ha añadido el bot. No ve tus mensajes privados, no puede meterse solo en un grupo, no puede leer un canal del que no forma parte. El techo es bajo por construcción; el suelo es que nada que no hayas conectado adrede queda expuesto.

MTProto es el protocolo cliente de Telegram, el mismo que habla la app de tu móvil. Un programa que inicia sesión por MTProto con tus credenciales es tu cuenta, con el acceso que tienes tú: cada conversación privada, cada grupo, todo el historial con su búsqueda, los mensajes guardados, todo. No hay ámbito que estrechar, porque una cuenta no es un ámbito. Al software que hace esto se le llama, por convención, userbot.

Esa única elección determina todo lo que viene después: cuántas herramientas puede ofrecer un servidor, qué puede leer, qué te pide al configurarlo y qué está en juego cuando algo sale mal. Lee la línea del protocolo en un README antes de leer el número de herramientas.

Y no hay, conviene señalarlo, opción oficial con la que comparar. Telegram no publica servidor MCP propio, así que el campo es enteramente de terceros, y la inmensa mayoría son userbots que instalas tú.

Los servidores userbot

mcp-telegram/mcp-telegram

El mayor con diferencia. Su documentación cuenta 181 herramientas — mensajes, medios, reacciones, encuestas, historias y más —, construidas sobre MTProto a través de GramJS, y deja clara la postura: funciona como tu cuenta personal, no como un bot. Configurarlo significa iniciar sesión en una cuenta personal de Telegram, con login por código QR admitido, así que un número de teléfono no es estrictamente necesario. Puedes ejecutarlo tú mismo vía npx, npm, binarios precompilados, Docker o desde el código, o usar la versión alojada en mcp-telegram.com. La licencia es MIT.

La documentación llama a la cosa por su nombre — userbot (personal account), not a bot — respect the Telegram Terms of Service, es decir, “userbot (cuenta personal), no un bot — respeta los Términos de Servicio de Telegram” — pero se queda corta de cualquier aviso sobre consecuencias. Un detalle operativo que conviene saber antes de enchufarlo a dos clientes a la vez: una sesión pertenece a un solo proceso, y ejecutar la misma sesión en dos devuelve AUTH_KEY_DUPLICATED.

181 herramientas no es relleno. Reacciones, encuestas, historias y búsqueda en tu propio historial son superficies reales, y ningún servidor de Bot API llega a ellas en chats arbitrarios — ni este año, ni con otro proveedor. Si el trabajo es ese, la categoría es esta, y nada de lo que viene después en este artículo compite con ella.

chaindead/telegram-mcp

Mismo protocolo, superficie mucho más pequeña: cinco herramientas — tg_me, tg_dialogs, tg_read, tg_dialog y tg_send. Listar tus diálogos, leer una conversación, marcarla como leída, enviar un mensaje, comprobar quién eres. También MIT, también cuenta personal. La configuración pide más que escanear un QR: un API ID y un hash creados en my.telegram.org, tu número de teléfono y tu contraseña cuando la verificación en dos pasos está activada.

Es además el proyecto que pone el compromiso por escrito: Ensure that you have read and understood the Telegram API Terms of Service before using this server. Any misuse of the Telegram API may result in the suspension of your account — “Asegúrate de haber leído y entendido los Términos de Servicio de la API de Telegram antes de usar este servidor. Cualquier uso indebido de la API de Telegram puede acabar en la suspensión de tu cuenta”. El mismo protocolo que el servidor de 181 herramientas, la misma exposición — dicha donde puedes verla antes de teclear tu número.

Lo que cuesta la vía de la cuenta personal

No es “te van a banear”. Nadie honesto puede decírtelo, y este artículo no lo hará. Lo que está documentado es más estrecho, y aun así merece sopesarse.

• Tu cuenta es la credencial. No hay permiso por chat que conceder ni modo de solo lectura. Un archivo de sesión que llega a un agente alcanza todo lo que alcanza la cuenta, incluidos chats que habías olvidado que estaban en ella.
• La automatización corre bajo los términos de API de Telegram. Uno de los dos proyectos dice sin rodeos que el uso indebido puede acabar en suspensión. Los dos te piden aceptar los mismos términos; solo uno los menciona.
• El operador eres tú. Autoalojado quiere decir que el proceso, el archivo de sesión, las actualizaciones y los modos de fallo son tuyos — incluido AUTH_KEY_DUPLICATED cuando dos clientes comparten una sesión. La variante en la nube de mcp-telegram te quita la faena de alojar, no la cuestión de la cuenta.
• El radio de impacto es la cuenta. La inyección de prompts es una preocupación viva para cualquier agente que lee texto no confiable, y una bandeja de entrada de Telegram es texto no confiable por definición. En la vía del userbot, las herramientas que podrían actuar ante una instrucción hostil incluyen las que leen todas las conversaciones que tienes.

Nada de eso hace que la categoría esté mal. La convierte en un intercambio deliberado: una capacidad enorme a cambio de poner tu propia cuenta detrás del agente. Hay gente que hace ese intercambio a diario con los ojos abiertos, y es la decisión correcta siempre que el trabajo requiera de verdad alcance personal.

La vía del bot: qué hace el servidor MCP de AdminHub

El otro lado de la bifurcación renuncia al alcance y deja la cuenta fuera. AdminHub tiene un servidor MCP alojado para un canal de Telegram — nada que instalar, ningún archivo de sesión, ningún inicio de sesión en una cuenta personal en toda la cadena. Las catorce herramientas son get_workspace, list_channels, get_channel_stats, list_posts, get_post, create_post, publish_post, cancel_post, update_post, edit_published_post, retry_post_delivery, add_post_image, list_subscribers y get_subscriber: leer el workspace, listar canales, leer estadísticas de suscriptores, listar y leer publicaciones, listar y leer suscriptores individuales, y luego crear, editar, publicar, borrar o reintentar una publicación, o adjuntarle una imagen.

Publicar pasa por el bot que el dueño del canal creó para su propio canal en un toque — nunca un bot compartido de AdminHub y nunca tu cuenta personal. Eso es lo que hace que la cuestión de la cuenta desaparezca en vez de gestionarse: el bot solo puede actuar en los canales a los que se le añadió como administrador, así que el peor caso de un agente confundido es una mala publicación en un canal que ya le habías dado, no un mensaje enviado desde ti a otra persona.

Conectar funciona de dos maneras, según el cliente. claude.ai y ChatGPT toman la dirección del servidor como conector personalizado e inician sesión con Telegram; Claude Code, Cursor y otros clientes basados en cabecera toman una clave en una cabecera Authorization. La guía de configuración recorre ambas vías cliente por cliente, y qué hacer cuando una herramienta se niega. El acceso se revoca en los ajustes de AdminHub y deja de funcionar al momento. Free cubre una conexión y treinta publicaciones creadas por MCP al mes; Pro quita ambos límites.

Lo que no puede hacer, dicho claramente en vez de enterrado: ni vídeo ni documentos adjuntos en una publicación, solo una imagen, y llevarla ahí supone un mensaje reenviado por el chat del propietario con su propio bot; nada de leer chats privados, chats arbitrarios ni historial de mensajes; ni reacciones ni historias; y nada de nada sin un bot conectado al workspace. Es una superficie de publicación en canal para un agente, no acceso a Telegram.

Honestamente, dónde nos gana cada uno

• Leer tu Telegram, sin más. Los dos servidores userbot pueden listar tus diálogos y leerlos. El de AdminHub no tiene ninguna herramienta que toque una conversación — ni mensajes privados, ni grupos, ni un canal que no hayas conectado. Si el motivo por el que llegaste al MCP es “que Claude lea mi Telegram”, no somos una versión reducida de eso; somos otra cosa.
• 181 herramientas frente a catorce. mcp-telegram cubre medios, reacciones, encuestas e historias. Catorce herramientas cubren un workspace, canales, suscriptores y publicaciones. No hay lectura de esa diferencia que nos favorezca.
• Búsqueda en tu propio historial. Un agente que responde “qué acordamos sobre la factura en marzo” necesita el archivo entero. Eso lo da MTProto.
• Enviar un mensaje como tú. tg_send escribe desde tu cuenta a quien sea. Un bot no puede escribir a una persona que nunca lo inició, y no debería.
• Cualquier chat, sin acuerdos previos. Los userbots alcanzan todos los diálogos de la cuenta el mismo día que los instalas. Un bot alcanza exactamente los canales a los que se le añadió como administrador, y alguien tiene que añadirlo.
• Autoalojarlo y cero coste recurrente. Los dos proyectos son MIT, corren en tu propia máquina y no cuestan nada. Un servidor alojado lo aloja otro en los términos de otro; esa es una diferencia real, y no corre a nuestro favor ni en precio ni en control.
• No hace falta cuenta de AdminHub. Ellos son un repositorio y un login. El nuestro necesita un workspace y un bot conectado antes de la primera llamada a una herramienta.

Quién es quién

Servidor	Protocolo	Identidad	Herramientas	Instalación	Licencia / coste
mcp-telegram/mcp-telegram	MTProto (GramJS)	tu cuenta personal	181 — mensajes, medios, reacciones, encuestas, historias	npx, npm, binarios, Docker, código; opción en la nube	MIT, gratis autoalojado
chaindead/telegram-mcp	MTProto	tu cuenta personal	5 — tg_me, tg_dialogs, tg_read, tg_dialog, tg_send	autoalojado; API ID + hash, teléfono, contraseña 2FA	MIT, gratis
AdminHub	Bot API	el bot de tu propio canal	14 — workspace, canales, suscriptores, publicaciones	nada que instalar, alojado	Free: 1 conexión, 30 publicaciones por MCP/mes; Pro: sin límite

Si… entonces…

Si…	Entonces…
Quieres que el agente lea tus DMs o chats de grupo	Un servidor userbot — mcp-telegram por amplitud, chaindead por superficie pequeña
Quieres búsqueda en tu propio historial de mensajes	mcp-telegram; ningún servidor de Bot API puede hacerlo
Quieres reacciones, encuestas o historias	mcp-telegram — los otros dos no tienen esas herramientas
Quieres que el agente escriba a una persona como tú	Un servidor userbot; un bot no puede escribir a quien nunca lo inició
Quieres ejecutarlo todo en tu máquina y gratis	Cualquiera de los dos proyectos MIT, autoalojado
El trabajo es “publica en mi canal y dime qué tal fue”	El servidor de AdminHub — catorce herramientas, alojado, publicado por tu propio bot
Tu cuenta personal debe quedarse totalmente fuera	La vía del bot; un userbot no tiene modo en el que la cuenta no sea la credencial
No tienes bot de Telegram y no quieres tenerlo	Un servidor userbot; AdminHub no hace nada sin un bot en el workspace

Por dónde empezar

Responde a una pregunta antes de comparar números de herramientas: ¿de quién es la identidad que debería usar el agente?

Si la respuesta es “la mía, porque el trabajo es mi bandeja de entrada”, estás en la categoría userbot, y la elección dentro de ella es amplitud contra superficie. mcp-telegram te da 181 herramientas y login por QR; chaindead te da cinco y te pide credenciales de API. Léete los dos READMEs hasta el final: la línea de los términos de servicio es una frase, y es la frase que más peso aguanta en cualquiera de los dos archivos.

Si la respuesta es “la de un bot, porque el trabajo es un canal”, la cuestión de la cuenta no aparece nunca y la lista de herramientas es corta a propósito. Empieza por la página de MCP: el plan gratuito son una conexión y treinta publicaciones al mes, suficiente para averiguar si un agente que lee tus estadísticas y publica por ti es un flujo que se queda. El resto del panorama de publicación en Telegram — colas programadas, importaciones de RSS, las tuberías que configuras una vez en lugar de pedir cada vez — está en la guía completa de autopublicación, y crear el bot en sí lleva alrededor de un minuto si aún no tienes uno.

Y si no lo tienes claro, ten en cuenta que los dos no se excluyen. Un servidor userbot en tu portátil para tu propio archivo y un servidor de bot alojado para el canal en el que publicas son herramientas distintas para trabajos distintos, y usar los dos es una respuesta normal.

Fuentes

Todo consultado el 7 de septiembre de 2026. El número de herramientas, la base de GramJS y MTProto, el planteamiento de “cuenta personal, no un bot”, el login por QR, las rutas de instalación y la nota de sesión única de AUTH_KEY_DUPLICATED: el repositorio de mcp-telegram y mcp-telegram.com. Las cinco herramientas, el requisito de API ID y hash de my.telegram.org, la contraseña de dos factores y el aviso de Términos de Servicio citado arriba: el repositorio chaindead/telegram-mcp. El ámbito de la Bot API y el modelo de token de BotFather: la documentación de la Bot API de Telegram. Las cifras de AdminHub — catorce herramientas, los dos métodos de conexión, los límites de Free y Pro — salen de la página de MCP de este sitio.