Zum Hauptinhalt springen

Verbinden Sie Hedy mit KI-Assistenten mithilfe von MCP

Greifen Sie direkt von KI-Assistenten auf Ihre Hedy-Sitzungen, Highlights und Aufgaben zu, indem Sie das Model Context Protocol (MCP) verwenden.

Vor über 2 Wochen aktualisiert

Was ist der Hedy MCP Server?

Der Hedy MCP Server ermöglicht KI-Assistenten, sicher auf Ihre Hedy-Daten zuzugreifen und diese zu organisieren. Nach der Verbindung können Sie Ihren KI-Assistenten bitten, Besprechungstranskripte zu analysieren, Highlights zu suchen, Aktionspunkte zu überprüfen, Themen zu erstellen und Ihre Sitzungskontexte zu verwalten – alles durch natürliche Konversation.

MCP (Model Context Protocol) ist ein offener Standard, der es KI-Anwendungen ermöglicht, sich mit externen Datenquellen zu verbinden. Der Hedy MCP Server verwendet OAuth-Authentifizierung, was ihn mit webgestützten KI-Plattformen, Desktop-Anwendungen und Entwicklungstools kompatibel macht.

So verbinden Sie sich

Schritt 1: Fügen Sie den Server hinzu

  1. Öffnen Sie die MCP-Servereinstellungen Ihres KI-Clients

  2. Suchen Sie nach "MCP Server hinzufügen", "Remote Server verbinden" oder "Integration hinzufügen"

  3. Geben Sie die Server-URL ein: https://api.hedy.bot/mcp

  4. Klicken Sie auf "Hinzufügen" oder "Verbinden"

Schritt 2: Zugriff autorisieren

  1. Ihr KI-Client öffnet ein Browserfenster

  2. Melden Sie sich mit Ihrem Hedy-Konto an

  3. Überprüfen Sie die angeforderten Berechtigungen

  4. Klicken Sie auf "Zulassen", um den Zugriff zu autorisieren

  5. Kehren Sie zu Ihrem KI-Client zurück

Das ist schon alles! Keine Konfigurationsdateien oder API-Schlüssel erforderlich.

Kompatible KI-Clients

Funktioniert mit jedem MCP-kompatiblen Client, der Remote-Server unterstützt:

  • Webgestützte KI-Plattformen - Browsergestützte KI-Assistenten

  • Desktop-Anwendungen - Claude Desktop, Cursor, Windsurf, Zed

  • Entwicklungstools - VS Code mit GitHub Copilot, Cline, Claude Code

  • KI-Agent-Plattformen - Benutzerdefinierte Workflow-Builder

Setupanleitung nach Client

Claude Code (CLI)

Fügen Sie den Hedy MCP Server mit einem einzigen Befehl hinzu:

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

Dies startet den OAuth-Flow in Ihrem Browser. Melden Sie sich mit Ihrem Hedy-Konto an und autorisieren Sie den Zugriff.

Claude Desktop (Pro/Max/Team/Enterprise)

  1. Öffnen Sie Claude Desktop und gehen Sie zu Einstellungen

  2. Scrollen Sie zu Integrationen unten

  3. Klicken Sie auf Mehr hinzufügen (oder Integration hinzufügen)

  4. Geben Sie ein:

    • Integrationsname: Hedy

    • Integrations-URL: https://api.hedy.bot/mcp

  5. Klicken Sie auf Verbinden und schließen Sie den OAuth-Flow in Ihrem Browser ab

  6. Klicken Sie in neuen Chats auf das Tools-Symbol, um Hedy-Tools zu aktivieren

Hinweis: Kostenlose Benutzer müssen die mcp-remote Bridge verwenden. Siehe die Project README für die Konfiguration.

Cline (VS Code Extension)

Option 1: Über Cline UI (empfohlen)

  1. Öffnen Sie VS Code mit der installierten Cline-Erweiterung

  2. Klicken Sie auf das Cline-Symbol in der Seitenleiste

  3. Klicken Sie auf das Menü (⋮) und wählen Sie "MCP Server"

  4. Wählen Sie die Registerkarte "Remote Server"

  5. Geben Sie ein: Servername: hedy, Server-URL: https://api.hedy.bot/mcp, Transporttyp: Streamable HTTP

  6. Klicken Sie auf "Server hinzufügen"

  7. Klicken Sie auf "Authentifizieren", wenn Sie dazu aufgefordert werden, und schließen Sie den OAuth-Flow in Ihrem Browser ab

Option 2: Manuelle JSON-Konfiguration

  1. Öffnen Sie die Cline MCP-Einstellungsdatei:

    • 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. Fügen Sie diese Konfiguration hinzu:

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

  3. Speichern Sie die Datei und starten Sie VS Code neu

  4. Der OAuth-Flow wird ausgelöst, wenn Cline versucht, den Server zu verwenden

Cursor / Windsurf / Andere IDE-Tools

  1. Öffnen Sie die MCP-Einstellungen in Ihrer IDE

  2. Fügen Sie die Server-URL hinzu: https://api.hedy.bot/mcp

  3. Wählen Sie "HTTP" oder "Streamable HTTP" als Transporttyp

  4. Autorisieren Sie bei Aufforderung

Webgestützte KI-Clients

  1. Suchen Sie nach "MCP Server verbinden" oder "Integration hinzufügen"

  2. Geben Sie ein: https://api.hedy.bot/mcp

  3. Schließen Sie die OAuth-Autorisierung in Ihrem Browser ab

Verfügbare Tools

Der Hedy MCP Server bietet 18 Tools, die Ihr KI-Assistent verwenden kann, um auf Ihre Besprechungsdaten zuzugreifen und diese zu organisieren:

Sitzungs-Tools

GetSessions

Funktion: Listet Ihre letzten Besprechungssitzungen auf, sortiert nach Startzeit (neueste zuerst)

Parameter:

  • limit (optional) - Anzahl der zurückzugebenden Sitzungen (1-100)

  • after (optional) - Sitzungs-ID zum Starten der Pagination nach

Beispielanfragen:

  • "Zeige mir meine letzten 10 Sitzungen"

  • "Liste alle Sitzungen von dieser Woche auf"

  • "Welche Meetings hatte ich kürzlich?"

GetSessionDetails

Funktion: Ruft vollständige Details für eine bestimmte Sitzung ab, einschließlich Metadaten, Teilnehmer und Transkript

Parameter:

  • sessionId (erforderlich) - Die ID der Sitzung

Beispielanfragen:

  • "Zeige mir die Details der Sitzung ABC123"

  • "Was wurde in meinem letzten Team-Meeting besprochen?"

  • "Hol das Transkript für die Produktstart-Sitzung"

GetSessionHighlights

Funktion: Gibt alle Highlights zurück, die während einer bestimmten Sitzung erfasst wurden

Parameter:

  • sessionId (erforderlich) - Die ID der Sitzung

Beispielanfragen:

  • "Welche Highlights habe ich in Sitzung ABC123 gespeichert?"

  • "Zeige mir die Highlights von gestern's Standup"

  • "Liste alle Highlights aus dem Budget-Meeting auf"

GetSessionToDos

Funktion: Listet alle To-Do-Elemente auf, die während einer bestimmten Sitzung generiert wurden

Parameter:

  • sessionId (erforderlich) - Die ID der Sitzung

  • includeCompleted (optional) - Falls wahr, umfasst abgeschlossene Aufgaben (Standard: nur offene Aufgaben)

Beispielanfragen:

  • "Welche Aktionspunkte stammten aus Sitzung ABC123?"

  • "Zeige mir Aufgaben aus dem Kundemeeting, einschließlich abgeschlossener Aufgaben"

  • "Liste ausstehende Aufgaben aus der gestrigen Planungssitzung auf"

Highlight-Tools

GetHighlights

Funktion: Listet Ihre letzten Highlights über alle Sitzungen hinweg auf, sortiert nach neuesten zuerst

Parameter:

  • limit (optional) - Anzahl der zurückzugebenden Highlights (1-100)

  • after (optional) - Highlight-ID zum Starten der Pagination nach

Beispielanfragen:

  • "Zeige mir meine letzten 20 Highlights"

  • "Was habe ich diese Woche hervorgehoben?"

  • "Liste kürzlich gespeicherte Highlights auf"

GetHighlightDetails

Funktion: Ruft vollständige Details für ein bestimmtes Highlight ab, einschließlich Transkriptschnipsel, Zeitstempel und Kontext

Parameter:

  • highlightId (erforderlich) - Die ID des Highlights

Beispielanfragen:

  • "Zeige mir Highlight XYZ789 im Detail"

  • "Was war der Kontext um dieses Budget-Highlight?"

  • "Hol das vollständige Transkript für Highlight XYZ789"

Aufgaben-Tools

GetToDos

Funktion: Gibt alle To-Do-Elemente über alle Ihre Sitzungen hinweg zurück

Parameter:

  • includeCompleted (optional) - Falls wahr, umfasst abgeschlossene Aufgaben (Standard: nur offene Aufgaben)

Beispielanfragen:

  • "Was sind alle meine ausstehenden Aktionspunkte?"

  • "Zeige mir alle Aufgaben, einschließlich abgeschlossener Aufgaben"

  • "Liste alles auf, was ich aus meinen Meetings tun muss"

Themen-Tools

KI-Assistenten können Ihre Themen ansehen und Ihnen auch helfen, diese zu organisieren, indem Sie neue Themen erstellen, vorhandene aktualisieren oder Themen entfernen, die Sie nicht mehr benötigen.

GetAllTopics

Funktion: Listet alle Ihre Meeting-Themen und Ordner auf

Parameter:

  • includeArchived (optional) - Falls wahr, umfasst archivierte Themen (Standard: nur aktive Themen)

Beispielanfragen:

  • "Welche Themen habe ich in Hedy?"

  • "Liste alle meine Meeting-Kategorien auf"

  • "Zeige mir alle Themen, einschließlich archivierter Themen"

GetTopicDetails

Funktion: Ruft Details für ein bestimmtes Thema ab, einschließlich Beschreibung, Sitzungsanzahl und KI-generierter Erkenntnisse

Parameter:

  • topicId (erforderlich) - Die ID des Themas

Beispielanfragen:

  • "Zeige mir Details für das Thema Kundenmeetings"

  • "Wie viele Sitzungen sind in meinem Thema Team Standups?"

  • "Welche Erkenntnisse hat Hedy über mein Thema Produktplanung?"

GetTopicSessions

Funktion: Listet alle Sitzungen auf, die einem bestimmten Thema zugeordnet sind

Parameter:

  • topicId (erforderlich) - Die ID des Themas

Beispielanfragen:

  • "Zeige mir alle Sitzungen im Thema Produktplanung"

  • "Liste Meetings mit dem Tag Kundenmeetings auf"

  • "Welche Sitzungen sind in meinem Ordner 1:1s?"

CreateTopic

Funktion: Erstellt ein neues Thema zur Organisierung Ihrer Besprechungssitzungen

Parameter:

  • name (erforderlich) - Name des Themas (max. 100 Zeichen)

  • description (optional) - Beschreibung des Themas (max. 500 Zeichen)

  • color (optional) - Farbe für das Thema (z.B. #FF5733)

  • iconName (optional) - Symbol name für das Thema

  • topicContext (optional) - Benutzerdefinierte Anweisungen für die KI-Analyse von Sitzungen in diesem Thema

Beispielanfragen:

  • "Erstelle ein neues Thema namens Q1 Planung"

  • "Erstelle ein Thema für Kundengespräche in blauer Farbe"

  • "Richte eine neue Kategorie für Interview-Sitzungen ein"

UpdateTopic

Funktion: Aktualisiert den Namen, die Beschreibung, die Farbe oder andere Einstellungen eines vorhandenen Themas

Parameter:

  • topicId (erforderlich) - Die ID des zu aktualisierenden Themas

  • name (optional) - Neuer Name für das Thema

  • description (optional) - Neue Beschreibung

  • color (optional) - Neue Farbe

  • iconName (optional) - Neues Symbol

  • topicContext (optional) - Neue benutzerdefinierte Anweisungen für die KI-Analyse

Beispielanfragen:

  • "Benenne das Thema Q1 Planung in Q2 Planung um"

  • "Ändere die Farbe meines Themas Kundenmeetings in Grün"

  • "Aktualisiere die Beschreibung meines Themas Team Standups"

DeleteTopic

Funktion: Entfernt ein Thema. Sitzungen, die sich zuvor in dem Thema befanden, bleiben erhalten, werden aber nicht mehr darunter gruppiert.

Parameter:

  • topicId (erforderlich) - Die ID des zu entfernenden Themas

Beispielanfragen:

  • "Lösche das alte Thema Projekt Alpha"

  • "Entferne mein ungenutztes Thema Interview Prep"

  • "Lösche das Thema namens Test"

Sitzungskontext-Tools

Sitzungskontexte ermöglichen es Ihnen, Hintergrund Informationen bereitzustellen, die Hedy bei der Analyse Ihrer Meetings verwendet. KI-Assistenten können Ihnen dabei helfen, diese Kontexte anzusehen und zu verwalten.

ListSessionContexts

Funktion: Listet alle Ihre gespeicherten Sitzungskontexte auf, sortiert nach zuletzt aktualisiert

Beispielanfragen:

  • "Zeige mir alle meine Sitzungskontexte"

  • "Welche Background-Kontexte habe ich eingerichtet?"

  • "Liste meine Meeting-Kontextprofile auf"

GetSessionContext

Funktion: Ruft die Details eines bestimmten Sitzungskontexts ab

Parameter:

  • contextId (erforderlich) - Die ID des abzurufenden Kontexts

Beispielanfragen:

  • "Zeige mir die Details meines Work-Kontexts"

  • "Was ist in meinem Standard-Sitzungskontext?"

CreateSessionContext

Funktion: Erstellt einen neuen Sitzungskontext mit Hintergrund Informationen für Hedy zur Verwendung während der Analyse

Parameter:

  • title (erforderlich) - Titel für den Kontext (max. 200 Zeichen)

  • content (optional) - Die Hintergrund Informationen und Anweisungen

  • isDefault (optional) - Legen Sie dies als Ihren Standard-Kontext fest

Beispielanfragen:

  • "Erstelle einen neuen Kontext namens Sales Calls mit Informationen über meine Produkte"

  • "Richte einen Kontext für meine Engineering Team Meetings ein"

  • "Erstelle einen neuen Standard-Kontext mit meiner Jobrolle und meinen Verantwortungen"

UpdateSessionContext

Funktion: Aktualisiert einen vorhandenen Sitzungskontext

Parameter:

  • contextId (erforderlich) - Die ID des zu aktualisierenden Kontexts

  • title (optional) - Neuer Titel

  • content (optional) - Neue Hintergrund Informationen

  • isDefault (optional) - Als Standard-Kontext festlegen

Beispielanfragen:

  • "Aktualisiere meinen Work-Kontext mit meiner neuen Team-Struktur"

  • "Füge Informationen über unsere Q2-Ziele zu meinem Standard-Kontext hinzu"

  • "Ändere meinen Sales-Kontext zum Standard"

DeleteSessionContext

Funktion: Entfernt einen Sitzungskontext. Wenn Sie Ihren Standard-Kontext löschen, wird automatisch ein anderer zum Standard.

Parameter:

  • contextId (erforderlich) - Die ID des zu entfernenden Kontexts

Beispielanfragen:

  • "Lösche meinen alten Kontext Projekt X"

  • "Entferne den Kontext, den ich nicht mehr verwende"

Beispiel-Workflows

Wöchentliche Überprüfung

Fragen Sie Ihre KI: "Zeige mir meine Sitzungen von dieser Woche, liste alle ausstehenden Aufgaben auf und hebe wichtige Punkte hervor"

Was passiert: Die KI verwendet GetSessions mit Datumfilterung, dann GetToDos, um Aktionspunkte zu finden, und kann detailliert in spezifische Sitzungen eindringen.

Meeting Vorbereitung

Fragen Sie Ihre KI: "Finde alle Sitzungen über die Q4-Roadmap und fasse die Hauptpunkte zusammen"

Was passiert: Die KI durchsucht Sitzungen, verwendet GetSessionDetails und GetSessionHighlights, um Informationen zu sammeln, und erstellt dann eine Zusammenfassung.

Aufgabenverwaltung

Fragen Sie Ihre KI: "Zeige mir alle Aktionspunkte aus Kundenmeetings diesen Monat"

Was passiert: Die KI verwendet GetAllTopics, um das Thema Kundenmeetings zu finden, GetTopicSessions, um Sitzungen aufzulisten, dann GetSessionToDos für jede, um die Liste zu kompilieren.

Themenanalyse

Fragen Sie Ihre KI: "Analysiere meine Team Standup-Sitzungen und identifiziere wiederkehrende Themen"

Was passiert: Die KI findet das Thema, ruft alle Sitzungen darin ab, liest Transkripte und Highlights, führt dann eine Analyse durch.

Organisieren Ihrer Daten

Fragen Sie Ihre KI: "Erstelle ein neues Thema namens Q2 Planung und richte einen Kontext für unsere vierteljährlichen Überprüfungen ein"

Was passiert: Die KI verwendet CreateTopic, um das neue Thema zu erstellen, dann CreateSessionContext, um Hintergrund Informationen für eine bessere Meeting-Analyse einzurichten.

Datenschutz und Sicherheit

  • OAuth 2.1 mit PKCE - Sichere Industriestandard-Authentifizierung

  • Sie kontrollieren den Zugriff - Autorisieren Sie genau, was die KI mit Ihren Daten tun darf

  • Sitzungsdaten sind geschützt - Die KI kann Ihnen helfen, Themen und Kontexte zu organisieren, kann aber Ihre Meeting-Aufnahmen oder Transkripte nicht löschen

  • Nur auf Anfrage - Auf Daten wird nur zugegriffen, wenn Sie Anfragen stellen

  • Jederzeit widerrufen - Sie können den KI-Zugriff jederzeit aus Ihren Hedy-Einstellungen trennen

Anforderungen

  • Aktives Hedy-Abonnement (Pro oder Premium)

  • Cloud-Synchronisierung in Ihren Hedy-Einstellungen aktiviert

  • Ein KI-Assistent, der MCP unterstützt (wie Claude)

Fehlerbehebung

KI-Client hat keine Option "MCP Server hinzufügen"

  • Überprüfen Sie, ob Ihr Client Remote MCP Server unterstützt

  • Aktualisieren Sie auf die neueste Version

  • Suchen Sie in den Einstellungen nach MCP-Einstellungen

  • Einige Clients unterstützen nur lokale Server und benötigen manuelle Konfiguration

Autorisierung schlägt fehl

  • Stellen Sie sicher, dass Sie bei Hedy angemeldet sind

  • Überprüfen Sie, ob Ihr Konto aktiv ist

  • Löschen Sie den Browser-Cache und versuchen Sie erneut

  • Überprüfen Sie Ihre Internetverbindung

  • Versuchen Sie, https://api.hedy.bot/mcp/.well-known/oauth-protected-resource zu öffnen, um zu überprüfen, ob der Server zugänglich ist

KI kann auf meine Daten nicht zugreifen

  • Bestätigen Sie, dass die OAuth-Autorisierung abgeschlossen ist

  • Überprüfen Sie, ob Sie Sitzungen in Ihrem Hedy-Konto haben

  • Überprüfen Sie den Autorisierungsstatus in den Einstellungen des KI-Clients

  • Versuchen Sie, die Verbindung zu trennen und erneut zu verbinden

Verbindung funktioniert nicht mehr

  • Das Zugriffs token ist möglicherweise abgelaufen – autorisieren Sie erneut

  • Wenn Sie Ihr Hedy-Passwort geändert haben, autorisieren Sie erneut

  • Überprüfen Sie status.hedy.bot auf Serviceproblemen

  • Entfernen und fügen Sie den Server erneut hinzu

Client benötigt manuelle OAuth-Konfiguration

  • Wenn Ihr Client die automatische Erkennung nicht unterstützt, verwenden Sie diese Einstellungen:

    • Autorisierungs-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

KI sagt, dass ein Tool fehlgeschlagen ist oder einen Fehler zurückgegeben hat

  • Überprüfen Sie, ob die Sitzungs-/Highlight-/Thema-ID gültig ist

  • Überprüfen Sie, ob Sie die Berechtigung haben, auf diese Daten zuzugreifen

  • Stellen Sie sicher, dass die angeforderten Daten in Ihrem Konto vorhanden sind

  • Versuchen Sie, spezifischer zu fragen (z.B. Sitzungstitel statt IDs einfügen)

  • Überprüfen Sie die Ratenbegrenzung – warten Sie einen Moment und versuchen Sie erneut

Best Practices

Für bessere Ergebnisse

  • Verwenden Sie klare Sitzungstitel - Macht es für die KI leichter, sie zu finden

  • Organisieren Sie mit Themen - Gruppieren Sie verwandte Sitzungen zusammen

  • Erstellen Sie Highlights während Meetings - Hilft der KI, Hauptmomente zu identifizieren

  • Fügen Sie beschreibende Notizen zu Aufgaben hinzu - Macht Aktionspunkte besser durchsuchbar

  • Seien Sie spezifisch in Anfragen - Inkludieren Sie Daten, Themen oder Stichwörter

Bei Anfragen an Ihre KI

  • Geben Sie Zeiträume an - "Sitzungen aus der letzten Woche zeigen" ist klarer als "Aktuelle Sitzungen zeigen"

  • Erwähnen Sie Themen wenn relevant - "Kundenmeetings" vs "alle Sitzungen"

  • Fragen Sie nach Zusammenfassungen - Die KI kann Daten aus mehreren Tools synthetisieren

  • Fordern Sie spezifische Formate an - "Erstelle eine Aufzählung" oder "Mache eine Tabelle"

  • Stellen Sie Anschlussfragen - Die KI kann tiefer in die Ergebnisse eindringen

Profi-Tipp: Die KI kann mehrere Tools in einer Anfrage kombinieren. Versuchen Sie, komplexe Fragen wie "Finde alle ausstehenden Aufgaben aus Kundenmeetings diesen Monat und organisiere sie nach Priorität" oder "Erstelle ein neues Thema für unsere Produktstarts und liste alle Sitzungen auf, die dorthin gehören" zu stellen, um die Stärke der MCP-Integration zu sehen.

Benötigen Sie Hilfe?

  • Überprüfen Sie die MCP-Dokumentation Ihres KI-Clients für spezifische Anweisungen zum Client

  • Besuchen Sie modelcontextprotocol.io für allgemeine MCP-Informationen

  • Wenden Sie sich an den Hedy-Support mit Fehlermeldungen und dem Namen Ihres KI-Clients

Verwandte Artikel
Sitzungen zusammenführen
Hedy API
Hat dies deine Frage beantwortet?