Servidores MCP de Telegram: userbot ou bot (2026)

Resumo. “Telegram MCP” devolve duas categorias que não compartilham nada além do nome. Servidores userbot — mcp-telegram/mcp-telegram com 181 ferramentas, chaindead/telegram-mcp com cinco — entram na sua conta pessoal do Telegram por MTProto e entregam ao agente o mesmo alcance que o app do seu celular tem: conversas privadas, qualquer grupo, o histórico inteiro. Você mesmo instala, a licença é MIT, não custam nada, e um deles avisa no próprio README que usar mal a API pode custar a conta. Servidores de bot cobrem muito menos, de propósito: as catorze ferramentas do AdminHub leem um workspace, canais e inscritos e escrevem posts, publicados pelo bot que o dono do canal criou ele mesmo — nunca um bot compartilhado do AdminHub e nunca a sua conta pessoal. Se o que você quer é um agente lendo suas DMs do Telegram, pode parar por aqui: isso é trabalho de userbot, e toda seção abaixo diz o mesmo. Projetos verificados em 7 de setembro de 2026.

Busque “telegram mcp” e você recebe uma página de repositórios que se descrevem todos do mesmo jeito — conecte seu agente de IA ao Telegram. Instale um ao acaso e você descobre, lá pela etapa de login, que “conectar ao Telegram” queria dizer “entrar na sua conta pessoal e deixar o agente com ela”. É uma escolha de projeto legítima, e para uma classe grande de tarefas é a única que funciona. Também é uma decisão, e a maioria dos READMEs a apresenta como instrução de instalação. Este texto separa as duas categorias primeiro e nomeia os projetos depois, com tudo lido nos repositórios dos próprios projetos em 7 de setembro de 2026.

O protocolo é a diferença inteira

O Telegram tem duas portas, e todo servidor MCP escolhe uma antes de escolher qualquer outra coisa.

A Bot API é um invólucro HTTP em volta de uma identidade de bot. Você pega um token com o BotFather, e o software que segura esse token age como aquele bot — mas só dentro das conversas e canais aos quais o bot foi adicionado. Ele não enxerga suas mensagens privadas, não se coloca sozinho num grupo, não lê um canal do qual não faz parte. O teto é baixo por construção; o piso é que nada que você não conectou de propósito fica exposto.

MTProto é o protocolo de cliente do próprio Telegram, o mesmo que o app do seu celular fala. Um programa que faz login por MTProto com as suas credenciais é a sua conta, com o acesso que você tem: cada conversa privada, cada grupo, o histórico inteiro e pesquisável, as mensagens salvas, tudo. Não há escopo para estreitar, porque uma conta não é um escopo. Software que faz isso é chamado, por convenção, de userbot.

Essa única escolha determina tudo o que vem depois — quantas ferramentas um servidor pode oferecer, o que ele consegue ler, o que ele pede de você na configuração e o que está em jogo quando algo dá errado. Leia a linha do protocolo num README antes de ler a contagem de ferramentas.

E não existe, é bom notar, opção oficial com que comparar. O Telegram não entrega servidor MCP nenhum, então o campo é inteiramente de terceiros, e a maior parte dele são userbots que você mesmo instala.

Os servidores userbot

mcp-telegram/mcp-telegram

O maior de longe. A documentação conta 181 ferramentas — mensagens, mídia, reações, enquetes, stories e mais —, construídas sobre MTProto via GramJS, e assume a posição sem rodeios: funciona como a sua conta pessoal, não como um bot. Configurar significa entrar numa conta pessoal do Telegram, com login por QR code suportado, então um número de telefone não é estritamente necessário. Você pode rodar por conta própria via npx, npm, binários prontos, Docker ou a partir do código, ou usar a versão hospedada em mcp-telegram.com. A licença é MIT.

A documentação chama a coisa pelo nome — userbot (personal account), not a bot — respect the Telegram Terms of Service, ou seja, “userbot (conta pessoal), não um bot — respeite os Termos de Serviço do Telegram” — mas para antes de qualquer aviso sobre consequências. Um detalhe operacional para saber antes de ligar isso em dois clientes ao mesmo tempo: uma sessão pertence a um único processo, e rodar a mesma sessão em dois devolve AUTH_KEY_DUPLICATED.

181 ferramentas não é enchimento. Reações, enquetes, stories e busca no seu próprio histórico são superfícies reais, e nenhum servidor de Bot API chega nelas em conversas arbitrárias — nem este ano, nem com outro fornecedor. Se a tarefa é essa, a categoria é essa, e nada mais adiante neste artigo compete com ela.

chaindead/telegram-mcp

Mesmo protocolo, superfície muito menor: cinco ferramentas — tg_me, tg_dialogs, tg_read, tg_dialog e tg_send. Listar seus diálogos, ler uma conversa, marcá-la como lida, enviar uma mensagem, checar quem você é. Também MIT, também conta pessoal. A configuração pede mais que escanear um QR: um API ID e hash criados em my.telegram.org, seu número de telefone e sua senha quando a autenticação em dois fatores está ligada.

É também o projeto que coloca o trade-off 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 — “Garanta que leu e entendeu os Termos de Serviço da API do Telegram antes de usar este servidor. Qualquer uso indevido da API do Telegram pode resultar na suspensão da sua conta”. Mesmo protocolo do servidor de 181 ferramentas, mesma exposição — dita onde você consegue ver antes de digitar seu número.

O que o caminho da conta pessoal custa

Não é “você vai ser banido”. Ninguém honesto consegue te dizer isso, e este artigo não vai. O que está registrado é mais estreito, e ainda assim vale pesar.

• Sua conta é a credencial. Não há permissão por conversa para conceder nem modo somente leitura. Um arquivo de sessão que chega a um agente alcança tudo o que a conta alcança, inclusive conversas que você tinha esquecido que estavam nela.
• Automação corre sob os termos de API do Telegram. Um dos dois projetos aqui diz abertamente que uso indevido pode resultar em suspensão. Os dois pedem que você aceite os mesmos termos; só um os menciona.
• O operador é você. Auto-hospedado quer dizer que o processo, o arquivo de sessão, as atualizações e os modos de falha são seus — inclusive o AUTH_KEY_DUPLICATED quando dois clientes dividem uma sessão. A variante em nuvem do mcp-telegram tira a tarefa de hospedar, não a questão da conta.
• O raio de impacto é a conta. Injeção de prompt é uma preocupação viva para qualquer agente que lê texto não confiável, e uma caixa de entrada do Telegram é texto não confiável por definição. No caminho do userbot, as ferramentas que poderiam agir sob uma instrução hostil incluem as que leem todas as conversas que você tem.

Nada disso torna a categoria errada. Torna ela uma troca deliberada: capacidade enorme em troca de colocar a sua própria conta atrás do agente. Gente faz essa troca todo dia de olhos abertos, e ela é a decisão certa sempre que a tarefa realmente exige alcance pessoal.

O caminho do bot: o que o servidor MCP do AdminHub faz

O outro lado da bifurcação abre mão do alcance e mantém a conta fora disso. O AdminHub roda um servidor MCP hospedado para um canal do Telegram — nada para instalar, nenhum arquivo de sessão, nenhum login em conta pessoal em ponto algum da cadeia. As catorze ferramentas são 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 e get_subscriber: ler o workspace, listar canais, ler estatísticas de inscritos, listar e ler posts, listar e ler inscritos individuais, e então criar, editar, publicar, apagar ou reenviar um post, ou anexar uma imagem a ele.

A publicação passa pelo bot que o dono do canal criou para o próprio canal em um toque — nunca um bot compartilhado do AdminHub e nunca a sua conta pessoal. É isso que faz a questão da conta desaparecer em vez de virar risco administrado: o bot só age nos canais aos quais foi adicionado como administrador, então o pior caso de um agente confuso é um post ruim num canal que você já tinha entregado a ele, não uma mensagem enviada em seu nome para outra pessoa.

Conectar funciona de duas formas, dependendo do cliente. claude.ai e ChatGPT aceitam o endereço do servidor como conector personalizado e fazem login com o Telegram; Claude Code, Cursor e outros clientes baseados em cabeçalho aceitam uma chave num cabeçalho Authorization. O guia de configuração percorre os dois caminhos cliente por cliente, e o que fazer quando uma ferramenta recusa. O acesso é revogado nas configurações do AdminHub e para de funcionar na hora. O Free cobre uma conexão e trinta posts criados por MCP ao mês; o Pro tira os dois limites.

O que ele não faz, dito na cara em vez de escondido: nada de vídeo ou documento anexado a um post, só uma imagem, e levá-la até lá custa uma mensagem repassada pela conversa do dono com o próprio bot; nenhuma leitura de conversas privadas, conversas arbitrárias ou histórico de mensagens; nada de reações e nada de stories; e nada de nada sem um bot conectado ao workspace. É uma superfície de publicação em canal para um agente, não acesso ao Telegram.

Honestamente, onde cada um ganha da gente

• Ler o seu Telegram, ponto. Os dois servidores userbot listam seus diálogos e leem. O do AdminHub não tem ferramenta que encoste numa conversa — nem mensagens privadas, nem grupos, nem um canal que você não conectou. Se o motivo de você ter chegado ao MCP é “deixar o Claude ler meu Telegram”, não somos uma versão menor disso; somos outra coisa.
• 181 ferramentas contra catorze. O mcp-telegram cobre mídia, reações, enquetes e stories. Catorze ferramentas cobrem um workspace, canais, inscritos e posts. Não existe leitura dessa diferença que nos favoreça.
• Busca no seu próprio histórico. Um agente que responde “o que a gente combinou sobre a nota fiscal em março” precisa do arquivo inteiro. Isso é o MTProto que dá.
• Enviar mensagem como você. O tg_send escreve da sua conta para qualquer pessoa. Um bot não pode escrever para alguém que nunca o iniciou, e nem deve.
• Qualquer conversa, sem combinar nada. Userbots alcançam todo diálogo da conta no dia em que você os instala. Um bot alcança exatamente os canais aos quais foi adicionado como administrador, e alguém tem que adicionar.
• Auto-hospedagem e custo recorrente zero. Os dois projetos são MIT, rodam na sua máquina e não custam nada. Um servidor hospedado é hospedado por outra pessoa nos termos de outra pessoa; essa é uma diferença real, e ela não corre a nosso favor nem no preço nem no controle.
• Nenhuma conta do AdminHub necessária. Eles são um repositório e um login. O nosso precisa de um workspace e de um bot conectado antes da primeira chamada de ferramenta.

Quem é quem

Servidor	Protocolo	Identidade	Ferramentas	Instalação	Licença / custo
mcp-telegram/mcp-telegram	MTProto (GramJS)	sua conta pessoal	181 — mensagens, mídia, reações, enquetes, stories	npx, npm, binários, Docker, código; opção em nuvem	MIT, grátis para auto-hospedar
chaindead/telegram-mcp	MTProto	sua conta pessoal	5 — tg_me, tg_dialogs, tg_read, tg_dialog, tg_send	auto-hospedado; API ID + hash, telefone, senha 2FA	MIT, grátis
AdminHub	Bot API	o bot do seu próprio canal	14 — workspace, canais, inscritos, posts	nada para instalar, hospedado	Free: 1 conexão, 30 posts por MCP/mês; Pro: sem limite

Se… então…

Se…	Então…
Você quer o agente lendo suas DMs ou conversas de grupo	Um servidor userbot — mcp-telegram pela amplitude, chaindead por uma superfície pequena
Você quer busca no seu próprio histórico de mensagens	mcp-telegram; nenhum servidor de Bot API faz isso
Você quer reações, enquetes ou stories	mcp-telegram — os outros dois não têm essas ferramentas
Você quer que o agente escreva para uma pessoa como você	Um servidor userbot; um bot não escreve para quem nunca o iniciou
Você quer rodar tudo na sua máquina de graça	Qualquer um dos dois projetos MIT, auto-hospedado
A tarefa é “publica no meu canal e me diz como foi”	O servidor do AdminHub — catorze ferramentas, hospedado, publicado pelo seu próprio bot
Sua conta pessoal precisa ficar totalmente de fora	O caminho do bot; um userbot não tem modo em que a conta não seja a credencial
Você não tem bot no Telegram e não quer ter	Um servidor userbot; o AdminHub não faz nada sem um bot no workspace

Por onde começar

Responda uma pergunta antes de comparar contagens de ferramentas: de quem é a identidade que o agente deve usar?

Se a resposta é “minha, porque a tarefa é a minha caixa de entrada”, você está na categoria userbot, e a escolha dentro dela é amplitude contra área de superfície. O mcp-telegram te dá 181 ferramentas e login por QR; o chaindead te dá cinco e pede credenciais de API. Leia os dois READMEs até o fim — a linha dos termos de serviço é uma frase, e é a frase que mais sustenta peso nos dois arquivos.

Se a resposta é “a de um bot, porque a tarefa é um canal”, a questão da conta nunca aparece e a lista de ferramentas é curta de propósito. Comece pela página de MCP: o plano gratuito é uma conexão e trinta posts por mês, o bastante para descobrir se um agente que lê suas estatísticas e publica por você é um fluxo que fica. O resto do quadro de publicação no Telegram — filas agendadas, importação de RSS, os pipelines que você configura uma vez em vez de pedir toda vez — está no guia completo de autopostagem, e criar o bot em si leva cerca de um minuto se você ainda não tem um.

E se você está em dúvida, note que os dois não se excluem. Um servidor userbot no seu notebook para o seu próprio arquivo e um servidor de bot hospedado para o canal em que você publica são ferramentas diferentes para tarefas diferentes, e rodar os dois é uma resposta normal.

Fontes

Tudo consultado em 7 de setembro de 2026. Contagem de ferramentas, base em GramJS e MTProto, o enquadramento “conta pessoal, não um bot”, login por QR, os caminhos de instalação e a nota de sessão única do AUTH_KEY_DUPLICATED: o repositório do mcp-telegram e mcp-telegram.com. As cinco ferramentas, a exigência de API ID e hash do my.telegram.org, a senha de dois fatores e o aviso de Termos de Serviço citado acima: o repositório chaindead/telegram-mcp. Escopo da Bot API e o modelo de token do BotFather: a documentação da Bot API do Telegram. Os números do AdminHub — catorze ferramentas, os dois métodos de conexão, os limites de Free e Pro — vêm da página de MCP deste site.