Servidor MCP do Telegram para agentes de IA
A Metricgram transforma a Telegram Bot API em um servidor MCP hospedado, para que seu agente de IA leia, publique, modere e administre seus grupos do Telegram com chaves de escopo limitado e sem código de bot para manter.
- Mais de 70 métodos da Telegram Bot API como ferramentas MCP
- Funciona com Claude, ChatGPT, Cursor e Codex
- Cada chamada fica restrita aos seus próprios grupos
- Análises, membros e assinantes no mesmo servidor
Sem cartão de crédito
Configure em 2 minutos
Como funciona
1
Adicione o bot e conecte seus grupos
Adicione o bot da Metricgram (ou seu próprio bot personalizado) como administrador dos seus grupos do Telegram. Sem servidores, webhooks ou polling para manter.
2
Aprove o acesso com OAuth
Entre e aprove a conexão com OAuth, ou crie uma chave de API e escolha exatamente o que o agente pode fazer, do acesso somente leitura ao Telegram até publicação, moderação e configurações do chat.
3
Conecte ao seu cliente de IA
Cole um bloco de configuração no Claude, Cursor, Codex ou qualquer cliente MCP. Seu agente passa a ver cada ação permitida do Telegram como uma ferramenta.
Um prompt, ações reais no Telegram
Seu agente escolhe as chamadas certas da Bot API, a Metricgram as executa no grupo correto e devolve resultados estruturados.
metricgram · mcp
Você pede
Publique o anúncio do AMA desta semana no Crypto Talk, fixe sem notificar, abra um tópico “Perguntas do AMA” e me dê um link de convite que expire na sexta-feira.
O agente chama
- send_telegram_message(group_id: 42, text: "…", buttons: [{ url: "…" }])
- pin_telegram_message(group_id: 42, action: "pin", disable_notification: true)
- manage_forum_topic(group_id: 42, action: "create", name: "…")
- create_telegram_invite_link(group_id: 42, expire_date: "2026-10-23T23:59:00Z")
Conecte qualquer cliente MCP
Use o endpoint hospedado com sua chave de API. Quem usa o Claude Desktop pode conectá-lo via mcp-remote.
{
"mcpServers": {
"metricgram": {
"url": "https://metricgram.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Ferramentas que seu agente recebe
Mensagens e mídia
send_telegram_message
send_telegram_media
send_telegram_poll
edit_telegram_message
delete_telegram_messages
forward_telegram_message
react_to_telegram_message
Mensagens fixadas e tópicos do fórum
pin_telegram_message
manage_forum_topic
createForumTopic
closeGeneralForumTopic
unpinAllForumTopicMessages
Moderação e pedidos de entrada
ban_member
restrict_member
promote_member
handle_telegram_join_request
banChatSenderChat
setChatAdministratorCustomTitle
Configurações do chat e links de convite
update_telegram_chat_settings
create_telegram_invite_link
revokeChatInviteLink
setChatPermissions
setChatStickerSet
Análises e dados da comunidade
analytics_overview
active_users
list_members
list_messages
gamification_rankings
get_subscriber_health
Qualquer método suportado da Bot API
telegram_api_methods
telegram_bot_api
get_telegram_chat
get_telegram_chat_member
A Telegram Bot API, pronta para agentes de IA
Criar uma integração do Telegram para um agente normalmente significa hospedar um bot, lidar com webhooks, guardar tokens e escrever uma ferramenta para cada endpoint. A Metricgram já mantém o bot dentro dos seus grupos, então seu agente recebe a Bot API como ferramentas MCP prontas a partir de um único endpoint hospedado.
Ferramentas tipadas e um gateway completo para a Bot API
Tarefas comuns, como enviar mensagens, mídia, enquetes, fixar mensagens, criar tópicos e links de convite, têm ferramentas próprias e bem descritas. Todo o resto passa pelo telegram_bot_api, que aceita os nomes e parâmetros oficiais da Bot API, então nada do catálogo suportado fica de fora.
Restrito aos seus próprios grupos
O agente nunca escolhe um chat_id. A Metricgram o obtém do grupo que pertence a você, verifica mensagens encaminhadas e citadas em relação aos seus outros grupos e recusa qualquer coisa que possa chegar a outro chat.
Escopos para cada nível de confiança
Conceda telegram:read para agentes de pesquisa, telegram:write para publicações e tópicos, telegram:moderate para banimentos e pedidos de entrada, e telegram:admin para títulos, permissões e links de convite. As chaves podem ser revogadas a qualquer momento.
Novas tentativas seguras e erros claros
As ferramentas de escrita aceitam uma chave de idempotência, então uma chamada repetida nunca publica duas vezes. Erros e limites de taxa do Telegram voltam como resultados estruturados com retry_after, que os agentes conseguem tratar sozinhos.
Contexto que um bot simples não tem
O mesmo servidor expõe as análises da Metricgram, o histórico de membros, as mensagens capturadas, a gamificação, os resumos com IA e a saúde dos assinantes do Stripe, para que seu agente decida o que fazer antes de agir.
Metricgram vs. Gestão manual
| Metricgram | Manual | |
|---|---|---|
| Endpoint MCP hospedado, sem servidor de bot para manter | ||
| Mais de 70 métodos da Telegram Bot API como ferramentas | ||
| chat_id restrito aos seus próprios grupos | ||
| Chaves de API por escopo que você pode revogar | ||
| Novas tentativas idempotentes nas ferramentas de escrita | ||
| Análises e histórico de membros como contexto | ||
| Dados do chat em tempo real, administradores e permissões | ||
| Funciona com seu próprio bot personalizado |
Perguntas frequentes
O que é um servidor MCP do Telegram?
É um servidor Model Context Protocol que expõe ações do Telegram como ferramentas que um agente de IA pode chamar. A Metricgram hospeda um para você, apoiado pelo bot que já gerencia seus grupos.
Com quais clientes de IA ele funciona?
Com qualquer cliente que fale MCP via HTTP, incluindo Claude Code, Claude Desktop (via mcp-remote), Cursor, Codex e agentes próprios criados com os SDKs da OpenAI ou da Anthropic.
Ele cobre toda a Telegram Bot API?
Cobre mais de 70 métodos ligados a grupos, incluindo mensagens, mídia, enquetes, edições, reações, mensagens fixadas, tópicos do fórum, moderação, pedidos de entrada, configurações do chat e links de convite. Métodos que afetariam outros chats ou o próprio bot, como webhooks, pagamentos ou sair de um grupo, ficam de fora de propósito.
Um agente pode publicar em grupos que não são meus?
Não. Cada chamada está vinculada a um dos seus grupos conectados. O chat_id é definido pela Metricgram, e encaminhamentos ou respostas só podem fazer referência aos seus próprios grupos.
Isso é a API de usuário do Telegram (MTProto)?
Não. Usa a Bot API oficial por meio do bot do seu grupo, então o agente age como o bot, nunca como sua conta pessoal do Telegram.
Qual plano inclui o servidor MCP?
O servidor MCP está incluído em todos os planos da Metricgram e no teste grátis de 14 dias, então você pode conectar um agente antes de pagar. A API REST para o seu próprio código faz parte do plano Elite.
Posso limitar o que o agente pode fazer?
Sim. Cada chave de API tem seus próprios escopos, e você pode criar chaves separadas para pesquisa somente leitura, publicação, moderação e administração.
Continue explorando
Encontre um guia prático, explore comunidades ativas ou descubra mais formas de usar a Metricgram.
Guias
Blog
Leia guias práticos sobre crescimento, monetização, moderação e operação de comunidades no Telegram.
ExplorarDiretório de comunidades
Diretório de comunidades do Telegram
Explore comunidades ativas no Telegram por categoria, idioma e posicionamento.
ExplorarHub da seção
Soluções
Veja todas as páginas desta seção lado a lado.
ExplorarExplore mais
Ferramenta de gestão de grupos do Telegram
Análises e métricas para grupos do Telegram
Bot do Telegram para gestão de grupos
Automatize seu grupo do Telegram
Bot de Membros do Telegram para Comunidades Pagas
Pagamentos e acesso pago para grupos do Telegram
Bot de Assinatura do Telegram para Receita Recorrente
Monetização de Canal do Telegram de Forma Simples
Crie e Gerencie um Grupo VIP do Telegram
Substack + Telegram para assinantes pagos
Transforme suporte no Telegram em inteligência de contas
MCP
API
Chatbots de IA Assistentes