Comment connecter Goose à Telegram via MCP

Goose est l'agent IA open source de Block : un assistant local et extensible qui va bien au-delà des suggestions de code. Là où la plupart des assistants répondent à des questions, Goose planifie et exécute un travail en plusieurs étapes sur votre machine : il lit le contexte, décide quoi faire, lance les outils dont il a besoin, vérifie le résultat et poursuit jusqu'à ce que la tâche soit terminée. Toute son architecture repose sur des extensions, et les extensions sont alimentées par le Model Context Protocol (MCP). Cela fait de Goose un partenaire naturel pour le serveur MCP Telegram d'Entergram, qui relie votre compte Telegram personnel —et non un bot— à l'agent afin que ces exécutions autonomes puissent inclure de véritables opérations de CRM Telegram.

Ce guide fait partie de notre centre connecter n'importe quel outil IA à Telegram MCP, et la page dédiée Goose Telegram MCP détaille le connecteur avec des captures d'écran. Si vous préférez d'abord la vue d'ensemble, le centre Telegram MCP explique comment Entergram expose Telegram à tout client compatible MCP.

MCP est le standard ouvert que Goose utilise pour charger des capacités externes au sein d'une exécution d'agent. Au lieu d'écrire une intégration sur mesure pour chaque service, vous pointez l'agent vers un unique endpoint MCP et il découvre automatiquement les outils disponibles. Entergram publie ses actions Telegram sur un seul endpoint hébergé, https://mcp.entergram.com/mcp. Une fois Goose connecté, il peut :

• Lister et lire les conversations : discussions privées, groupes et canaux de vos comptes connectés.
• Consulter les contacts et les champs personnalisés : étape, responsable, ARR, étiquettes et toute donnée structurée que vous conservez sur une conversation.
• Créer et mettre à jour des tickets : avec statut, priorité et personne assignée.
• Envoyer des messages et des diffusions : réponses, relances ou une diffusion personnalisée à partir d'un modèle enregistré.

Point essentiel : il s'agit de votre véritable compte Telegram, exposé à travers une couche CRM gérée par permissions, et non de la Bot API limitée. Goose voit les mêmes conversations que vous, encadrées par les portées que vous accordez.

Goose est conçu pour le travail enchaîné et autonome, et c'est précisément là qu'une connexion à Telegram porte ses fruits. Une seule instruction peut piloter toute une séquence d'étapes de CRM sans que vous touchiez la moindre interface graphique :

• Lire tout ce qui est arrivé pendant la nuit, le classer et trier les éléments urgents.
• Recouper chaque expéditeur avec son étape dans le CRM avant de décider comment répondre.
• Ouvrir des tickets, mettre à jour des champs et publier un résumé, le tout en une seule exécution.

Comme Goose s'exécute localement et conserve sa propre session, il peut le faire de façon répétée et planifiée. Le serveur MCP Telegram devient simplement une extension de plus à laquelle il fait appel, exactement comme il fait appel à un système de fichiers ou à un shell. Vous décrivez le résultat ; Goose détermine quels outils Telegram appeler et dans quel ordre.

Dans votre espace de travail Entergram, ouvrez Settings → Developer, cliquez sur Create new OAuth client et choisissez le préréglage Custom. Sélectionnez les portées avec soin. Comme Goose agit de manière autonome et en séquences, beaucoup d'équipes le démarrent en lecture seule (chats.read, contacts.read, custom_fields.read) et n'ajoutent des portées d'écriture telles que chats.write ou des permissions de tickets qu'une fois qu'elles font confiance à un workflow donné. Le moindre privilège limite l'étendue des dégâts si quelque chose tourne mal.

L'URL de votre serveur MCP est :

https://mcp.entergram.com/mcp

Goose stocke ses extensions dans ~/.config/goose/config.yaml, et vous pouvez en ajouter une de façon interactive avec goose configure. Choisissez Add Extension → Remote Extension, donnez-lui un nom comme entergram-telegram et collez l'endpoint ci-dessus. Fournissez les identifiants du client OAuth que vous venez de créer pour que Goose puisse s'authentifier. La page Goose Telegram MCP contient le bloc de configuration exact, y compris les en-têtes attendus par Goose. Au prochain démarrage, Goose charge les outils Entergram et les liste aux côtés de ses extensions intégrées.

Si vous préférez modifier directement le fichier de configuration, ajoutez l'entrée Entergram sous la clé extensions avec son type défini comme serveur MCP distant et l'URL pointant vers https://mcp.entergram.com/mcp. Les deux approches produisent le même résultat.

La première fois que Goose se connecte, vous approuvez la demande sur l'écran d'autorisation d'Entergram, qui énumère les permissions exactes accordées. Cliquez sur Allow access.

À partir de là, les outils Telegram sont disponibles pour Goose à chaque session, et vous pouvez les révoquer instantanément depuis Settings → Developer.

Goose donne le meilleur de lui-même lorsqu'un seul prompt se déploie en une séquence d'actions réelles. Quelques exemples réalistes :

• « Lis chaque conversation étiquetée support des dernières 24 heures, classe chacune par urgence, ouvre des tickets pour les urgentes et rédige-moi un résumé. » Goose lit les conversations, appelle l'outil de tickets pour chaque cas urgent et rend compte : un prompt, de nombreuses étapes.
• « Trouve chaque contact ayant mentionné "facture" cette semaine, passe leur champ de priorité à élevée et rédige une réponse pour chacun. » L'agent recherche, met à jour les champs personnalisés et prépare les réponses sans que vous ouvriez l'application.
• « Extrais les statistiques de temps de réponse de cette semaine et ajoute-les à mon rapport hebdomadaire. » Goose lit les analyses et les écrit là où vous conservez vos notes.
• « Vérifie quels prospects à l'étape Démo n'ont pas répondu depuis trois jours et rappelle-le-moi sous forme de liste. » Un point quotidien pour votre pipeline Telegram, généré à la demande.

Chacun de ces exemples est une chaîne d'appels d'outils MCP sur votre espace de travail. Vous ne scriptez pas les étapes ; vous énoncez l'objectif et laissez Goose orchestrer les opérations Telegram dans le bon ordre.

Confier à un agent autonome l'accès à votre véritable compte Telegram mérite de la prudence, et le connecteur est bâti exactement pour cela. L'accès est régi par des portées OAuth, vous décidez donc précisément ce que Goose peut lire et écrire. Commencez en lecture seule, validez un workflow, puis accordez les portées d'écriture minimales dont il a besoin, rien de plus. Il y a un client OAuth par utilisateur, et vous pouvez le révoquer instantanément depuis Settings → Developer, ce qui coupe immédiatement toutes les sessions Goose qui l'utilisent.

Entergram relaie votre session Telegram côté serveur et stocke les identifiants chiffrés ; l'agent travaille à travers la couche CRM plutôt que de détenir votre identifiant Telegram brut. Le contenu des messages n'est pas conservé pour l'entraînement, et chaque action d'un agent est consignée dans le journal d'activité de l'espace de travail avec un acteur et un horodatage, de sorte qu'une exécution autonome reste toujours auditable après coup. Pour les équipes, c'est souvent cette traçabilité qui rend acceptable, dès le départ, de laisser un agent agir plutôt que simplement conseiller.

Comme Goose s'exécute en ligne de commande, les mêmes workflows Telegram que vous déclenchez à la main peuvent tourner sans surveillance. Enveloppez un prompt dans une invocation goose run et planifiez-le avec cron, une tâche launchd ou votre runner de CI, et vous obtenez un agent récurrent : un tri à 7 h du matin qui ouvre des tickets pour tout ce qui est urgent et arrivé pendant la nuit, un balayage de fin de journée qui signale les prospects devenus silencieux, ou une vérification horaire qui ne vous alerte que lorsqu'un contact VIP écrit. La connexion MCP se comporte de façon identique, qu'elle soit lancée par un humain ou par un planificateur, et les portées OAuth que vous avez accordées s'appliquent toujours : un Goose planifié lit et agit exactement dans les mêmes limites. Gardez les exécutions planifiées en lecture seule jusqu'à en avoir vu quelques-unes se dérouler proprement, puis élargissez les portées une fois le comportement prévisible. C'est là que la conception autonome prouve sa valeur : l'agent fait la surveillance pour que vous n'ayez pas à la faire.

Si votre forfait Entergram inclut l'accès à l'API, le connecteur MCP est prêt à l'emploi. Créez votre connexion dès maintenant, suivez la procédure complète sur la page Goose Telegram MCP ou explorez tous les clients pris en charge dans le centre de connexion de toute IA. Pour les détails de configuration sous-jacents, le guide MCP pas à pas couvre les clients OAuth, les portées et le dépannage. Goose apporte l'autonomie ; Entergram apporte votre véritable CRM Telegram. Ensemble, ils transforment une pile de conversations non lues en travail qui s'accomplit pendant que vous vous concentrez ailleurs.