Aller au contenu
Hedy

Connecter Hedy avec des assistants IA via MCP

Qu’est-ce que le serveur MCP Hedy ?

Le serveur MCP Hedy permet aux assistants IA d’accéder de manière sécurisée à vos données Hedy et de les organiser. Une fois connecté, vous pouvez demander à votre IA d’analyser des transcriptions de réunion, de trouver des points clés, de consulter des actions à mener, de créer des sujets et de gérer vos contextes de session, le tout par conversation naturelle.

MCP (Model Context Protocol) est un standard ouvert qui permet aux applications d’IA de se connecter à des sources de données externes. Le serveur MCP Hedy utilise l’authentification OAuth, ce qui le rend compatible avec les plateformes d’IA web, les applications de bureau et les outils de développement.

Comment se connecter

Étape 1 : ajouter le serveur

  1. Ouvrez les paramètres du serveur MCP de votre client IA

  2. Recherchez “Add MCP Server”, “Connect Remote Server” ou “Add Integration”

  3. Entrez l’URL du serveur : https://api.hedy.bot/mcp

  4. Cliquez sur “Add” ou “Connect”

Étape 2 : autoriser l’accès

  1. Votre client IA ouvrira une fenêtre de navigateur

  2. Connectez-vous avec votre compte Hedy

  3. Vérifiez les autorisations demandées

  4. Cliquez sur “Allow” pour autoriser

  5. Retournez à votre client IA

C’est tout ! Aucun fichier de configuration ni clé API nécessaire.

Clients IA compatibles

Fonctionne avec tout client compatible MCP prenant en charge les serveurs distants :

  • Plateformes d’IA web - assistants IA accessibles par navigateur

  • Applications de bureau - Claude Desktop, BoltAI, Cursor, Windsurf, Zed

  • Outils de développement - VS Code avec GitHub Copilot, Cline, Claude Code

  • Plateformes d’agents IA - constructeurs de flux de travail personnalisés

Instructions de configuration par client

Claude Code (CLI)

Ajoutez le serveur MCP Hedy avec une seule commande :

claude mcp add --transport http hedy https://api.hedy.bot/mcp

Cela déclenchera le flux OAuth dans votre navigateur. Connectez-vous avec votre compte Hedy et autorisez l’accès.

Claude Desktop (Pro/Max/Team/Enterprise)

  1. Ouvrez Claude Desktop et accédez à Settings

  2. Faites défiler jusqu’à Integrations en bas

  3. Cliquez sur Add more (ou Add integration)

  4. Entrez :

    • Integration name: Hedy

    • Integration URL: https://api.hedy.bot/mcp

  5. Cliquez sur Connect et complétez le flux OAuth dans votre navigateur

  6. Dans les nouveaux chats, cliquez sur l’icône des outils pour activer les outils Hedy

Remarque : les utilisateurs du niveau gratuit doivent utiliser le pont mcp-remote. Consultez le README du projet pour la configuration.

Cline (extension VS Code)

Option 1 : via l’interface Cline (recommandé)

  1. Ouvrez VS Code avec l’extension Cline installée

  2. Cliquez sur l’icône Cline dans la barre latérale

  3. Cliquez sur le menu (⋮) et sélectionnez “MCP Servers”

  4. Sélectionnez l’onglet “Remote Servers”

  5. Entrez : Server Name: hedy, Server URL: https://api.hedy.bot/mcp, Transport Type: Streamable HTTP

  6. Cliquez sur “Add Server”

  7. Cliquez sur “Authenticate” lorsque vous y êtes invité et complétez le flux OAuth dans votre navigateur

Option 2 : configuration JSON manuelle

  1. Ouvrez le fichier de paramètres MCP de Cline :

    • macOS : ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

    • Windows : %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

    • Linux : ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

  2. Ajoutez cette configuration :

    {"mcpServers": {"hedy": {"url": "https://api.hedy.bot/mcp","type": "streamableHttp","disabled": false}}}

  3. Enregistrez le fichier et redémarrez VS Code

  4. Le flux OAuth se déclenchera lorsque Cline tentera d’utiliser le serveur

BoltAI (macOS)

BoltAI se connecte aux serveurs MCP via une configuration locale. Comme BoltAI ne prend pas nativement en charge les serveurs OAuth distants, vous aurez besoin du pont mcp-remote.

Prérequis : Node.js doit être installé sur votre Mac (node -v pour vérifier).

  1. Ouvrez BoltAI → Settings → Plugins, cliquez sur le bouton + pour ouvrir mcp.json

  2. Ajoutez la configuration suivante :

    {"mcpServers":{"hedy":{"command":"npx","args":["mcp-remote","https://api.hedy.bot/mcp"]}}}

  3. Cliquez sur Save Changes

  4. Lors de la première utilisation, une fenêtre de navigateur s’ouvrira — connectez-vous avec votre compte Hedy et autorisez l’accès

Remarque : le pont mcp-remote traduit le serveur distant compatible OAuth en une connexion stdio locale que BoltAI peut gérer. Après la première autorisation, le jeton est mis en cache localement.

Cursor / Windsurf / autres outils IDE

  1. Ouvrez les paramètres MCP dans votre IDE

  2. Ajoutez l’URL du serveur : https://api.hedy.bot/mcp

  3. Sélectionnez “HTTP” ou “Streamable HTTP” comme type de transport

  4. Autorisez lorsque vous y êtes invité

Clients IA web

  1. Trouvez “Connect MCP Server” ou “Add Integration”

  2. Entrez : https://api.hedy.bot/mcp

  3. Complétez l’autorisation OAuth dans votre navigateur

Outils disponibles

Le serveur MCP Hedy fournit 18 outils que votre assistant IA peut utiliser pour accéder à vos données de réunion et les organiser :

Outils de session

GetSessions

Ce qu’il fait : liste vos sessions de réunion récentes, classées par heure de début (les plus récentes en premier)

Paramètres :

  • limit (optionnel) - nombre de sessions à retourner (1-100)

  • after (optionnel) - ID de session pour commencer la pagination après

Exemples de requêtes :

  • “Montre-moi mes 10 dernières sessions”

  • “Liste toutes les sessions de cette semaine”

  • “Quelles réunions ai-je eues récemment ?”

GetSessionDetails

Ce qu’il fait : récupère les détails complets d’une session spécifique incluant les métadonnées, les participants et la transcription

Paramètres :

  • sessionId (requis) - l’ID de la session

Exemples de requêtes :

  • “Montre-moi les détails de la session ABC123”

  • “Qu’a-t-on discuté lors de ma dernière réunion d’équipe ?”

  • “Obtiens la transcription de la session de lancement de produit”

GetSessionHighlights

Ce qu’il fait : retourne tous les points clés capturés pendant une session spécifique

Paramètres :

  • sessionId (requis) - l’ID de la session

Exemples de requêtes :

  • “Quels points clés ai-je sauvegardés dans la session ABC123 ?”

  • “Montre-moi les moments clés du standup d’hier”

  • “Liste tous les points clés de la réunion budget”

GetSessionToDos

Ce qu’il fait : liste toutes les tâches générées pendant une session spécifique

Paramètres :

  • sessionId (requis) - l’ID de la session

  • includeCompleted (optionnel) - si vrai, inclut les tâches terminées (par défaut : uniquement les tâches ouvertes)

Exemples de requêtes :

  • “Quelles actions à mener sont issues de la session ABC123 ?”

  • “Montre-moi les tâches de la réunion client, y compris les terminées”

  • “Liste les tâches en attente de la session de planification d’hier”

Outils de points clés

GetHighlights

Ce qu’il fait : liste vos points clés récents à travers toutes les sessions, triés du plus récent au plus ancien

Paramètres :

  • limit (optionnel) - nombre de points clés à retourner (1-100)

  • after (optionnel) - ID du point clé pour commencer la pagination après

Exemples de requêtes :

  • “Montre-moi mes 20 derniers points clés”

  • “Qu’ai-je mis en évidence cette semaine ?”

  • “Liste les moments clés récents que j’ai sauvegardés”

GetHighlightDetails

Ce qu’il fait : récupère les détails complets d’un point clé spécifique incluant l’extrait de transcription, l’horodatage et le contexte

Paramètres :

  • highlightId (requis) - l’ID du point clé

Exemples de requêtes :

  • “Montre-moi le point clé XYZ789 en détail”

  • “Quel était le contexte autour de ce point clé sur le budget ?”

  • “Obtiens la transcription complète du point clé XYZ789”

Outils de tâches

GetToDos

Ce qu’il fait : retourne toutes les tâches à travers toutes vos sessions

Paramètres :

  • includeCompleted (optionnel) - si vrai, inclut les tâches terminées (par défaut : uniquement les tâches ouvertes)

Exemples de requêtes :

  • “Quelles sont toutes mes actions en attente ?”

  • “Montre-moi toutes les tâches, y compris les terminées”

  • “Liste tout ce que je dois faire suite à mes réunions”

Outils de sujets

Les assistants IA peuvent consulter vos sujets et aussi vous aider à les organiser en créant de nouveaux sujets, en mettant à jour les existants ou en supprimant les sujets dont vous n’avez plus besoin.

GetAllTopics

Ce qu’il fait : liste tous vos sujets et dossiers de réunion

Paramètres :

  • includeArchived (optionnel) - si vrai, inclut les sujets archivés (par défaut : uniquement les sujets actifs)

Exemples de requêtes :

  • “Quels sujets ai-je dans Hedy ?”

  • “Liste toutes mes catégories de réunion”

  • “Montre-moi tous les sujets, y compris les archivés”

GetTopicDetails

Ce qu’il fait : récupère les détails d’un sujet spécifique incluant la description, le nombre de sessions et les analyses générées par l’IA

Paramètres :

  • topicId (requis) - l’ID du sujet

Exemples de requêtes :

  • “Montre-moi les détails du sujet Réunions clients”

  • “Combien de sessions sont dans mon sujet Standups d’équipe ?”

  • “Quelles analyses Hedy a-t-il sur mon sujet Planification produit ?”

GetTopicSessions

Ce qu’il fait : liste toutes les sessions associées à un sujet spécifique

Paramètres :

  • topicId (requis) - l’ID du sujet

Exemples de requêtes :

  • “Montre-moi toutes les sessions du sujet Planification produit”

  • “Liste les réunions étiquetées Réunions clients”

  • “Quelles sessions sont dans mon dossier 1:1 ?”

CreateTopic

Ce qu’il fait : crée un nouveau sujet pour organiser vos sessions de réunion

Paramètres :

  • name (requis) - nom du sujet (max 100 caractères)

  • description (optionnel) - description du sujet (max 500 caractères)

  • color (optionnel) - couleur du sujet (ex. #FF5733)

  • iconName (optionnel) - nom de l’icône du sujet

  • topicContext (optionnel) - instructions personnalisées pour l’analyse IA des sessions de ce sujet

Exemples de requêtes :

  • “Crée un nouveau sujet appelé Planification T1”

  • “Crée un sujet pour les appels clients avec une couleur bleue”

  • “Configure une nouvelle catégorie pour les sessions d’entretien”

UpdateTopic

Ce qu’il fait : met à jour le nom, la description, la couleur ou d’autres paramètres d’un sujet existant

Paramètres :

  • topicId (requis) - l’ID du sujet à mettre à jour

  • name (optionnel) - nouveau nom du sujet

  • description (optionnel) - nouvelle description

  • color (optionnel) - nouvelle couleur

  • iconName (optionnel) - nouvelle icône

  • topicContext (optionnel) - nouvelles instructions personnalisées pour l’analyse IA

Exemples de requêtes :

  • “Renomme le sujet Planification T1 en Planification T2”

  • “Change la couleur de mon sujet Réunions clients en vert”

  • “Mets à jour la description de mon sujet Standups d’équipe”

DeleteTopic

Ce qu’il fait : supprime un sujet. Les sessions précédemment dans le sujet sont conservées mais ne sont plus regroupées sous celui-ci.

Paramètres :

  • topicId (requis) - l’ID du sujet à supprimer

Exemples de requêtes :

  • “Supprime l’ancien sujet Projet Alpha”

  • “Retire mon sujet Préparation d’entretien inutilisé”

  • “Supprime le sujet appelé Test”

Outils de contexte de session

Les contextes de session vous permettent de fournir des informations de fond que Hedy utilise lors de l’analyse de vos réunions. Les assistants IA peuvent vous aider à consulter et gérer ces contextes.

ListSessionContexts

Ce qu’il fait : liste tous vos contextes de session sauvegardés, classés par date de dernière mise à jour

Exemples de requêtes :

  • “Montre-moi tous mes contextes de session”

  • “Quels contextes de fond ai-je configurés ?”

  • “Liste mes profils de contexte de réunion”

GetSessionContext

Ce qu’il fait : récupère les détails d’un contexte de session spécifique

Paramètres :

  • contextId (requis) - l’ID du contexte à récupérer

Exemples de requêtes :

  • “Montre-moi les détails de mon contexte Travail”

  • “Qu’y a-t-il dans mon contexte de session par défaut ?”

CreateSessionContext

Ce qu’il fait : crée un nouveau contexte de session avec des informations de fond que Hedy utilisera pendant l’analyse

Paramètres :

  • title (requis) - titre du contexte (max 200 caractères)

  • content (optionnel) - les informations de fond et instructions

  • isDefault (optionnel) - définir comme contexte par défaut

Exemples de requêtes :

  • “Crée un nouveau contexte appelé Appels commerciaux avec des informations sur mes produits”

  • “Configure un contexte pour mes réunions d’équipe ingénierie”

  • “Crée un nouveau contexte par défaut avec mon rôle et mes responsabilités”

UpdateSessionContext

Ce qu’il fait : met à jour un contexte de session existant

Paramètres :

  • contextId (requis) - l’ID du contexte à mettre à jour

  • title (optionnel) - nouveau titre

  • content (optionnel) - nouvelles informations de fond

  • isDefault (optionnel) - définir comme contexte par défaut

Exemples de requêtes :

  • “Mets à jour mon contexte Travail avec ma nouvelle structure d’équipe”

  • “Ajoute des informations sur nos objectifs T2 à mon contexte par défaut”

  • “Change mon contexte Commercial pour qu’il soit le contexte par défaut”

DeleteSessionContext

Ce qu’il fait : supprime un contexte de session. Si vous supprimez votre contexte par défaut, un autre deviendra automatiquement le contexte par défaut.

Paramètres :

  • contextId (requis) - l’ID du contexte à supprimer

Exemples de requêtes :

  • “Supprime mon ancien contexte Projet X”

  • “Retire le contexte que je n’utilise plus”

Exemples de flux de travail

Revue hebdomadaire

Demandez à votre IA : “Montre-moi mes sessions de cette semaine, liste toutes les tâches en attente et mets en évidence les éléments importants”

Ce qui se passe : l’IA utilise GetSessions avec un filtrage par date, puis GetToDos pour trouver les actions à mener, et peut approfondir des sessions spécifiques pour plus de détails.

Préparation de réunion

Demandez à votre IA : “Trouve toutes les sessions concernant la roadmap T4 et résume les points clés”

Ce qui se passe : l’IA recherche dans les sessions, utilise GetSessionDetails et GetSessionHighlights pour rassembler les informations, puis crée un résumé.

Gestion des tâches

Demandez à votre IA : “Montre-moi toutes les actions à mener des réunions clients ce mois-ci”

Ce qui se passe : l’IA utilise GetAllTopics pour trouver le sujet Réunions clients, GetTopicSessions pour lister les sessions, puis GetSessionToDos pour chacune afin de compiler la liste.

Analyse de sujet

Demandez à votre IA : “Analyse mes sessions de Standup d’équipe et identifie les thèmes récurrents”

Ce qui se passe : l’IA trouve le sujet, récupère toutes les sessions qu’il contient, lit les transcriptions et les points clés, puis effectue l’analyse.

Organisation de vos données

Demandez à votre IA : “Crée un nouveau sujet appelé Planification T2 et configure un contexte pour nos revues trimestrielles”

Ce qui se passe : l’IA utilise CreateTopic pour créer le nouveau sujet, puis CreateSessionContext pour configurer les informations de fond pour une meilleure analyse des réunions.

Confidentialité et sécurité

  • OAuth 2.1 avec PKCE - authentification sécurisée selon les standards de l’industrie

  • Vous contrôlez l’accès - autorisez exactement ce que l’IA peut faire avec vos données

  • Les données de session sont protégées - l’IA peut aider à organiser les sujets et contextes, mais ne peut pas supprimer vos enregistrements ou transcriptions de réunion

  • Sur demande uniquement - les données ne sont consultées que lorsque vous faites des requêtes

  • Révocable à tout moment - vous pouvez déconnecter l’accès IA à tout moment depuis vos paramètres Hedy

Prérequis

  • Abonnement Hedy actif (Pro ou Premium)

  • Cloud Sync activé dans vos paramètres Hedy

  • Un assistant IA prenant en charge MCP (comme Claude)

Dépannage

Le client IA n’a pas d’option “Add MCP Server”

  • Vérifiez si votre client prend en charge les serveurs MCP distants

  • Mettez à jour vers la dernière version

  • Recherchez les paramètres MCP dans les préférences

  • Certains clients ne prennent en charge que les serveurs locaux et nécessitent une configuration manuelle

L’autorisation échoue

  • Assurez-vous d’être connecté à Hedy

  • Vérifiez que votre compte est actif

  • Videz le cache du navigateur et réessayez

  • Vérifiez la connexion Internet

  • Essayez d’ouvrir https://api.hedy.bot/mcp/.well-known/oauth-protected-resource pour vérifier que le serveur est accessible

L’IA ne peut pas accéder à mes données

  • Confirmez que l’autorisation OAuth est terminée

  • Vérifiez que vous avez des sessions dans votre compte Hedy

  • Vérifiez l’état de l’autorisation dans les paramètres du client IA

  • Essayez de vous déconnecter et de vous reconnecter

La connexion a cessé de fonctionner

  • Le jeton d’accès a peut-être expiré — réautorisez

  • Si vous avez changé votre mot de passe Hedy, réautorisez

  • Vérifiez status.hedy.bot pour les problèmes de service

  • Supprimez et réajoutez le serveur

Le client nécessite une configuration OAuth manuelle

  • Si votre client ne prend pas en charge la découverte automatique, utilisez ces paramètres :

    • Authorization URL: https://api.hedy.bot/mcp/oauth/authorize

    • Token URL: https://api.hedy.bot/mcp/oauth/token

    • Scopes: mcp.sessions.read mcp.highlights.read mcp.todos.read mcp.topics.read mcp.topics.write mcp.contexts.read mcp.contexts.write

L’IA indique qu’un outil a échoué ou a retourné une erreur

  • Vérifiez que l’ID de session/point clé/sujet est valide

  • Vérifiez que vous avez la permission d’accéder à ces données

  • Assurez-vous que les données demandées existent dans votre compte

  • Essayez de demander plus précisément (par ex., incluez les titres de session au lieu des ID)

  • Vérifiez la limitation de débit — attendez un instant et réessayez

Bonnes pratiques

Pour de meilleurs résultats

  • Utilisez des titres de session clairs - facilite la recherche par l’IA

  • Organisez avec des sujets - regroupez les sessions liées

  • Créez des points clés pendant les réunions - aide l’IA à identifier les moments importants

  • Ajoutez des notes descriptives aux tâches - rend les actions plus faciles à rechercher

  • Soyez précis dans vos requêtes - incluez des dates, des sujets ou des mots-clés

Lorsque vous demandez à votre IA

  • Précisez les plages de dates - “Montre les sessions de la semaine dernière” est plus clair que “Montre les sessions récentes”

  • Mentionnez les sujets lorsque c’est pertinent - “Sessions de réunions clients” vs “toutes les sessions”

  • Demandez des résumés - l’IA peut synthétiser les données de plusieurs outils

  • Demandez des formats spécifiques - “Crée une liste à puces” ou “Fais un tableau”

  • Posez des questions de suivi - l’IA peut approfondir les résultats

Astuce Pro : l’IA peut combiner plusieurs outils en une seule requête. Essayez de poser des questions complexes comme “Trouve toutes les tâches en attente des réunions clients ce mois-ci et organise-les par priorité” ou “Crée un nouveau sujet pour nos lancements de produit et liste toutes les sessions qui devraient y figurer” pour voir la puissance de l’intégration MCP.

Besoin d’aide ?

  • Consultez la documentation MCP de votre client IA pour les instructions spécifiques au client

  • Visitez modelcontextprotocol.io pour des informations générales sur MCP

  • Contactez le support Hedy avec les messages d’erreur et le nom de votre client IA

Articles connexes

Importer des fichiers audio et vidéo dans Hedy Importer des vidéos en ligne Importer des transcriptions existantes dans Hedy

Cet article a-t-il répondu à votre question ?