← Tous les connecteurs MCP Telegram

Cursor, Zed et Windsurf

Connecter Telegram à Cursor et aux IDE

Ajoutez Entergram comme serveur MCP dans Cursor, Zed ou Windsurf et accédez à votre véritable compte Telegram depuis votre éditeur : consultez les messages manqués et les clients qui vous attendent sans casser votre concentration.

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

Cursor, Zed et Windsurf prennent tous en charge les serveurs MCP via une configuration mcp.json. Entergram expose votre compte Telegram personnel sous la forme d’un serveur MCP hébergé : l’IA de votre éditeur agit sur vos vraies conversations avec une sécurité OAuth, sans bot, sans clés API.

Configuration prête à coller

mcp.json (Cursor / Zed / Windsurf)
{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

Interrogez votre éditeur sur votre Telegram

Avec votre compte personnel connecté, l’IA de votre IDE peut consulter Telegram sans que vous changiez d’application. Essayez :

  • « Ai-je manqué des messages de clients pendant que j’étais plongé dans mon code ? »
  • « À quelles conversations j’oublie de répondre ? »
  • « Combien de prospects se sont refroidis cette semaine ? »
  • « Résume les retours clients d’aujourd’hui. »
  • « Rédige une réponse au dernier message sans réponse et montre-la-moi. »

Connectez votre éditeur en 3 étapes

Compatible avec Cursor, Zed et Windsurf.

  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

    Ajoutez le serveur à mcp.json

    Dans les paramètres MCP de votre éditeur (mcp.json), enregistrez l’URL MCP d’Entergram : https://mcp.entergram.com/mcp.

  3. 03

    Autorisez et utilisez

    Cliquez sur Connect, connectez-vous avec votre compte Entergram et cliquez sur Allow access. L’assistant IA de votre éditeur peut désormais interroger votre compte Telegram et agir dessus.

Trois éditeurs, trois fichiers de configuration

Cursor — ~/.cursor/mcp.json

Cursor charge les serveurs depuis ~/.cursor/mcp.json pour chaque projet que vous ouvrez, ou depuis .cursor/mcp.json versionné dans un dépôt quand vous voulez limiter le serveur à cette base de code. Par les menus, le chemin est Cursor Settings → MCP & Integrations → New MCP server, qui écrit le même fichier à votre place. Une entrée au niveau du projet demande une confirmation de confiance la première fois que l’agent y touche : un collègue qui récupère le dépôt fait donc quand même un choix délibéré.

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

Zed — ~/.config/zed/settings.json

Zed range les serveurs MCP dans un bloc context_servers de son fichier de réglages principal, et non dans un bloc mcpServers — ce seul mot fait échouer la plupart des premières tentatives : collez le fragment de Cursor tel quel et rien ne se charge, sans la moindre erreur pour l’expliquer. L’écran de réglages de l’Agent Panel propose un bouton Add Custom Server qui écrit la bonne structure si vous préférez ne pas éditer le JSON à la main.

{
  "context_servers": {
    "entergram": {
      "source": "custom",
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json

Windsurf lit un fichier dédié sous ~/.codeium plutôt que les réglages de l’éditeur auxquels on penserait, et Cascade le relit à la demande : après l’enregistrement, ouvrez le panneau MCP dans Cascade et actualisez, sinon les outils restent invisibles jusqu’au prochain redémarrage. La structure JSON, elle, est identique à celle de Cursor : l’entrée est donc transposable de l’un à l’autre.

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

De la trace d’exécution à la personne qui l’a envoyée

Votre éditeur détient déjà le code. Ce qu’il n’a jamais détenu, c’est l’autre moitié d’un bug : qui l’a rencontré, combien ils sont, et ce que le support leur a déjà promis. Chaque question ci-dessous se résout en une courte chaîne d’appels d’outils nommés, qui défilent dans le panneau de l’agent pendant que vous continuez à lire votre fichier.

Vous demandez

« Quelqu’un nous a envoyé une TypeError depuis la page de facturation. Retrouve le message et dis-moi qui l’a signalée. »

Outils appelés

entergram_list_messagesentergram_get_contactentergram_list_chat_tickets

Vous obtenez

L’agent parcourt l’historique récent à la recherche du texte d’erreur, résout l’expéditeur vers une fiche contact, et vérifie si cette conversation a déjà produit un ticket. Vous obtenez le nom de la personne, ses mots exacts, et un oui ou non sur l’existence d’un ticket — avant même d’avoir ouvert un seul fichier du dépôt.

Vous demandez

« Est-ce que ça vaut le coup de corriger aujourd’hui ? Compte combien de personnes ont signalé la même chose. »

Outils appelés

entergram_list_workspace_chatsentergram_list_messagesentergram_get_chat

Vous obtenez

De la priorisation appuyée sur des comptages plutôt que sur l’intuition. Il balaie la vue partagée de l’espace de travail plutôt qu’un seul fil, rapproche les cas du symptôme décrit, et rapporte combien de conversations distinctes le mentionnent et quand la première est arrivée. Deux signalements en un mois, ça ne se lit pas du tout comme neuf en deux jours.

Vous demandez

« Récupère le journal que le client a collé pour que je puisse reproduire en local. »

Outils appelés

entergram_list_chatsentergram_list_messagesentergram_get_message

Vous obtenez

L’agent localise le fil, remonte jusqu’au message qui porte le contenu, et le récupère en entier plutôt que dans son aperçu tronqué. Vous pouvez ensuite lui demander de transformer ce journal en test qui échoue, dans le fichier déjà ouvert — c’est la partie qui est vraiment plus rapide que de lire Telegram sur un second écran.

Vous demandez

« Colle ces étapes de reproduction sur le ticket lié à ce bug. »

Outils appelés

entergram_list_ticketsentergram_get_ticketentergram_create_ticket_comment

Vous obtenez

Vos notes atterrissent là où l’équipe support ira les chercher, rédigées pendant que le contexte est encore frais dans votre tête. Le commentaire est attaché au ticket et non envoyé au client : un ingénieur peut donc être direct sur la cause sans que quiconque ait à en préparer une version diplomatique.

Vous demandez

« Sur quelle offre se trouve la personne qui a signalé ça, et que lui a-t-on déjà dit ? »

Outils appelés

entergram_list_custom_columnsentergram_get_chat_custom_fieldsentergram_list_chat_comments

Vous obtenez

Il lit le schéma de vos colonnes, récupère les valeurs posées sur cette conversation, puis lit les notes internes laissées par vos collègues. La réponse arrive en un paragraphe : son niveau d’offre, son état de renouvellement si vous le suivez, et l’engagement pris par quelqu’un lors d’un appel la semaine dernière dont personne ne vous avait parlé.

Vous demandez

« Le correctif est fusionné. Préviens les deux personnes qui l’avaient signalé et clôture le ticket. »

Outils appelés

entergram_list_accountsentergram_send_messageentergram_update_ticket

Vous obtenez

L’étape que tout le monde saute. Il détermine quel compte connecté possède chaque conversation, rédige un court message par personne pour que vous l’approuviez, et passe le ticket en clôturé une fois les messages partis. La boucle entre la livraison et l’information du client concerné passe d’une tâche à faire à une seule requête.

Ce que votre éditeur peut faire avec Telegram

  • Interroger vos conversations Telegram depuis l’éditeur
  • Faire remonter les messages manqués pendant que vous travaillez
  • Retrouver vos contacts et champs CRM directement dans le flux
  • Envoyer des messages et des réponses après validation
  • Chiffrer les opportunités manquées et les retours
  • Créer des outils internes à partir de vraies données Telegram

Les 70 outils que récupère votre éditeur

Cursor, Zed et Windsurf reçoivent tous la même liste — neuf groupes, soixante-dix fonctions nommées — et chacun affiche les appels au fur et à mesure que l’agent les effectue : vous pouvez donc regarder une question se transformer en séquence et l’interrompre tôt. Lesquels de ces soixante-dix aboutissent réellement dépend du niveau d’accès derrière l’autorisation, décrit ci-dessous.

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

Ce qui vit dans le fichier de configuration, et ce qui n’y est pas

L’entrée que vous collez dans mcp.json contient exactement une chose : une adresse. Aucun jeton, aucun numéro de téléphone, aucune clé d’API — c’est pourquoi un .cursor/mcp.json au niveau du projet peut être versionné à côté du code qu’il sert. L’autorisation, elle, se fait dans un navigateur, vous appartient plutôt qu’au dépôt, et est conservée par l’éditeur. Pour la reprendre, révoquez la connexion depuis l’écran MCP sous Settings → Workspace → Connectors dans Entergram ; le jeton détenu par l’éditeur cesse de fonctionner dès son appel suivant. Il existe deux niveaux d’accès, et ils ne sont pas interchangeables.

Agent personnel
Tout membre peut s’en créer un, et sur un portable de développement c’est en général le bon plafond. Il lit l’espace de travail, les comptes, les contacts, les conversations, les messages et les tickets, et n’écrit que les champs personnalisés des conversations rattachées à vos propres comptes connectés. Un agent muni de ce niveau peut enquêter sur un bug de fond en comble et reste incapable d’écrire à la personne qui l’a signalé.
Connecteur d’espace de travail
Réservé aux propriétaires et administrateurs. Il porte l’ensemble complet des permissions — envoi, écriture des champs personnalisés de n’importe quelle conversation, administration des groupes — et il est partagé avec l’équipe plutôt que détenu par un développeur. Utilisez-le quand l’éditeur travaille pour le compte de l’entreprise et non pour le vôtre.
Révocation
Elle fonctionne dans les deux sens et prend effet immédiatement. Supprimer le serveur de mcp.json empêche l’éditeur de demander ; révoquer dans Entergram empêche qu’on lui réponde. C’est la seconde qui compte quand le portable n’est plus entre vos mains.

Là où l’intégration éditeur s’arrête

Bon à savoir avant d’en faire une habitude.

  • L’accès MCP relève de l’offre Pro, et rien du côté de l’éditeur n’y change quoi que ce soit — un espace de travail en dessous peut déclarer le serveur, terminer la connexion, et ne rien récupérer d’utile lors d’un appel.
  • Rien n’arrive de soi-même. L’éditeur n’interroge Entergram qu’à l’intérieur d’un tour que vous avez lancé : un message qui arrive pendant que vous refactorisez attend tranquillement votre prochaine question.
  • La configuration est propre à chaque machine. mcp.json ne voyage pas avec votre compte d’éditeur, et l’autorisation OAuth non plus — un second portable, c’est un second fichier et un second écran de consentement.
  • La sortie des outils reste dans la conversation. L’agent peut citer le journal d’un client dans un commentaire ou une fixture, mais il n’écrit dans vos fichiers que si vous le lui demandez, et jamais dans l’autre sens.
  • Chaque envoi nomme un compte. account_id est un argument obligatoire et non une valeur par défaut : un agent qui se trompe de branche ne peut pas improviser un message à toute votre liste de contacts.
  • Le connecteur voit précisément ce que voit votre compte Telegram. Un groupe où vous n’avez jamais été ajouté reste invisible depuis l’éditeur aussi, quelle que soit la formulation de la requête.

Quand l’éditeur refuse de voir Entergram

Le serveur affiche un point rouge dans le panneau MCP de Cursor
Cursor met en cache la liste d’outils de la dernière poignée de main réussie. Désactivez puis réactivez le serveur dans Cursor Settings → MCP & Integrations, et si le point reste rouge, rechargez la fenêtre — l’agent lit la liste au démarrage de la fenêtre, pas à l’édition du fichier.
Zed ignore complètement l’entrée
Vous avez presque certainement écrit mcpServers. La clé de Zed est context_servers, et une clé de premier niveau inconnue est ignorée en silence plutôt que signalée comme une erreur. Corrigez le nom de la clé, enregistrez et redémarrez Zed.
Windsurf n’affiche aucun outil Entergram après l’enregistrement
Vérifiez que vous avez bien édité ~/.codeium/windsurf/mcp_config.json et non l’interface de réglages, puis ouvrez le panneau MCP dans Cascade et actualisez-le. Windsurf relit ce fichier quand on le lui demande, et pas avant.
L’écran de consentement s’ouvre mais l’éditeur reste déconnecté
L’autorisation se termine dans le navigateur que votre système ouvre par défaut. Terminez la connexion là, en étant connecté à Entergram dans ce même profil, puis revenez déclencher l’action de connexion une fois de plus.
L’agent répond au sujet de Telegram sans rien appeler
Trop de serveurs sont déclarés et la liste d’outils est tronquée avant d’atteindre le modèle. Désactivez les serveurs MCP inutiles pour cette tâche et nommez Entergram dans la requête pour lever toute ambiguïté.
Les appels reviennent en 403
Vérifiez deux choses, dans cet ordre. Votre rôle : un connecteur d’espace de travail exige propriétaire ou administrateur, un agent personnel couvre tout le monde. Puis votre offre : l’accès MCP vit sur Pro, et un niveau inférieur échoue ici plutôt qu’au moment de la connexion.

FAQ Cursor / Zed / Windsurf + Telegram

Quels éditeurs sont pris en charge ?
Tout éditeur compatible MCP via mcp.json, dont Cursor, Zed et Windsurf. Enregistrez l’URL MCP d’Entergram et autorisez via OAuth.
Est-ce un bot Telegram ?
Non. Entergram connecte votre véritable compte Telegram personnel via un serveur MCP hébergé.
Peut-il me dire ce que j’ai manqué pendant que je codais ?
Oui. Demandez-le à l’IA de votre éditeur : elle lira vos conversations, comptera les messages sans réponse et signalera ceux qui viennent de clients.
Est-ce sécurisé ?
Oui. OAuth 2.0 avec des permissions limitées ; vos identifiants n’atteignent jamais l’éditeur et l’accès est révocable.

Connecter Telegram à Cursor et aux IDE