← Tous les connecteurs MCP Telegram

Gemini · Google

Connecter Telegram à Gemini

Utilisez Entergram comme serveur MCP Telegram pour Google Gemini et le Gemini CLI : donnez à Gemini un accès sécurisé et limité par OAuth à vos vraies conversations Telegram pour faire remonter les messages manqués, les clients en attente et les prospects refroidis.

URL du serveur MCP https://mcp.entergram.com/mcp

Le Gemini CLI et les outils Gemini compatibles MCP peuvent se connecter à des serveurs MCP externes. Entergram expose votre compte Telegram personnel sous la forme d’un serveur MCP hébergé : Gemini lit vos vraies conversations et agit dessus avec une sécurité OAuth, sans bot, sans code, sans clés API.

Configuration prête à coller

~/.gemini/settings.json
{
  "mcpServers": {
    "entergram": {
      "httpUrl": "https://mcp.entergram.com/mcp"
    }
  }
}

Posez à Gemini des questions impossibles à poser à Telegram

Avec votre compte personnel connecté, Gemini peut analyser toutes vos conversations d’un seul coup. Essayez des requêtes comme :

  • « Combien de messages ai-je manqués cette semaine, et lesquels viennent de clients ? »
  • « À quelles conversations j’oublie de répondre ? »
  • « Chiffre les prospects qui se sont refroidis faute de relance. »
  • « Résume les retours que mes clients m’ont faits le mois dernier. »
  • « Trouve toutes les questions restées sans réponse dans mes conversations. »
  • « Rédige des réponses à mes plus anciens messages sans réponse, pour relecture. »

Connectez Gemini en 3 étapes

Compatible avec le Gemini CLI et les clients Gemini compatibles MCP.

  1. 01

    Copiez votre URL MCP dans Entergram

    Dans Entergram, ouvrez Settings → Workspace → Connectors → MCP et copiez l’URL de votre serveur MCP.

  2. 02

    Enregistrez le serveur MCP auprès de Gemini

    Ajoutez Entergram à la configuration MCP de votre Gemini CLI avec l’URL : https://mcp.entergram.com/mcp.

  3. 03

    Autorisez et lancez-vous

    Cliquez sur Connect, connectez-vous avec votre compte Entergram et cliquez sur Allow access. Gemini peut alors interroger votre compte Telegram et agir dessus.

Où déclarer le serveur

Gemini CLI, portée utilisateur

La voie principale, et ce que la plupart des gens entendent par Gemini MCP. Ajoutez le serveur dans ~/.gemini/settings.json sous mcpServers, avec httpUrl pointant vers le point d’accès hébergé, redémarrez la CLI, et les outils sont disponibles dans tous vos projets sur cette machine. Comme il s’agit d’un serveur HTTPS distant, il n’y a ni enveloppe npx ni passerelle stdio à maintenir en vie.

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

Gemini CLI, portée projet

Le même bloc placé dans .gemini/settings.json à l’intérieur d’un dépôt ne s’applique qu’à ce dépôt. Pratique quand un seul projet sert de chaîne de déploiement et annonce les mises en production dans un canal Telegram, alors que le reste de votre travail n’a rien à faire dans vos conversations — et cela garde la configuration sous gestion de version, là où un collègue peut la lire.

mkdir -p .gemini && $EDITOR .gemini/settings.json

N’importe quel client qui pilote un modèle Gemini

Le point d’accès est indifférent au modèle. Un agent intégré à un éditeur, un harnais scripté ou un outil maison propulsé par Gemini déclare Entergram selon le format attendu par sa propre configuration MCP et reçoit exactement la même liste d’outils. L’écran de consentement appartient à Entergram : celui qui lance le client s’autorise en son nom propre au lieu d’hériter de l’autorisation de quelqu’un d’autre.

Des tâches de terminal qui méritent d’être branchées

Dans la CLI, ce sont des invocations d’une ligne que vous pouvez placer derrière un alias shell ou un hook git. Chaque demande en langage courant se développe en une séquence d’appels d’outils, et la CLI affiche ceux qu’elle a effectués — vous pouvez donc observer la mécanique avant de lui confier une écriture. Tout ce qui suit suppose le serveur déclaré et autorisé une seule fois ; après quoi il ne reste qu’à taper.

Vous demandez

« Publie les notes de version de CHANGELOG.md dans le canal bêta. »

Outils appelés

entergram_list_accountsentergram_list_groupsentergram_send_message

Vous obtenez

L’étape post-déploiement que personne ne retient. Gemini a déjà le changelog en contexte depuis le dépôt, choisit le compte qui administre le canal, retrouve celui-ci par son nom et publie. Accrochez-la à un build réussi et l’annonce cesse de dépendre de la mémoire de quelqu’un.

Vous demandez

« Qui est dans le canal bêta sans avoir jamais été marqué comme client payant ? »

Outils appelés

entergram_list_group_membersentergram_list_contactsentergram_get_chat_custom_fields

Vous obtenez

Une différence d’ensembles entre deux systèmes qui vivent d’ordinaire dans deux onglets distincts. Il énumère les membres du canal, les rapproche de votre liste de contacts, puis lit les champs CRM pour voir qui porte l’étiquette client. Ce qui revient, c’est la moitié non convertie de votre communauté, nommément.

Vous demandez

« Envoie la sortie des tests en échec dans le fil Acme avec une courte explication. »

Outils appelés

entergram_list_chatsentergram_send_media_message

Vous obtenez

Le fichier est déjà sur le disque, juste à côté de vous, ce qui évite tout le ballet de l’envoi manuel. Gemini attache l’artefact et rédige lui-même la phrase d’accompagnement — la différence entre un client qui voit un mur de trace d’exécution et un client qui comprend ce qui a cassé et quand ce sera réparé.

Vous demandez

« Crée un canal de lancement, nomme-le correctement et ajoute l’équipe de release. »

Outils appelés

entergram_create_channelentergram_update_chat_infoentergram_invite_chat_members

Vous obtenez

Trois étapes dans l’interface de Telegram se réduisent à une phrase. Le canal est créé, le titre et la description sont renseignés à partir de votre description, et la liste d’invitations est résolue depuis vos contacts. Celle-ci exige un connecteur d’espace de travail : l’administration des groupes ne fait pas partie des permissions d’un agent personnel.

Vous demandez

« J’ai mis le mauvais numéro de version dans cette annonce, corrige-la. »

Outils appelés

entergram_list_messagesentergram_edit_message

Vous obtenez

Il relit l’historique récent pour identifier le message dont vous parlez, puis le modifie sur place au lieu de publier un correctif en dessous. Telegram laisse le message où il était : personne parmi ceux qui l’ont déjà lu n’est notifié à nouveau, et l’historique du canal reste propre.

Vous demandez

« Donne-moi le nombre de tickets de la semaine par assigné, au format TSV. »

Outils appelés

entergram_list_ticketsentergram_list_ticket_custom_columnsentergram_list_members

Vous obtenez

Le formatage de la sortie, c’est là qu’un client en terminal justifie son existence. Il récupère la file, résout les colonnes de catégorie et de gravité vers leurs vraies valeurs d’option, associe les identifiants d’assigné à des noms humains et imprime des lignes séparées par des tabulations, directement injectables dans un tableur ou un script de graphique. Du reporting ad hoc, sans que personne ait eu à construire un rapport au préalable.

Ce que Gemini peut faire avec votre Telegram

  • Lire et résumer vos conversations Telegram
  • Faire remonter les messages manqués et les réponses en retard
  • Retrouver vos contacts et leurs champs CRM personnalisés
  • Envoyer des messages et des réponses après validation
  • Chiffrer les opportunités manquées et les retours
  • Créer et mettre à jour des tickets de support

La surface d’outils dans la CLI

Listez les serveurs MCP déclarés après la connexion et les 70 outils apparaissent sous entergram, regroupés comme ci-dessous. Les noms d’outils sont des identifiants littéraux, ce qui compte davantage dans un terminal que dans une fenêtre de conversation : vous pouvez nommer un appel directement dans une requête quand vous voulez un comportement déterministe au lieu de laisser le modèle choisir son itinéraire. La CLI affiche chaque appel et ses arguments au fil de l’exécution, ce qui rend une liste d’outils inconnue rapide à apprivoiser.

Comptes et espace de travail

5 outils

Découverte de l’identité et du périmètre. Tout appel de messagerie exige d’abord un account_id issu de list_accounts : un client IA qui saute cette étape s’adressera au mauvais compte Telegram.

  • entergram_get_me
  • entergram_list_accounts
  • entergram_get_workspace
  • entergram_get_member
  • entergram_list_members

Conversations et découverte

8 outils

Pour retrouver les conversations. Les vues de l’espace de travail portent l’état CRM (tickets, commentaires, champs personnalisés) ; les vues en direct portent l’état de transport Telegram actuel et les compteurs de non-lus.

  • entergram_list_chats
  • entergram_get_chat
  • entergram_list_live_chats
  • entergram_get_live_chat
  • entergram_list_workspace_chats
  • entergram_get_workspace_chat
  • entergram_update_workspace_chat
  • entergram_get_chat_management

Messages

9 outils

Lecture et écriture de l’historique des messages, y compris les modifications, les transferts et les réactions. L’envoi est limité à un compte : rien n’est global entre vos comptes connectés.

  • entergram_list_messages
  • entergram_get_message
  • entergram_send_message
  • entergram_send_media_message
  • entergram_edit_message
  • entergram_delete_message
  • entergram_forward_messages
  • entergram_get_message_reactions
  • entergram_set_message_reactions

Contacts

3 outils

À qui vous parlez, et où vous vous croisez ailleurs. La recherche de groupes partagés est ce qui rend possible des questions comme « lesquels de mes prospects sont dans la même communauté ? ».

  • entergram_list_contacts
  • entergram_get_contact
  • entergram_list_contact_shared_groups

Tickets

10 outils

Contrôle complet du support : ouvrir, attribuer, prioriser, commenter et clore. Chaque ticket renvoie à la conversation dont il est issu, si bien qu’un client IA passe de l’échange à la file d’attente en une seule étape.

  • entergram_list_tickets
  • entergram_get_ticket
  • entergram_create_ticket
  • entergram_update_ticket
  • entergram_delete_ticket
  • entergram_list_chat_tickets
  • entergram_list_ticket_comments
  • entergram_create_ticket_comment
  • entergram_update_ticket_comment
  • entergram_delete_ticket_comment

Champs CRM personnalisés

11 outils

Le schéma de votre pipeline. Lisez les colonnes avant d’écrire des valeurs : les cases à cocher attendent des booléens, les listes à choix multiples des tableaux de valeurs d’option, les dates des chaînes ISO 8601.

  • entergram_list_custom_columns
  • entergram_get_custom_column
  • entergram_create_custom_column
  • entergram_update_custom_column
  • entergram_delete_custom_column
  • entergram_list_custom_column_options
  • entergram_create_custom_column_option
  • entergram_update_custom_column_option
  • entergram_delete_custom_column_option
  • entergram_get_chat_custom_fields
  • entergram_patch_chat_custom_fields

Champs de ticket personnalisés

9 outils

Le même contrôle de schéma côté tickets : catégories, niveaux de gravité, paliers de SLA et tout ce que votre support suit au-delà du statut et de la priorité.

  • entergram_list_ticket_custom_columns
  • entergram_get_ticket_custom_column
  • entergram_create_ticket_custom_column
  • entergram_update_ticket_custom_column
  • entergram_delete_ticket_custom_column
  • entergram_list_ticket_custom_column_options
  • entergram_create_ticket_custom_column_option
  • entergram_update_ticket_custom_column_option
  • entergram_delete_ticket_custom_column_option

Notes internes

4 outils

Des commentaires sur une conversation que votre client ne voit jamais. Pratique pour qu’un client IA laisse son raisonnement à un collègue humain qui prendra la suite.

  • entergram_list_chat_comments
  • entergram_create_chat_comment
  • entergram_update_chat_comment
  • entergram_delete_chat_comment

Groupes et canaux

11 outils

Créer et administrer des groupes et canaux Telegram — membres, permissions, confidentialité et informations — plus une commande brute en dernier recours pour tout le reste.

  • entergram_list_groups
  • entergram_get_group
  • entergram_list_group_members
  • entergram_create_group_chat
  • entergram_create_channel
  • entergram_invite_chat_members
  • entergram_remove_chat_member
  • entergram_update_chat_info
  • entergram_update_chat_permissions
  • entergram_update_chat_privacy
  • entergram_run_chat_command

Le consentement, machine par machine

Rien dans settings.json n’est un secret. Le fichier indique seulement à la CLI où se trouve le serveur ; l’accès, lui, vient d’une connexion OAuth réalisée dans un navigateur, et le jeton obtenu vous appartient plutôt qu’au dépôt. Google ne reçoit à aucun moment d’identifiants Telegram : le numéro et la session restent à l’intérieur d’Entergram. Deux ensembles de permissions existent, et celui dont vous avez besoin dépend de la capacité d’écriture attendue de la CLI.

Permissions de l’agent personnel
N’importe quel membre peut en générer un sans passer par un administrateur. Il couvre la lecture de l’espace de travail, des comptes connectés, des contacts, des conversations, des messages et des tickets, plus l’écriture de valeurs de champs personnalisés sur vos propres conversations. Suffisant pour toutes les analyses et tous les exports de cette page ; insuffisant pour envoyer un message.
Permissions du connecteur d’espace de travail
Réservé aux propriétaires et administrateurs, et c’est ce dont une automatisation a réellement besoin. Il ajoute l’envoi, les médias, les modifications, les écritures de tickets, les écritures de champs personnalisés dans tout l’espace de travail et l’administration des groupes Telegram. Comme il est partagé et non personnel, traitez la machine sur laquelle vous l’autorisez avec le même soin.
Couper la connexion
Supprimer l’entrée mcpServers empêche la CLI d’appeler le serveur, mais n’invalide rien. Pour réellement couper l’accès, révoquez le client côté Entergram sous Settings → Workspace → Connectors → MCP — l’effet est immédiat, sur toutes les machines qui l’utilisaient.

Des contraintes à intégrer dès la conception

La plupart ne se manifestent qu’au moment où vous tentez de faire tourner la CLI sans surveillance.

  • Déclarer le serveur n’est pas l’autoriser. Chaque machine passe par l’écran de consentement pour son propre compte la première fois : un portable neuf ou un conteneur reconstruit a besoin d’un navigateur au moins une fois.
  • L’espace de travail Entergram doit être sur l’offre Pro. La CLI listera volontiers le serveur avant de collecter des refus sur chaque appel si le niveau est inférieur, ce qui ressemble à une configuration cassée sans en être une.
  • Il n’existe aucun compte implicite. Les outils de message exigent un account_id explicite, donc tout script doit d’abord résoudre la liste des comptes — à peine perceptible dans une conversation, une chose de plus à retenir dans une chaîne. Résolvez-le une fois en tête de script et propagez-le.
  • Un agent personnel ne peut ni envoyer ni administrer de groupes. Les automatisations qui publient des notes de version ou créent des canaux exigent un connecteur d’espace de travail autorisé par un propriétaire ou un administrateur.
  • Le protocole fonctionne en requête-réponse, pas en abonnement. Rien n’arrive dans votre terminal sans y avoir été invité ; Gemini n’apprend l’existence d’un nouveau message que si quelque chose lui dit d’aller voir. Tout ce qui ressemble à de la surveillance doit être une tâche planifiée dont vous êtes propriétaire.
  • La CLI n’élève aucun privilège. Elle voit exactement les conversations que voit votre propre compte Telegram, et un groupe que vous avez quitté est un groupe qu’elle ne peut pas lire.

Problèmes de CLI et leurs causes

Le serveur n’apparaît jamais dans la liste MCP
Presque toujours du JSON mal formé — une seule virgule superflue et la CLI abandonne silencieusement tout le fichier de configuration. Validez-le, vérifiez que la clé est bien httpUrl pour un serveur HTTPS distant et non une entrée stdio à base de commande et d’arguments, et assurez-vous que l’entrée se trouve réellement dans mcpServers.
Les modifications de settings.json semblent sans effet
La configuration est lue au démarrage. Quittez complètement la session et relancez-la ; un processus en cours continue de servir la liste d’outils construite à son lancement, si bien que le fichier peut être correct tout en paraissant ignoré.
OAuth n’aboutit pas sur une machine sans interface graphique
L’écran de consentement réclame un navigateur. Autorisez depuis un poste de travail que vous pouvez voir, ou faites suivre le port de rappel par SSH — un agent de build sans affichage ne peut pas terminer la poignée de main tout seul.
Ça marche dans un répertoire et pas dans un autre
Vous avez deux fichiers de configuration. Celui sous ~/.gemini s’applique partout, celui sous .gemini à l’intérieur d’un dépôt seulement à ce dépôt. Vérifiez lequel contient vraiment l’entrée entergram avant de modifier quoi que ce soit d’autre.
Chaque appel renvoie 403
Vérifiez d’abord l’offre, ensuite le rôle. L’accès MCP exige l’offre Pro, et tout ce qui dépasse les permissions de l’agent personnel exige les droits propriétaire ou administrateur sur l’espace de travail Entergram.
Les lectures passent mais les envois sont refusés
C’est la frontière de l’agent personnel qui se manifeste, pas une erreur passagère. L’envoi est totalement absent de son ensemble de permissions : réessayer n’y changera rien. Un propriétaire ou un administrateur doit autoriser un connecteur d’espace de travail, et vous relancez le consentement contre celui-ci.

FAQ Gemini + Telegram

Est-ce que cela fonctionne avec le Gemini CLI ?
Oui. Le Gemini CLI prend en charge les serveurs MCP : enregistrez l’URL MCP d’Entergram dans votre configuration MCP et autorisez via OAuth.
Est-ce un bot Telegram ?
Non. Entergram connecte votre véritable compte Telegram personnel via un serveur MCP hébergé : Gemini travaille avec vos vraies conversations.
Gemini peut-il me dire ce que j’ai manqué ?
Oui. Il peut lire l’ensemble de vos conversations connectées, compter les messages non lus et sans réponse, et mettre en avant ceux qui viennent de clients et de prospects.
Est-ce sécurisé ?
Oui. La connexion utilise OAuth 2.0 avec des permissions limitées ; vous décidez de ce à quoi Gemini peut accéder et pouvez le révoquer à tout moment.