Serveur MCP Telegram pour agents IA
Metricgram transforme la Telegram Bot API en serveur MCP hébergé : votre agent IA peut lire, publier, modérer et administrer vos groupes Telegram avec des clés aux droits limités, sans code de bot à maintenir.
- Plus de 70 méthodes de la Telegram Bot API en outils MCP
- Compatible avec Claude, ChatGPT, Cursor et Codex
- Chaque appel limité à vos propres groupes
- Analytics, membres et abonnés dans le même serveur
Aucune carte de crédit requise
Configuration en 2 minutes
Comment ça marche
1
Ajoutez le bot et connectez vos groupes
Ajoutez le bot Metricgram (ou votre propre bot personnalisé) comme administrateur de vos groupes Telegram. Aucun serveur, webhook ni polling à gérer.
2
Créez une clé API avec des scopes
Générez une clé API Elite et choisissez précisément ce que l'agent peut faire, de l'accès Telegram en lecture seule à la publication, la modération et les paramètres du chat.
3
Branchez-la sur votre client IA
Collez un bloc de configuration dans Claude, Cursor, Codex ou n'importe quel client MCP. Votre agent voit alors chaque action Telegram autorisée comme un outil.
Un prompt, de vraies actions dans Telegram
Votre agent choisit les bons appels à la Bot API, Metricgram les exécute dans le bon groupe et renvoie des résultats structurés.
metricgram · mcp
Vous demandez
Publie l'annonce de l'AMA de cette semaine dans Crypto Talk, épingle-la sans notification, ouvre un sujet « Questions AMA » et donne-moi un lien d'invitation qui expire vendredi.
L'agent appelle
- 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")
Connectez n'importe quel client MCP
Utilisez l'endpoint hébergé avec votre clé API. Sur Claude Desktop, vous pouvez le relier via mcp-remote.
{
"mcpServers": {
"metricgram": {
"url": "https://metricgram.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Les outils de votre agent
Messages et médias
send_telegram_message
send_telegram_media
send_telegram_poll
edit_telegram_message
delete_telegram_messages
forward_telegram_message
react_to_telegram_message
Épinglage et sujets de forum
pin_telegram_message
manage_forum_topic
createForumTopic
closeGeneralForumTopic
unpinAllForumTopicMessages
Modération et demandes d'adhésion
ban_member
restrict_member
promote_member
handle_telegram_join_request
banChatSenderChat
setChatAdministratorCustomTitle
Paramètres du chat et liens d'invitation
update_telegram_chat_settings
create_telegram_invite_link
revokeChatInviteLink
setChatPermissions
setChatStickerSet
Analytics et données de la communauté
analytics_overview
active_users
list_members
list_messages
gamification_rankings
get_subscriber_health
Toute méthode prise en charge de la Bot API
telegram_api_methods
telegram_bot_api
get_telegram_chat
get_telegram_chat_member
La Telegram Bot API, prête pour les agents IA
Intégrer Telegram à un agent implique en général d'héberger un bot, de gérer des webhooks, de stocker des tokens et d'écrire un outil pour chaque endpoint. Metricgram fait déjà tourner le bot dans vos groupes : votre agent reçoit la Bot API sous forme d'outils MCP prêts à l'emploi, depuis un seul endpoint hébergé.
Des outils typés et une passerelle complète vers la Bot API
Les tâches courantes comme l'envoi de messages, de médias et de sondages, l'épinglage, les sujets ou les liens d'invitation disposent d'outils dédiés et bien décrits. Tout le reste passe par telegram_bot_api, qui accepte les noms et paramètres officiels de la Bot API : rien dans le catalogue pris en charge n'est hors de portée.
Limité à vos propres groupes
L'agent ne choisit jamais de chat_id. Metricgram le déduit du groupe qui vous appartient, vérifie les messages transférés et cités par rapport à vos autres groupes et refuse tout ce qui pourrait atteindre un autre chat.
Des scopes pour chaque niveau de confiance
Accordez telegram:read aux agents de recherche, telegram:write pour la publication et les sujets, telegram:moderate pour les bannissements et les demandes d'adhésion, et telegram:admin pour les titres, permissions et liens d'invitation. Les clés sont révocables à tout moment.
Relances sûres et erreurs claires
Les outils d'écriture acceptent une clé d'idempotence : un appel relancé ne publie jamais deux fois. Les erreurs et limites de débit de Telegram reviennent sous forme de résultats structurés avec retry_after, que les agents gèrent eux-mêmes.
Un contexte qu'un bot classique n'a pas
Le même serveur expose les analytics Metricgram, l'historique des membres, les messages capturés, la gamification, les résumés IA et la santé des abonnés Stripe, pour que votre agent sache quoi faire avant d'agir.
Metricgram vs. gestion manuelle
| Metricgram | Manuel | |
|---|---|---|
| Endpoint MCP hébergé, aucun serveur de bot à gérer | ||
| Plus de 70 méthodes de la Telegram Bot API en outils | ||
| chat_id limité à vos propres groupes | ||
| Clés API par scope, révocables | ||
| Relances idempotentes pour les outils d'écriture | ||
| Analytics et historique des membres comme contexte | ||
| Données du chat en direct, admins et permissions | ||
| Compatible avec votre propre bot personnalisé |
Questions fréquentes
Qu'est-ce qu'un serveur MCP Telegram ?
C'est un serveur Model Context Protocol qui expose des actions Telegram sous forme d'outils qu'un agent IA peut appeler. Metricgram en héberge un pour vous, adossé au bot qui gère déjà vos groupes.
Avec quels clients IA fonctionne-t-il ?
Avec tout client qui parle MCP en HTTP, notamment Claude Code, Claude Desktop (via mcp-remote), Cursor, Codex et les agents sur mesure créés avec les SDK d'OpenAI ou d'Anthropic.
Couvre-t-il toute la Telegram Bot API ?
Il couvre plus de 70 méthodes liées aux groupes : messages, médias, sondages, modifications, réactions, épinglage, sujets de forum, modération, demandes d'adhésion, paramètres du chat et liens d'invitation. Les méthodes qui toucheraient d'autres chats ou le bot lui-même, comme les webhooks, les paiements ou quitter un groupe, sont volontairement exclues.
Un agent peut-il publier dans des groupes qui ne m'appartiennent pas ?
Non. Chaque appel est lié à l'un de vos groupes connectés. Le chat_id est défini par Metricgram, et les transferts ou réponses ne peuvent référencer que vos propres groupes.
S'agit-il de l'API utilisateur de Telegram (MTProto) ?
Non. Il utilise la Bot API officielle via le bot de votre groupe : l'agent agit en tant que bot, jamais en tant que votre compte Telegram personnel.
Quel forfait inclut le serveur MCP ?
L'accès MCP et API fait partie du forfait Elite. L'essai gratuit de 14 jours inclut un accès de niveau Elite, vous pouvez donc connecter un agent avant de payer.
Puis-je limiter ce que l'agent a le droit de faire ?
Oui. Chaque clé API a ses propres scopes, et vous pouvez créer des clés distinctes pour la recherche en lecture seule, la publication, la modération et l'administration.
Continuez à explorer
Trouvez un guide pratique, parcourez des communautés actives ou découvrez d'autres façons d'utiliser Metricgram.
Guides
Blog
Lisez des guides pratiques sur la croissance, la monétisation, la modération et la gestion des communautés Telegram.
ExplorerAnnuaire des communautés
Annuaire des communautés Telegram
Parcourez des communautés Telegram actives par catégorie, langue et positionnement.
ExplorerHub de section
Solutions
Retrouvez toutes les pages de cette section en un coup d'œil.
ExplorerExplorer davantage
Outil de gestion de groupe Telegram
Analyses et métriques de groupe Telegram
Bot Telegram pour la gestion de groupe
Automatisez votre groupe Telegram
Bot d'adhésion Telegram pour communautés payantes
Bot de paiement Telegram pour groupes et canaux
Bot d'abonnement Telegram pour des revenus récurrents
Monétisation de canal Telegram simplifiée
Créez et gérez un groupe Telegram VIP
Transformez le support Telegram en intelligence compte
MCP
API
Chatbots IA Assistants