Serveur MCP Telegram : donnez à vos agents IA toute la Telegram Bot API, en toute sécurité

Pourquoi les agents IA ont besoin d'une couche Telegram

Les agents IA savent de mieux en mieux utiliser de vrais outils. Ils lisent un tableau de bord, repèrent ce qui compte et passent à l'étape suivante. Mais pour agir dans Telegram, il leur faut une passerelle : quelque chose qui transforme une phrase comme « épingle l'annonce de l'AMA et ouvre un sujet pour les questions » en appels corrects à l'API Telegram.

Cette passerelle, c'est un serveur MCP Telegram.

Le Model Context Protocol (MCP) est un standard ouvert qui permet aux clients IA comme Claude, ChatGPT, Cursor et Codex de découvrir des outils et de les appeler. Un serveur MCP Telegram expose des actions Telegram sous forme d'outils, avec des descriptions claires et des schémas d'entrée que le modèle peut suivre.

Metricgram en fait désormais tourner un pour vous, adossé au bot qui gère déjà vos groupes.

Ce qu'implique vraiment l'adaptation de la Telegram Bot API

Sur le papier, adapter la Bot API pour un agent semble simple. En pratique, il faut :

• Héberger un bot, garder son token secret et le maintenir en ligne.
• Recevoir les mises à jour via webhooks ou polling.
• Écrire une définition d'outil pour chaque endpoint que l'agent doit utiliser.
• Empêcher l'agent de publier dans des chats qu'il ne devrait jamais toucher.
• Gérer les limites de débit, les supergroupes migrés et les messages d'erreur de Telegram.
• Sécuriser les relances, pour qu'un incident réseau ponctuel ne publie pas deux fois le même message.
• Journaliser ce que l'agent a fait, au cas où il faudrait l'expliquer plus tard.

La plupart des équipes s'arrêtent à « envoyer un message », car tout le reste demande beaucoup de plomberie. Résultat : un agent qui sait parler, mais qui ne peut pas vraiment gérer une communauté.

Comment fonctionne le serveur MCP Telegram de Metricgram

Metricgram est déjà présent dans vos groupes Telegram en tant que bot administrateur (ou via votre propre bot personnalisé). Le serveur MCP permet simplement à votre client IA d'utiliser ce bot via un endpoint hébergé :

1. Connectez vos groupes à Metricgram et donnez les droits d'administrateur au bot.
2. Ajoutez l'endpoint https://metricgram.com/api/v1/mcp à votre client IA, par exemple comme connecteur personnalisé dans Claude.
3. Connectez-vous et approuvez l'accès avec OAuth. C'est tout : aucun serveur, webhook ni token à gérer. Les clients sans OAuth peuvent utiliser une clé API, avec la configuration ci-dessous.

{
  "mcpServers": {
    "metricgram": {
      "url": "https://metricgram.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Sur Claude Desktop, vous pouvez relier le même endpoint avec mcp-remote. Les extraits exacts pour chaque client se trouvent sur la page MCP de votre Manager.

Plus de 70 méthodes de la Bot API, deux façons de les appeler

Le serveur expose la Telegram Bot API en deux couches.

Des outils typés pour le quotidien

Les tâches courantes disposent d'outils dédiés aux paramètres explicites, ce qui aide les modèles à bien les utiliser :

• send_telegram_message avec sujets, réponses et boutons URL
• send_telegram_media pour les photos, vidéos, GIF, documents, audios et stickers
• send_telegram_poll pour les sondages et les quiz
• edit_telegram_message, delete_telegram_messages, react_to_telegram_message
• pin_telegram_message et forward_telegram_message
• manage_forum_topic pour créer, renommer, fermer, rouvrir ou supprimer des sujets
• get_telegram_chat et get_telegram_chat_member pour les données du chat en direct
• handle_telegram_join_request, create_telegram_invite_link et update_telegram_chat_settings

Une passerelle complète vers la Bot API

Tout le reste passe par telegram_bot_api. L'agent transmet le nom officiel d'une méthode de la Bot API et ses paramètres, par exemple setChatPermissions, banChatSenderChat, editMessageMedia, hideGeneralForumTopic ou revokeChatInviteLink. L'outil complémentaire telegram_api_methods liste toutes les méthodes autorisées pour la clé utilisée, pour que l'agent sache toujours ce qui est disponible.

Sécurité : pourquoi l'agent ne choisit jamais de chat_id

La décision de conception la plus importante concerne ce que l'agent ne peut pas faire.

• Le chat est verrouillé. L'agent transmet un group_id Metricgram. Le serveur en déduit le chat_id Telegram à partir d'un groupe qui vous appartient et rejette tout autre chat.
• Les transferts et citations sont vérifiés. Un message ne peut être transféré, copié ou cité que depuis vos propres groupes.
• Les actions globales du bot sont exclues. Webhooks, paiements, modification du profil du bot et sortie d'un groupe ne sont pas exposés.
• Les boutons sont sûrs. Les boutons inline peuvent ouvrir des URL ou copier du texte, mais pas déclencher de callbacks vers le bot.
• Les scopes suivent le niveau de confiance. telegram:read, telegram:write, telegram:moderate et telegram:admin sont distincts, et vous pouvez garder plusieurs clés aux pouvoirs différents.
• Les relances sont idempotentes. Les outils d'écriture acceptent une idempotency_key : un appel relancé renvoie le premier résultat au lieu d'agir deux fois.
• Chaque appel est journalisé avec l'outil et la méthode de la Bot API utilisés.

L'agent agit en tant que bot via la Bot API officielle, jamais en tant que votre compte Telegram personnel.

Un contexte qu'un bot classique n'a pas

Un simple wrapper de la Bot API peut agir, mais il voit peu de choses. Le serveur MCP de Metricgram expose aussi l'intelligence de votre communauté :

• Vue d'ensemble des analytics et séries temporelles d'activité
• Membres actifs, historique des membres et messages capturés
• Classements et récompenses de gamification
• Résumés IA de ce qui s'est passé dans le groupe
• Santé des abonnés Stripe et renouvellements à risque

Un agent peut donc répondre à « qui a cessé de participer ce mois-ci ? » puis leur envoyer un message attentionné, le tout dans la même conversation.

Exemples de workflows

Annonce hebdomadaire. « Publie l'annonce hebdomadaire de l'AMA dans Crypto Talk, épingle-la sans notifier tout le monde, ouvre un sujet de questions pour l'AMA et crée un lien d'invitation qui expire vendredi. »

Passe de modération. « Vérifie les 200 derniers messages à la recherche de liens de spam, supprime-les et restreins leurs auteurs pendant 24 heures. »

Rapport de communauté. « Compare l'activité de cette semaine à celle de la semaine dernière, liste les cinq membres les plus actifs et publie un court message de remerciement dans le sujet Général. »

Tri des demandes d'adhésion. « Approuve les demandes d'adhésion en attente des utilisateurs qui sont abonnés actifs et refuse les autres. »

Pour qui

• Les propriétaires de communautés qui veulent un assistant pour le travail d'administration courant.
• Les agences qui gèrent de nombreux groupes clients et veulent un seul agent pour tous.
• Les équipes support et customer success qui animent des communautés clients sur Telegram.
• Les développeurs qui veulent intégrer Telegram à leur stack d'agents sans gérer d'infrastructure de bots.

Bien démarrer

Le serveur MCP est inclus dans tous les forfaits Metricgram et dans l'essai gratuit de 14 jours : vous pouvez donc connecter un agent avant de payer. La plupart des clients se connectent avec OAuth : collez l'URL du serveur, connectez-vous et approuvez l'accès. Les clés API restent disponibles pour les clients sans OAuth.

Pour aller plus loin, consultez la page du serveur MCP Telegram et la présentation des fonctionnalités MCP, puis créez votre première clé depuis le Manager.