Server MCP di Telegram per agenti IA
Metricgram trasforma la Telegram Bot API in un server MCP ospitato, così il tuo agente IA può leggere, pubblicare, moderare e amministrare i tuoi gruppi Telegram con chiavi dai permessi limitati e senza codice del bot da mantenere.
- Oltre 70 metodi della Telegram Bot API come strumenti MCP
- Funziona con Claude, ChatGPT, Cursor e Codex
- Ogni chiamata è limitata ai tuoi gruppi
- Analisi, membri e abbonati nello stesso server
Nessuna carta di credito richiesta
Configurazione in 2 minuti
Come funziona
1
Aggiungi il bot e collega i tuoi gruppi
Aggiungi il bot di Metricgram (o il tuo bot personalizzato) come amministratore dei tuoi gruppi Telegram. Nessun server, webhook o polling da gestire.
2
Crea una chiave API con permessi mirati
Genera una chiave API Elite e scegli esattamente cosa può fare l'agente, dall'accesso a Telegram in sola lettura fino a pubblicazione, moderazione e impostazioni della chat.
3
Collegala al tuo client IA
Incolla un blocco di configurazione in Claude, Cursor, Codex o qualsiasi client MCP. Il tuo agente vedrà ogni azione Telegram consentita come uno strumento.
Un prompt, azioni reali su Telegram
Il tuo agente sceglie le chiamate giuste alla Bot API, Metricgram le esegue nel gruppo corretto e restituisce risultati strutturati.
metricgram · mcp
Tu chiedi
Pubblica l'annuncio dell'AMA di questa settimana in Crypto Talk, fissalo senza notifica, apri un topic «Domande AMA» e dammi un link di invito che scada venerdì.
L'agente chiama
- 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")
Collega qualsiasi client MCP
Usa l'endpoint ospitato con la tua chiave API. Chi usa Claude Desktop può collegarlo tramite mcp-remote.
{
"mcpServers": {
"metricgram": {
"url": "https://metricgram.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Gli strumenti del tuo agente
Messaggi e media
send_telegram_message
send_telegram_media
send_telegram_poll
edit_telegram_message
delete_telegram_messages
forward_telegram_message
react_to_telegram_message
Messaggi fissati e topic del forum
pin_telegram_message
manage_forum_topic
createForumTopic
closeGeneralForumTopic
unpinAllForumTopicMessages
Moderazione e richieste di accesso
ban_member
restrict_member
promote_member
handle_telegram_join_request
banChatSenderChat
setChatAdministratorCustomTitle
Impostazioni della chat e link di invito
update_telegram_chat_settings
create_telegram_invite_link
revokeChatInviteLink
setChatPermissions
setChatStickerSet
Analisi e dati della community
analytics_overview
active_users
list_members
list_messages
gamification_rankings
get_subscriber_health
Qualsiasi metodo supportato della Bot API
telegram_api_methods
telegram_bot_api
get_telegram_chat
get_telegram_chat_member
La Telegram Bot API, pronta per gli agenti IA
Integrare Telegram in un agente di solito significa ospitare un bot, gestire webhook, conservare token e scrivere uno strumento per ogni endpoint. Metricgram fa già girare il bot nei tuoi gruppi, quindi il tuo agente riceve la Bot API come strumenti MCP pronti all'uso da un unico endpoint ospitato.
Strumenti tipizzati e un gateway completo alla Bot API
Le attività comuni, come inviare messaggi, media e sondaggi, fissare messaggi, creare topic e link di invito, hanno strumenti dedicati e ben descritti. Tutto il resto passa da telegram_bot_api, che accetta i nomi e i parametri ufficiali della Bot API, così nulla del catalogo supportato resta fuori portata.
Limitato ai tuoi gruppi
L'agente non sceglie mai un chat_id. Metricgram lo ricava dal gruppo di tua proprietà, verifica i messaggi inoltrati e citati rispetto agli altri tuoi gruppi e rifiuta qualsiasi azione che possa raggiungere un'altra chat.
Permessi per ogni livello di fiducia
Concedi telegram:read agli agenti di ricerca, telegram:write per pubblicare e creare topic, telegram:moderate per ban e richieste di accesso, e telegram:admin per titoli, permessi e link di invito. Le chiavi si possono revocare in qualsiasi momento.
Tentativi sicuri ed errori chiari
Gli strumenti di scrittura accettano una chiave di idempotenza, così una chiamata ripetuta non pubblica mai due volte. Errori e limiti di frequenza di Telegram tornano come risultati strutturati con retry_after, che gli agenti possono gestire da soli.
Un contesto che un bot qualsiasi non ha
Lo stesso server espone le analisi di Metricgram, lo storico dei membri, i messaggi acquisiti, la gamification, i riepiloghi IA e lo stato degli abbonati Stripe, così il tuo agente sa cosa fare prima di agire.
Metricgram vs. Gestione Manuale
| Metricgram | Manuale | |
|---|---|---|
| Endpoint MCP ospitato, nessun server del bot da gestire | ||
| Oltre 70 metodi della Telegram Bot API come strumenti | ||
| chat_id limitato ai tuoi gruppi | ||
| Chiavi API per permesso, revocabili | ||
| Tentativi idempotenti per gli strumenti di scrittura | ||
| Analisi e storico dei membri come contesto | ||
| Dati della chat in tempo reale, admin e permessi | ||
| Funziona con il tuo bot personalizzato |
Domande Frequenti
Che cos'è un server MCP di Telegram?
È un server Model Context Protocol che espone azioni di Telegram come strumenti che un agente IA può chiamare. Metricgram ne ospita uno per te, basato sul bot che già gestisce i tuoi gruppi.
Con quali client IA funziona?
Con qualsiasi client che parli MCP via HTTP, tra cui Claude Code, Claude Desktop (tramite mcp-remote), Cursor, Codex e agenti personalizzati creati con gli SDK di OpenAI o Anthropic.
Copre tutta la Telegram Bot API?
Copre oltre 70 metodi relativi ai gruppi, tra cui messaggi, media, sondaggi, modifiche, reazioni, messaggi fissati, topic del forum, moderazione, richieste di accesso, impostazioni della chat e link di invito. I metodi che toccherebbero altre chat o il bot stesso, come webhook, pagamenti o l'uscita da un gruppo, sono esclusi di proposito.
Un agente può pubblicare in gruppi che non sono miei?
No. Ogni chiamata è legata a uno dei tuoi gruppi collegati. Il chat_id è impostato da Metricgram, e inoltri o risposte possono fare riferimento solo ai tuoi gruppi.
È l'API utente di Telegram (MTProto)?
No. Usa la Bot API ufficiale tramite il bot del tuo gruppo, quindi l'agente agisce come il bot, mai come il tuo account Telegram personale.
Quale piano include il server MCP?
L'accesso a MCP e API fa parte del piano Elite. La prova gratuita di 14 giorni include l'accesso di livello Elite, così puoi collegare un agente prima di pagare.
Posso limitare cosa può fare l'agente?
Sì. Ogni chiave API ha i propri permessi, e puoi creare chiavi separate per ricerca in sola lettura, pubblicazione, moderazione e amministrazione.
Continua a esplorare
Trova una guida pratica, esplora community attive o scopri altri modi di usare Metricgram.
Guide
Blog
Leggi guide pratiche su crescita, monetizzazione, moderazione e gestione delle community Telegram.
EsploraDirectory della community
Directory delle Community Telegram
Esplora community Telegram attive per categoria, lingua e posizionamento.
EsploraHub di sezione
Soluzioni
Tutte le pagine di questa sezione a colpo d'occhio.
EsploraEsplora di più
Strumento di Gestione per Gruppi Telegram
Analisi e Metriche per Gruppi Telegram
Bot Telegram per la Gestione dei Gruppi
Automatizza il Tuo Gruppo Telegram
Bot di Iscrizione Telegram per Community a Pagamento
Bot di Pagamento Telegram per Gruppi e Canali
Bot di Abbonamento Telegram per Entrate Ricorrenti
Monetizzazione del Canale Telegram Semplificata
Crea e Gestisci un Gruppo Telegram VIP
Trasforma il supporto Telegram in account intelligence
MCP
API
Chatbot IA e Assistenti