Skip to main content
← 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

Configuration prête à coller
{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

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"
    }
  }
}

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. »

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

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