Comment connecter Google Gemini à vos chats Telegram

Pour connecter Google Gemini à vos chats Telegram, enregistrez le serveur MCP hébergé d'Entergram, https://mcp.entergram.com/mcp, dans la Gemini CLI, puis connectez-vous une fois à Entergram dans votre navigateur. Gemini peut ensuite lire vos chats, vos contacts et vos données CRM via votre vrai compte Telegram personnel, et agir dessus dans la limite des autorisations accordées. La configuration tient en trois étapes et un petit bloc JSON, présentés ci-dessous.

La Gemini CLI est le chemin que la page Gemini Telegram MCP documente en détail. Tout autre client compatible MCP qui fait tourner un modèle Gemini peut utiliser la même URL, enregistrée de la manière propre à ce client.

• Un espace de travail Pro. API et MCP sont une fonctionnalité du plan Pro. Sur un plan inférieur, la CLI listera quand même le serveur, puis chaque appel sera refusé : cela ressemble à une configuration cassée, mais ce n'en est pas une.
• Au moins un compte Telegram connecté sur votre siège. Un connecteur personnel ne peut utiliser que les comptes Telegram listés sous Paramètres → Comptes pour votre propre membre.
• Un navigateur sur la machine pour la première connexion. L'écran de consentement en a besoin, donc un serveur sans interface doit d'abord être autorisé depuis un poste de travail.

Étape 1 : copiez votre URL MCP dans Entergram

Allez dans Paramètres → Espace de travail → Connecteurs → MCP et copiez l'URL du serveur MCP. Elle est identique pour tous les clients :

https://mcp.entergram.com/mcp

Étape 2 : enregistrez le serveur dans la Gemini CLI

Ajoutez Entergram sous mcpServers dans ~/.gemini/settings.json. Comme le serveur est distant en HTTPS, la clé est httpUrl, et non une entrée de type commande et arguments :

{
  "mcpServers": {
    "entergram": {
      "httpUrl": "https://mcp.entergram.com/mcp"
    }
  }
}

Le fichier de votre répertoire personnel s'applique à tous les projets de la machine. Pour limiter l'accès à Telegram à un seul dépôt, placez plutôt le même bloc dans .gemini/settings.json à l'intérieur de ce dépôt.

Étape 3 : relancez la CLI et autorisez

La CLI lit sa configuration au démarrage : quittez complètement la session et relancez-la. Connectez-vous à Entergram dans la fenêtre de navigateur qui s'ouvre et accordez les portées que vous voulez donner à Gemini. Rien dans settings.json n'est un identifiant : le fichier indique seulement où se trouve le serveur, et l'accès vient de cette connexion OAuth.

Une fois l'autorisation faite, listez les serveurs MCP enregistrés dans la CLI : les outils Entergram apparaissent sous entergram.

Ce que Gemini peut faire dépend du type de client que vous autorisez, comme l'explique la page d'aide sur les connecteurs MCP :

Un agent personnel ne peut pas envoyer de messages Telegram. Si les lectures fonctionnent mais que les envois sont refusés, c'est la limite de portée, pas une erreur. Un propriétaire ou un administrateur doit autoriser un connecteur d'espace de travail, et vous relancez le flux de consentement sur celui-ci. Dans tous les cas, accordez le plus petit ensemble de portées nécessaire : messages.write permet à un agent d'envoyer des messages en votre nom.

Pour couper l'accès, révoquez le client dans Entergram sous Paramètres → Espace de travail → Connecteurs → MCP. Supprimer l'entrée mcpServers empêche seulement la CLI d'appeler le serveur ; cela n'invalide pas l'autorisation.

Le serveur MCP d'Entergram se connecte à votre compte Telegram personnel, pas à un bot, donc Gemini travaille avec les mêmes chats que vous. Des prompts qui fonctionnent bien dans la CLI :

• « Quels chats contiennent des questions sans réponse depuis trois jours ? »
• « Liste les contacts de mon groupe clients qui ne sont pas dans le groupe communauté. »
• « Publie les notes de version de CHANGELOG.md dans le canal bêta. » (nécessite un connecteur d'espace de travail)
• « J'ai fait une faute dans le numéro de version de cette annonce, corrige-la. » (nécessite un connecteur d'espace de travail)
• « Donne-moi le nombre de tickets de la semaine par assigné, au format TSV. »

La CLI affiche chaque appel d'outil qu'elle effectue : vous pouvez observer le fonctionnement sur une tâche en lecture seule avant de lui confier une écriture.

• Les outils de messagerie exigent un compte explicite. Il n'y a pas de compte par défaut implicite : un script doit d'abord récupérer la liste des comptes, puis transmettre l'identifiant du compte.
• Rien n'arrive sans demande. MCP fonctionne en requête et réponse. Gemini n'apprend l'existence d'un nouveau message que lorsque vous, ou une tâche planifiée qui vous appartient, lui demandez de regarder.
• Aucun accès élevé. Gemini voit exactement ce que voient vos comptes Telegram connectés. Un groupe que vous avez quitté est un groupe qu'il ne peut pas lire, et les chats exclus sous Comptes → Exclure des chats restent hors des résultats MCP.

• Le serveur n'apparaît jamais dans la liste MCP. C'est généralement un JSON mal formé : une seule virgule en trop fait ignorer tout le fichier de paramètres à la CLI. Vérifiez que l'entrée utilise httpUrl et se trouve bien dans mcpServers.
• Les modifications de settings.json semblent sans effet. Quittez complètement la session et relancez-la. Un processus en cours garde la liste d'outils construite au démarrage.
• Cela fonctionne dans un répertoire et pas dans un autre. Vous avez deux fichiers de paramètres. Vérifiez si l'entrée entergram se trouve dans ~/.gemini ou dans le dossier .gemini d'un dépôt.
• Chaque appel renvoie 403. Vérifiez d'abord le plan (MCP nécessite Pro), puis le rôle : tout ce qui dépasse les portées d'un agent personnel exige un propriétaire ou un administrateur.

Le serveur MCP d'Entergram est le même pour tous les clients. Configurez-le une fois et vous pouvez connecter le client d'IA que vous préférez, ou plusieurs :

• Connecter Claude à Telegram via Entergram
• Connecter ChatGPT à Telegram via Entergram
• Connecter n'importe quel outil d'IA au MCP Telegram

Pour la liste complète des outils Gemini, des exemples à l'échelle d'un projet et les tâches planifiées, consultez la page Gemini Telegram MCP. Pour ce que fait le serveur avec chaque client, commencez par la page du serveur MCP Telegram.