Hedy MCP Server : guide développeur des 25 outils et de l'accès API
Compagnon technique du lancement du Hedy MCP Server : les 25 outils, la connexion OAuth 2.1, l'accès en lecture et en écriture, les clients compatibles et les liens entre MCP, l'API Hedy et les webhooks.
https://api.hedy.bot/mcp (comptes UE : https://eu-api.hedy.bot/mcp) et fonctionne avec Claude, ChatGPT, Cursor et d'autres clients MCP. Pour l'annonce de lancement initiale, consultez le billet de présentation.
Guide développeur du serveur MCP de Hedy
Ceci est le compagnon technique de notre annonce de lancement initiale du serveur MCP. Il documente le catalogue complet des outils, le modèle d’authentification et les schémas de flux de travail pour les développeurs qui connectent Claude ou d’autres clients compatibles MCP à leurs données de réunion Hedy via votre assistant de réunion IA avec les 25 outils.
Hedy se connecte directement à Claude et à d’autres assistants IA via le Model Context Protocol (MCP). Vos outils d’IA peuvent accéder, organiser et travailler avec vos données de réunion sans avoir à copier manuellement des informations entre applications.
Ce que cela permet concrètement
Le serveur MCP donne aux assistants IA comme Claude Desktop un accès direct à vos données Hedy via 25 outils. Voici ce qui devient possible :
Gestion des sessions
Les assistants IA peuvent récupérer vos transcriptions de réunion, résumés et éclairages. Demandez à Claude de « trouver la discussion budgétaire de la réunion client de la semaine dernière » et il extrait la session exacte avec le contexte complet.
Organisation par topics
Créez et gérez des topics de manière programmatique. Votre IA peut automatiquement organiser les réunions connexes, construire des bases de connaissances à partir de séries de conversations et suivre l’évolution des projets à travers plusieurs sessions.
Capture de moments clés
Accédez aux moments clés sauvegardés avec leur analyse générée par l’IA. Créez des guides d’étude à partir des moments clés de cours, compilez les points de décision des réunions d’affaires ou extrayez les citations clés des entretiens.
Intégration des tâches
Récupérez les éléments d’action directement dans votre workflow. Les assistants IA peuvent agréger les éléments d’action sur l’ensemble des projets, identifier les tâches en retard ou créer des listes de tâches consolidées à partir de multiples réunions.
Implémentation technique
Le serveur MCP fonctionne à l’adresse https://api.hedy.bot/mcp (les comptes UE utilisent https://eu-api.hedy.bot/mcp) et vous connecte avec OAuth 2.1. Il n’existe pas de clé API pour le serveur. La configuration prend environ deux minutes :
- Ajoutez l’URL du serveur dans les paramètres de connecteurs ou MCP de votre client IA
- Connectez-vous avec votre compte Hedy dans la fenêtre de navigateur qui s’ouvre
- Examinez les permissions et cliquez sur Autoriser
- Commencez à poser des questions sur vos réunions en langage naturel
Les clients qui n’acceptent qu’une clé API ou qui n’exécutent que des serveurs locaux peuvent se connecter via le pont open source mcp-remote. Le guide de configuration explique comment faire, avec les étapes pour chaque client.
L’intégration prend en charge aussi bien les requêtes au niveau des sessions (« Qu’avons-nous discuté concernant les tarifs ? ») que les analyses transversales (« Montre-moi tous les éléments d’action des réunions client ce mois-ci »).
Architecture de confidentialité
Les données sont chiffrées en transit et au repos. Les assistants lisent vos données uniquement lorsque vous le leur demandez, et les outils d’écriture se limitent à leur organisation : résumés, tâches, topics, contextes de session et vocabulaire. Aucun outil ne peut supprimer un enregistrement ou une transcription.
L’accès est lié à votre compte. Seuls les clients que vous avez approuvés lors de la connexion peuvent accéder à vos données, et vous pouvez révoquer l’accès de chacun depuis vos paramètres Hedy.
Outils disponibles
Le serveur MCP fournit 25 outils. 14 lisent vos données et 11 les modifient.
Sessions
GetSessions: lister les sessions récentes, de la plus récente à la plus ancienneGetSessionDetails: la transcription, le résumé et les métadonnées d’une sessionGetSessionHighlights,GetSessionToDos: les moments clés et tâches d’une sessionUpdateSessionSummary: remplacer le résumé d’une session, par exemple pour corriger un nom mal transcrit
Moments clés
GetHighlights,GetHighlightDetails: les moments clés sauvegardés sur l’ensemble des sessions, avec l’analyse de Hedy
Tâches
GetToDos: les tâches de l’ensemble de vos sessionsUpdateToDoCompletion,UpdateToDoDueDate: cocher une tâche ou définir son échéance
Topics
GetAllTopics,GetTopicDetails,GetTopicSessions: parcourir les topics et les sessions qu’ils contiennentCreateTopic,UpdateTopic,DeleteTopic: gérer les topics, y compris le contexte du topic que Hedy utilise pendant les sessions en direct (la suppression d’un topic conserve ses sessions)AssignSessionToTopic: classer une session dans un topic
Contextes de session
ListSessionContexts,GetSessionContext: lire les informations de fond sauvegardées que Hedy utilise pour ses suggestions en directCreateSessionContext,UpdateSessionContext,DeleteSessionContext: les rédiger ou les modifier, par exemple pour préparer l’appel du lendemain
Compte et vocabulaire
GetAccount: le compte connectéGetVocabulary,SetVocabulary: lire ou remplacer les termes personnalisés que Hedy reconnaît
Chaque outil comporte des annotations MCP qui indiquent au client s’il se limite à la lecture, s’il écrase des données et s’il accède à des ressources en dehors de Hedy. Un client peut les utiliser pour vous demander confirmation avant d’exécuter un outil qui modifie quelque chose.
Applications concrètes
Analyse de recherche
Les universitaires utilisent l’intégration pour synthétiser des résultats sur des séries de cours. Demandez à Claude de « comparer les trois cadres théoriques abordés lors des semaines 4 à 6 » et il extrait le contenu pertinent de multiples sessions, croise les concepts et génère une analyse comparative.
Gestion de clients
Les consultants maintiennent des historiques clients complets. L’IA peut « préparer la réunion de demain avec [Client] en examinant toutes les discussions précédentes sur leur stratégie T4 » et génère un document de briefing avec le contexte pertinent, les engagements en cours et les points de discussion suggérés.
Gestion des connaissances
Les équipes construisent un savoir institutionnel. L’intégration MCP permet aux assistants IA de créer une documentation structurée à partir de séries de réunions, d’extraire les bonnes pratiques des rétrospectives et de compiler les spécifications techniques des discussions de conception.
Automatisation de workflows
Les développeurs intègrent les données Hedy dans des systèmes personnalisés. Combinez l’accès MCP avec n8n ou Make.com pour construire des workflows automatisés qui routent les éclairages de réunion vers des outils de gestion de projet, mettent à jour les CRM ou déclenchent des actions de suivi.
Prérequis et compatibilité
Le serveur fonctionne avec tout client MCP prenant en charge les serveurs distants avec connexion OAuth. Compatibilité confirmée :
- Claude (web, application de bureau et Claude Code)
- ChatGPT
- Cursor, Windsurf, Zed et Cline
- Perplexity dans ses offres payantes
- Clients personnalisés construits avec le SDK MCP
L’accès MCP est inclus dans Hedy Pro et Hedy Team et nécessite que Cloud Sync soit activé, car le serveur lit vos sessions depuis le cloud de Hedy. Lorsque Cloud Sync est désactivé, les sessions restent sur votre appareil et aucune intégration ne peut y accéder. Le plan gratuit n’inclut pas MCP.
Pour commencer
Le guide de configuration détaille les étapes pour chaque client, le pont mcp-remote pour les clients sans prise en charge OAuth et le dépannage.
Pour votre propre code plutôt qu’un assistant IA, utilisez l’API Hedy avec une clé API et les webhooks pour envoyer les événements de session à vos systèmes au moment où ils se produisent.
Ce que cela permet
L’intégration MCP transforme la manière dont les professionnels utilisent l’intelligence de réunion. Au lieu de rechercher manuellement dans les sessions passées ou de copier des informations dans des documents, les assistants IA font le gros du travail — trouver le contexte pertinent, synthétiser les informations sur l’ensemble des conversations et présenter des éclairages exploitables.
Cela compte car le travail professionnel se déroule de plus en plus à travers les conversations. Les connaissances capturées dans les réunions, appels et discussions représentent une intelligence organisationnelle significative. L’intégration MCP rend cette intelligence accessible aux outils d’IA que vous utilisez déjà pour l’analyse, la rédaction et la prise de décision.
Pour les organisations, cela signifie que les données de réunion deviennent une base de connaissances interrogeable. Pour les individus, cela signifie que chaque conversation que vous avez eue avec Hedy devient disponible pour assister votre travail actuel — sans organisation manuelle requise.
Fondation technique
Le serveur utilise MCP sur HTTP en streaming (Streamable HTTP). Il implémente OAuth 2.1 avec PKCE et l’enregistrement dynamique des clients : un client s’enregistre lui-même et vous n’avez jamais à coller de clé. Les outils renvoient des résultats structurés en plus du texte pour les clients qui les prennent en charge.
Développement futur
L’ensemble des outils évolue selon ce que les utilisateurs demandent à leurs assistants de faire. Dites-nous ce que vous aimeriez voir ensuite sur le tableau des demandes de fonctionnalités.
Obtenir de l’aide
Le guide de configuration couvre chaque client, les problèmes de configuration courants et des exemples de requêtes. Pour vos questions, rejoignez la communauté Slack de Hedy.
L’accès MCP est inclus dans Hedy Pro et Hedy Team. Ajoutez https://api.hedy.bot/mcp à votre assistant IA et connectez-vous avec votre compte Hedy pour le connecter.
Questions fréquentes
Combien d’outils le Hedy MCP Server expose-t-il ?
25 outils répartis en sept groupes : sessions, moments clés, tâches, topics, contextes de session, compte et vocabulaire personnalisé. 14 lisent les données et 11 les modifient.
Le serveur Hedy MCP prend-il en charge les opérations d’écriture ?
Oui. Les assistants IA peuvent réécrire le résumé d’une session, cocher des tâches et définir leurs échéances, créer, modifier et supprimer des topics, classer les sessions dans des topics, gérer les contextes de session et remplacer votre vocabulaire personnalisé. Aucun outil ne peut supprimer un enregistrement ou une transcription. Les webhooks se configurent via l’API Hedy, pas via MCP.
Comment fonctionne l’authentification Hedy MCP ?
Le serveur Hedy MCP utilise OAuth 2.1. Votre client IA ouvre une fenêtre de navigateur pour la connexion et l’examen des permissions, et émet un token d’accès une fois que vous autorisez l’accès. Aucune clé API statique à renouveler. Vous pouvez révoquer l’accès à tout moment depuis vos paramètres Hedy.
Quelle est l’URL du serveur Hedy MCP ?
https://api.hedy.bot/mcp pour les comptes US. Les comptes avec résidence des données dans l’UE utilisent https://eu-api.hedy.bot/mcp. Ajoutez l’URL à votre client compatible MCP (Claude, ChatGPT, Cursor, Windsurf, Zed, Cline, Claude Code) et authentifiez-vous via OAuth.
Quelle est la différence entre le serveur Hedy MCP, l’API et les webhooks ?
Le serveur MCP s’adresse aux assistants IA : ils se connectent avec OAuth et appellent des outils pendant une conversation. L’API Hedy est destinée à votre propre code et utilise une clé API. Les webhooks envoient les événements de session à un endpoint de votre choix au moment où ils se produisent. Tous trois nécessitent un plan Hedy payant avec Cloud Sync activé.
About the author
Julian Pscheid is the founder and CEO of Hedy AI, a real-time AI meeting coach used by tens of thousands of professionals worldwide. He writes about how AI is changing the way people prepare for, capture, and understand important conversations.