O que é Telegram Archive MCP?
O telegram-archive-mcp, do usuário do GitHub GeiserX, conecta um cliente MCP a uma instância do Telegram Archive, a ferramenta de backup auto-hospedada do mesmo autor que copia uma ou mais contas do Telegram para SQLite ou PostgreSQL e as exibe em um visualizador web. O servidor MCP conversa apenas com esse visualizador, fazendo login no endpoint /api/login com usuário e senha do visualizador; ele nunca se conecta ao Telegram.
Ele oferece 12 ferramentas e 4 recursos: listar conversas e pastas, buscar em uma conversa ou em todas, ler uma conversa página por página ou um dia de cada vez, buscar as mensagens em volta de uma mensagem específica, listar tópicos de fórum e mensagens fixadas, obter estatísticas por conversa e devolver uma foto anexada como imagem que o modelo consegue ver. Todas as ferramentas só leem, exceto refresh_stats, que pede ao visualizador para recalcular as estatísticas do arquivo e some com READ_ONLY=1. É escrito em Go, com licença GPL-3.0-or-later, e distribuído via npm, Docker e binários pré-compilados; a versão 0.4.2 saiu em 11 de novembro de 2026.
Como instalar Telegram Archive MCP
npx -y telegram-archive-mcpTelegram Archive MCP vale a pena?
A decisão de projeto que importa é que este servidor nunca toca o Telegram. Ele lê do visualizador do Telegram Archive, que já guarda uma cópia das suas mensagens no seu próprio disco, então um agente não consegue enviar mensagem, sair de um grupo nem acionar os sistemas antispam do Telegram. O pior que um modelo descontrolado pode fazer é ler demais, mais uma única escrita: refresh_stats, que só faz o visualizador recontar as estatísticas.
As ferramentas seguem o jeito como as pessoas realmente procuram coisas no histórico de conversas. Buscar em todas as conversas de uma vez, ler um dia do calendário no seu fuso horário e puxar as mensagens antes e depois de um resultado respondem a perguntas como o que foi combinado no grupo do projeto em uma determinada terça-feira. Tópicos de fórum e pastas são suportados, e as fotos voltam reduzidas a 1.568 pixels para que um modelo com visão consiga ler uma captura de tela que alguém postou.
Os padrões de rede são melhores do que os da maioria dos servidores comunitários. Via stdio, nada fica escutando. O modo Streamable HTTP se liga ao loopback, verifica o cabeçalho Origin, limita o tamanho das requisições e se recusa a iniciar em qualquer outro endereço sem MCP_AUTH_TOKEN. A versão 0.4.2 recompilou o servidor com Go 1.27.4 justamente para que uma requisição grande demais não pudesse derrubá-lo.
O porém: ele só é tão útil quanto o arquivo por trás dele, e isso é um compromisso. O Telegram Archive exige Docker Compose, um API ID e um hash do Telegram e um login na sua conta; ele guarda edições e mensagens apagadas, inclusive as de outras pessoas. Apontar um cliente MCP para ele envia essas mensagens, apagadas incluídas, ao provedor de modelo que o cliente usa. O projeto também é pequeno: 13 estrelas no servidor MCP, 252 no Telegram Archive e cerca de 2.100 downloads no npm no último mês, com todos os commits humanos de um único mantenedor.
Nossa opinião: se você já decidiu guardar seu histórico do Telegram em um servidor doméstico, esta é uma forma cuidadosa de deixá-lo pesquisável por um assistente. Crie uma conta de visualizador limitada às conversas que quer tornar pesquisáveis, em vez de entregar o login de administrador.
Onde ele se destaca
Um desenvolvedor freelancer que combina o escopo com clientes em grupos do Telegram
Descobrir o que um cliente realmente aprovou três meses atrás
Peça ao assistente para buscar o nome da funcionalidade no grupo do cliente e depois ler as mensagens em volta e a conversa daquele dia. Leva segundos em vez de rolar sem fim; o custo é o servidor que roda o arquivo.
Um moderador de um grupo-fórum do Telegram com 5.000 membros
Resumir um tópico movimentado para quem ficou uma semana fora
Liste os tópicos do fórum do grupo, leia o tópico escolhido página por página e peça ao modelo um resumo. Use uma conta de visualizador restrita a esse grupo para que o agente não leia conversas privadas.
Uma pesquisadora que arquiva canais públicos do Telegram
Rastrear quando uma afirmação apareceu pela primeira vez em vários canais
Busque a frase em todas as conversas arquivadas, leia cada resultado no contexto e compare as datas. As edições e exclusões guardadas pelo arquivo mostram se os posts mudaram depois de publicados.
Antes de decidir
- Configuração
- Coloque primeiro o Telegram Archive para rodar (Docker Compose, um api_id e um api_hash do Telegram e um login único). Depois adicione npx -y telegram-archive-mcp com TELEGRAM_ARCHIVE_URL, TELEGRAM_ARCHIVE_USER e TELEGRAM_ARCHIVE_PASS; há configurações documentadas para Claude Code, Claude Desktop, Cursor, VS Code e Codex.
- Integrações
- 12 ferramentas e 4 recursos via stdio ou Streamable HTTP, com suporte às revisões do MCP de 2024-11-05 a 2026-07-28. Distribuído como pacote npm que baixa um binário com verificação de checksum, como imagem Docker e como binários Go para várias plataformas.
- Dados e privacidade
- O arquivo fica no seu disco, mas cada mensagem, foto e estatística que uma ferramenta devolve passa para o seu provedor de modelo. O usuário e a senha do visualizador ficam no ambiente do cliente. O modo HTTP se liga ao loopback, verifica Origin e exige MCP_AUTH_TOKEN em qualquer outro endereço.
- Custo em escala
- Gratuito. Os custos são o host do arquivo e seu armazenamento, que cresce com a mídia que você decide guardar; o Telegram Archive pode pular arquivos acima de um tamanho que você define.
- Limites
- Apenas acesso de leitura; ele não consegue enviar, editar nem apagar nada no Telegram. A qualidade da busca depende da busca do próprio Telegram Archive. Só a versão mais recente recebe correções de segurança.
O que é bom
- Nunca se conecta ao Telegram; lê um arquivo local
- Somente leitura, exceto uma ferramenta de estatísticas que READ_ONLY=1 esconde
- Leitura dia a dia e busca em todas as conversas
- O modo HTTP recusa endereços fora do loopback sem token
O que não é
- Precisa de uma instância do Telegram Archive rodando
- Mensagens arquivadas e apagadas chegam ao seu provedor de modelo
- Um só mantenedor e base de usuários pequena
- A senha do visualizador fica na configuração do cliente
Ideal para
Quem já auto-hospeda o Telegram Archive e quer que um assistente busque e resuma as conversas salvas.
Alternativas ao Telegram Archive MCP
Telegram Archive MCP: perguntas frequentes
- Telegram Archive MCP vale a pena?
- Uma janela organizada e quase totalmente somente leitura para o seu próprio histórico do Telegram, que só vale a pena se você já roda o Telegram Archive e aceita que suas conversas cheguem a um provedor de modelo. Damos nota 3.8 de 5.
- Quanto custa Telegram Archive MCP?
- Gratuito e de código aberto (GPL-3.0-or-later), assim como o próprio Telegram Archive. Você paga só pela máquina que hospeda o arquivo.
- Quais são as desvantagens de Telegram Archive MCP?
- Precisa de uma instância do Telegram Archive rodando; mensagens arquivadas e apagadas chegam ao seu provedor de modelo; um só mantenedor e base de usuários pequena; a senha do visualizador fica na configuração do cliente.
- Para quem Telegram Archive MCP é indicado?
- Quem já auto-hospeda o Telegram Archive e quer que um assistente busque e resuma as conversas salvas.
- Quanto custa Telegram Archive MCP para uma equipe ou em produção?
- Gratuito. Os custos são o host do arquivo e seu armazenamento, que cresce com a mídia que você decide guardar; o Telegram Archive pode pular arquivos acima de um tamanho que você define.
- Telegram Archive MCP é seguro para dados da empresa?
- O arquivo fica no seu disco, mas cada mensagem, foto e estatística que uma ferramenta devolve passa para o seu provedor de modelo. O usuário e a senha do visualizador ficam no ambiente do cliente. O modo HTTP se liga ao loopback, verifica Origin e exige MCP_AUTH_TOKEN em qualquer outro endereço.
- Quais são as melhores alternativas ao Telegram Archive MCP?
- As alternativas mais próximas que analisamos são Slack MCP Server e Paperless-NGX MCP Server.
Respostas verificadas em 13 de nov. de 2026.