Connecter Telegram à Gemini

Configuration prête à coller

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

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

FAQ Gemini + Telegram