← Tous les connecteurs MCP Telegram

opencode · SST

Connecter Telegram à opencode

Ajoutez Entergram comme serveur MCP dans opencode, l’agent IA de terminal open source de SST, et laissez-le travailler sur votre véritable compte Telegram : faire remonter les messages manqués, relancer les prospects refroidis et agir sur vos conversations depuis la ligne de commande.

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

opencode charge ses serveurs MCP depuis son fichier de configuration. Déclarez celui d’Entergram comme serveur MCP distant et l’agent open source de SST peut exploiter votre compte Telegram personnel dans le terminal — permissions limitées par OAuth, sans compte bot et sans clés API.

Configuration prête à coller

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "entergram": {
      "type": "remote",
      "url": "https://mcp.entergram.com/mcp",
      "enabled": true
    }
  }
}

Posez à opencode des questions impossibles à poser à Telegram

Une fois votre compte personnel connecté, opencode peut agir sur toutes vos conversations depuis le terminal. Essayez des prompts comme :

  • « Ouvre un canal d’incident et fais-y entrer les personnes d’astreinte. »
  • « Publie le résumé du déploiement dans le canal des mises à jour clients. »
  • « Combien de tickets sont encore ouverts avant que je crée la version ? »
  • « Trouve les conversations qui mentionnent la migration et résume les inquiétudes. »
  • « Ajoute une note à ce fil avec le plan de retour arrière. »
  • « Qui, dans le groupe bêta, n’a pas répondu à l’avis de mise à niveau ? »

Connecter opencode en 3 étapes

Compatible avec la TUI et la CLI d’opencode.

  1. 01

    Copiez votre URL MCP dans Entergram

    Dans Entergram, ouvrez Settings → Workspace → Connectors → MCP et copiez l’URL de votre serveur MCP. opencode la lit dans opencode.json : vous la collerez donc dans un fichier plutôt que dans une invite.

  2. 02

    Ajoutez le serveur dans opencode.json

    Dans votre opencode.json, déclarez Entergram sous la clé mcp comme serveur distant pointant vers l’URL MCP d’Entergram : https://mcp.entergram.com/mcp.

  3. 03

    Autorisez et lancez-vous

    Démarrez opencode, connectez-vous avec votre compte Entergram et cliquez sur Allow access pour accorder un accès limité. opencode peut alors lire votre compte Telegram et agir dessus au fil de ses sessions.

Global, par projet, ou sans interface

Global — ~/.config/opencode/opencode.json

Une seule entrée qui vous suit dans tous les dépôts que vous ouvrez. C’est le bon endroit pour une autorisation personnelle : le serveur est disponible que vous soyez dans un projet professionnel ou dans un projet du week-end, et vous n’autorisez qu’une fois au lieu d’une fois par dépôt.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "entergram": {
      "type": "remote",
      "url": "https://mcp.entergram.com/mcp",
      "enabled": true
    }
  }
}

Par projet — opencode.json à la racine du dépôt

Versionné à côté du code, si bien que toute personne qui clone le dépôt obtient le serveur déclaré sans qu’on ait à le lui dire. Rien de secret n’est partagé — le fichier nomme un point d’accès et rien d’autre, et chaque collègue effectue quand même sa propre connexion avec ses propres permissions. La configuration de projet se superpose au fichier global : gardez une seule définition plutôt que deux qui se concurrencent.

Sans interface — opencode run

La raison même pour laquelle ce connecteur convient à un agent de terminal. Une seule invocation non interactive s’insère dans un script de déploiement, une cible de Makefile ou une étape de CI — et c’est ainsi qu’une notification de mise en production cesse de dépendre de quelqu’un qui pense à l’envoyer.

opencode run "post the release summary for v2.14 in the customer channel"

Livrer, depuis le même shell

Un agent de terminal sert précisément aux moments où ouvrir une application de messagerie casserait la concentration : juste après un déploiement, en plein incident, ou en fin de journée quand vous voulez savoir ce qui reste ouvert. Ces exécutions supposent ce contexte — des requêtes courtes, le clavier seul, et le connecteur qui fait la part que vous repousseriez sinon jusqu’à ce qu’elle n’ait plus d’importance. Chacune se traduit par une poignée d’appels nommés qui s’affichent dans le journal de session, ce qui les rend aussi faciles à reprendre telles quelles dans un script une fois que vous les avez vues fonctionner à la main.

Vous demandez

« Le déploiement est terminé. Publie la version et le lien du changelog dans le canal de release. »

Outils appelés

entergram_list_accountsentergram_list_groupsentergram_send_message

Vous obtenez

L’annonce part du shell même qui a lancé le déploiement, quelques secondes après sa réussite plutôt qu’une heure plus tard. L’agent détermine quel compte connecté peut publier, retrouve le canal par son nom pour que l’identifiant n’ait jamais à figurer dans votre script, et envoie. Branchez-le sur la cible de déploiement et l’étape cesse d’être facultative.

Vous demandez

« J’ai mis le mauvais numéro de build dans cette annonce — corrige-la sur place. »

Outils appelés

entergram_list_messagesentergram_get_messageentergram_edit_message

Vous obtenez

Corriger l’original vaut mieux que publier un rectificatif en dessous. L’agent remonte l’historique récent pour identifier le message, vérifie son contenu avant d’y toucher, et le modifie : celui qui fera défiler le fil demain lira le bon numéro au lieu d’une suite d’amendements.

Vous demandez

« Ouvre une salle d’incident pour ça et fais-y entrer les personnes d’astreinte. »

Outils appelés

entergram_create_group_chatentergram_list_membersentergram_invite_chat_members

Vous obtenez

Trente secondes de mise en place que personne n’a envie de faire pendant qu’un système est à terre. Un groupe est créé, l’annuaire de l’espace de travail est lu pour identifier les personnes que vous avez nommées, et les invitations partent. Vous retournez aux journaux avec la coordination déjà réglée plutôt qu’à moitié entamée.

Vous demandez

« Transfère l’avis de maintenance de vendredi à tous les groupes clients qui ne l’ont pas vu. »

Outils appelés

entergram_list_groupsentergram_list_messagesentergram_forward_messages

Vous obtenez

Transférer l’original garantit que chaque groupe lit exactement la même formulation, ce qui est précisément ce qu’on veut pour une fenêtre de maintenance et précisément ce que la resaisie détruit. L’agent vérifie quels groupes l’ont déjà reçu avant de diffuser, pour que personne ne reçoive deux fois le même avis.

Vous demandez

« Cette personne qui a signalé le bug est dans certaines de nos communautés — lesquelles, et qui d’autre de notre liste s’y trouve ? »

Outils appelés

entergram_list_contactsentergram_get_contactentergram_list_contact_shared_groups

Vous obtenez

La recherche de groupes partagés répond à une question que Telegram lui-même refuse de traiter : où se situe réellement votre recoupement avec quelqu’un. Utile quand un signalement de bug demande de savoir à quel point la personne risque de faire du bruit, et utile encore quand vous décidez si un contournement peut être publié une fois dans une communauté partagée plutôt que répété à la main dans dix fils privés.

Vous demandez

« Avant que je crée la version, combien de tickets ouverts sont rattachés à ce jalon ? »

Outils appelés

entergram_list_ticket_custom_columnsentergram_list_ticketsentergram_get_ticket

Vous obtenez

Un contrôle de préparation de version qui tient en une ligne et sans tableau de bord. L’agent lit le schéma de vos tickets pour trouver la colonne de jalon, filtre les tickets ouverts dessus, et rapporte le nombre avec les titres. Placez-le en première étape de votre script de release et un ticket bloquant arrête la création de tag au lieu d’apparaître après.

Ce qu’opencode peut faire avec votre Telegram

  • Piloter Telegram entièrement au clavier
  • Annoncer un déploiement dans un canal client juste après la livraison
  • Ouvrir un canal d’incident et y inviter les intervenants
  • Compter les tickets ouverts avant de créer une version
  • Se configurer globalement ou par projet via opencode.json
  • S’exécuter en mode non interactif pour des tâches scriptées

Soixante-dix outils, rien d’installé en local

C’est Entergram qui héberge le serveur : opencode récupère donc neuf groupes d’outils sans la moindre dépendance ajoutée à votre machine ou à votre image de CI — pas de processus passerelle, pas d’environnement Python, aucun identifiant dans le dépôt. Tout ce qui suit est atteignable dès que l’autorisation existe, dans les limites du niveau d’accès choisi, et la même liste est disponible pour une session interactive comme pour une exécution unique.

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

La sécurité côté terminal, en un paragraphe

Rien de sensible n’atterrit dans vos dotfiles. opencode.json porte une URL et un indicateur ; l’élément d’authentification, lui, est conservé dans le stockage d’authentification propre à opencode après une connexion en navigateur, et votre session Telegram reste à l’intérieur d’Entergram, où ni SST ni le fournisseur de modèle ne la voient. Si une machine disparaît ou qu’un exécuteur de CI est mis hors service, supprimez l’autorisation depuis Entergram sous Settings → Workspace → Connectors → MCP et toutes les sessions de cette machine perdent l’accès dès leur appel suivant.

Agent personnel
La valeur par défaut pour le terminal d’un développeur, disponible à chaque membre sans étape d’approbation. La lecture couvre la fiche de l’espace de travail, vos comptes connectés, les contacts, les conversations, l’historique des messages et la file de tickets ; l’écriture se limite aux champs personnalisés des conversations rattachées à vos propres comptes. C’est suffisant pour le tri, les récapitulatifs et les contrôles de préparation de version, et délibérément en deçà de tout ce qui parle à un client.
Connecteur d’espace de travail
Créé par un propriétaire ou un administrateur, il détient toutes les permissions définies par le serveur : envoi, modification, transfert, écritures sur les tickets, écritures de champs personnalisés partout dans l’espace de travail, et administration des groupes. C’est le niveau exigé par un script de déploiement s’il doit publier dans un canal client sans humain dans la boucle.
Révocation
Immédiate, et délibérément unilatérale. Vous n’avez pas besoin d’accéder à la machine qui exécute opencode pour couper l’accès : révoquer dans Entergram invalide l’autorisation où qu’elle soit stockée, ce qui est tout l’intérêt quand l’exécuteur est une machine de CI plutôt qu’un portable posé sur votre bureau.

Les contraintes d’un connecteur natif du terminal

La plupart concernent l’écart entre une session interactive et une session automatisée, écart qu’un agent de terminal passe sa vie à enjamber. Aucune n’est bloquante ; toutes coûtent moins cher à apprendre ici que dans une chaîne de production.

  • La première autorisation exige un navigateur. Une invocation scriptée ne peut pas franchir un écran de consentement : autorisez une fois en session interactive et laissez l’autorisation enregistrée porter les exécutions suivantes.
  • Un opencode.json versionné partage l’adresse, pas l’accès. Les collègues qui récupèrent le dépôt passent chacun par leur propre connexion, et leur jeton porte leurs permissions plutôt que les vôtres.
  • Il n’y a aucun ordonnanceur de notre côté. opencode se termine à la fin de l’exécution : tout ce qui est récurrent — un récapitulatif nocturne, un avis post-déploiement — relève de votre entrée cron ou de votre étape de pipeline, jamais de quelque chose qu’Entergram déclencherait seul.
  • MCP fait partie de l’offre Pro. Sur tout niveau inférieur, le serveur répond quand même à la poignée de main, ce qui fait ressembler la panne à un bug de configuration alors qu’il s’agit d’une question de facturation.
  • Les écritures supposent que la colonne existe déjà. L’agent peut remplir un champ de suivi de version sur une conversation, mais créer ce champ est une action de connecteur d’espace de travail, et une autorisation personnelle ne le fera pas.
  • L’adressage par compte est obligatoire. Les habitudes de terminal supposent une valeur par défaut sensée, et il n’y en a pas : nommez le compte dans la requête, sinon l’agent le résoudra lui-même depuis la liste des comptes.

Dépannage du connecteur opencode

opencode démarre mais ne liste aucun outil Entergram
Vérifiez que l’entrée se trouve bien dans le bloc mcp, avec type réglé sur remote et enabled sur true — une entrée à laquelle il manque l’un ou l’autre est analysée puis ignorée sans commentaire. La configuration est lue au démarrage : redémarrez donc la session après l’avoir modifiée.
opencode refuse de démarrer après la modification
Conservez la ligne $schema et passez le fichier dans un analyseur JSON. Une virgule superflue en est la cause habituelle, et l’erreur de démarrage a tendance à nommer le fichier plutôt que la ligne fautive.
Une exécution scriptée se bloque à l’autorisation
Les exécutions non interactives ne peuvent pas ouvrir d’écran de consentement. Lancez opencode une fois en interactif, terminez la connexion Entergram, et l’autorisation enregistrée portera ensuite les exécutions scriptées.
Ce n’est pas la bonne configuration qui s’applique
Un opencode.json de projet se superpose au fichier global de ~/.config/opencode/. Si un collègue a versionné une entrée, c’est la sienne qui est utilisée — réconciliez les deux plutôt que d’ajouter un second serveur sous un autre nom.
Les messages arrivent au mauvais endroit
Nommez à la fois le compte et la conversation cible dans la requête. entergram_list_accounts résout le premier, mais rien dans une session de terminal n’implique une valeur par défaut, et une exécution unique ne s’arrêtera pas pour vous le demander.
Les appels ont commencé à échouer au bout de quelques jours
Les jetons expirent. Lancez opencode en interactif et réapprouvez l’accès — le fichier de configuration ne change pas, seule l’autorisation derrière lui.

FAQ opencode + Telegram

Comment opencode se connecte-t-il aux serveurs MCP ?
opencode lit ses serveurs MCP dans son fichier de configuration. Ajoutez Entergram comme serveur distant avec l’URL MCP et autorisez via OAuth.
Est-ce un bot Telegram ?
Non. Il n’y a aucun token de bot dans cette configuration : le serveur MCP hébergé agit comme votre propre compte Telegram, ce qui lui permet de lire un historique qu’un bot ne verrait jamais.
Est-ce sécurisé ?
Oui. OAuth 2.0 avec des permissions limitées ; vous décidez de ce à quoi opencode peut accéder et pouvez révoquer l’accès à tout moment.
opencode peut-il enchaîner plusieurs actions Telegram ?
Oui. En tant qu’agent de terminal autonome, opencode peut enchaîner les étapes en une seule exécution — lire les conversations sans réponse, rédiger des réponses et ouvrir des tickets — en s’arrêtant pour votre approbation avant tout envoi.