Zum Inhalt springen
Hedy

Hedy mit KI-Assistenten ueber MCP verbinden

Was ist der Hedy MCP Server?

Der Hedy MCP Server ermoeglicht KI-Assistenten den sicheren Zugriff auf Ihre Hedy-Daten und hilft bei deren Organisation. Nach der Verbindung koennen Sie Ihre KI bitten, Meeting-Transkripte zu analysieren, Highlights zu finden, Aufgaben zu pruefen, Themen zu erstellen und Ihre Sitzungskontexte zu verwalten - alles durch natuerliche Konversation.

MCP (Model Context Protocol) ist ein offener Standard, der KI-Anwendungen die Verbindung mit externen Datenquellen ermoeglicht. Der Hedy MCP Server verwendet OAuth-Authentifizierung und ist damit kompatibel mit webbasierten KI-Plattformen, Desktop-Anwendungen und Entwicklungswerkzeugen.

So verbinden Sie sich

Schritt 1: Server hinzufuegen

  1. Oeffnen Sie die MCP-Server-Einstellungen Ihres KI-Clients

  2. Suchen Sie nach “Add MCP Server”, “Connect Remote Server” oder “Add Integration”

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

  4. Klicken Sie auf “Add” oder “Connect”

Schritt 2: Zugriff autorisieren

  1. Ihr KI-Client oeffnet ein Browserfenster

  2. Melden Sie sich mit Ihrem Hedy-Konto an

  3. Pruefen Sie die angeforderten Berechtigungen

  4. Klicken Sie auf “Allow”, um den Zugriff zu autorisieren

  5. Kehren Sie zu Ihrem KI-Client zurueck

Das war’s! Keine Konfigurationsdateien oder API Keys erforderlich.

Kompatible KI-Clients

Funktioniert mit jedem MCP-kompatiblen Client, der Remote-Server unterstuetzt:

  • Webbasierte KI-Plattformen - Ueber den Browser zugaengliche KI-Assistenten

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

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

  • KI-Agenten-Plattformen - Benutzerdefinierte Workflow-Builder

Einrichtungsanleitungen nach Client

Claude Code (CLI)

Fuegen Sie den Hedy MCP Server mit einem einzigen Befehl hinzu:

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

Dadurch wird der OAuth-Flow in Ihrem Browser ausgeloest. Melden Sie sich mit Ihrem Hedy-Konto an und autorisieren Sie den Zugriff.

Claude Desktop (Pro/Max/Team/Enterprise)

  1. Oeffnen Sie Claude Desktop und gehen Sie zu Settings

  2. Scrollen Sie nach unten zu Integrations

  3. Klicken Sie auf Add more (oder Add integration)

  4. Geben Sie ein:

    • Integration name: Hedy

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

  5. Klicken Sie auf Connect und schliessen Sie den OAuth-Flow in Ihrem Browser ab

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

Hinweis: Nutzer der kostenlosen Stufe muessen die mcp-remote-Bridge verwenden. Siehe die Projekt-README fuer die Konfiguration.

Cline (VS Code Extension)

Option 1: Ueber die Cline-Oberflaeche (empfohlen)

  1. Oeffnen Sie VS Code mit installierter Cline-Extension

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

  3. Klicken Sie auf das Menue (drei Punkte) und waehlen Sie “MCP Servers”

  4. Waehlen Sie den Tab “Remote Servers”

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

  6. Klicken Sie auf “Add Server”

  7. Klicken Sie auf “Authenticate”, wenn Sie dazu aufgefordert werden, und schliessen Sie den OAuth-Flow in Ihrem Browser ab

Option 2: Manuelle JSON-Konfiguration

  1. Oeffnen 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. Fuegen 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 ausgeloest, wenn Cline versucht, den Server zu verwenden

BoltAI (macOS)

BoltAI verbindet sich ueber lokale Konfiguration mit MCP-Servern. Da BoltAI remote OAuth-Server nicht nativ unterstuetzt, benoetigen Sie die mcp-remote-Bridge.

Voraussetzungen: Node.js muss auf Ihrem Mac installiert sein (node -v zur Pruefung).

  1. Oeffnen Sie BoltAI -> Settings -> Plugins, klicken Sie auf die +-Schaltflaeche, um mcp.json zu oeffnen

  2. Fuegen Sie folgende Konfiguration hinzu:

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

  3. Klicken Sie auf Save Changes

  4. Bei der ersten Verwendung oeffnet sich ein Browserfenster - melden Sie sich mit Ihrem Hedy-Konto an und autorisieren Sie den Zugriff

Hinweis: Die mcp-remote-Bridge uebersetzt den Remote-OAuth-faehigen Server in eine lokale stdio-Verbindung, die BoltAI verarbeiten kann. Nach der ersten Autorisierung wird der Token lokal zwischengespeichert.

Cursor / Windsurf / Andere IDE-Tools

  1. Oeffnen Sie die MCP-Einstellungen in Ihrer IDE

  2. Fuegen Sie die Server-URL hinzu: https://api.hedy.bot/mcp

  3. Waehlen Sie “HTTP” oder “Streamable HTTP” als Transport-Typ

  4. Autorisieren Sie, wenn Sie dazu aufgefordert werden

Webbasierte KI-Clients

  1. Suchen Sie “Connect MCP Server” oder “Add Integration”

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

  3. Schliessen Sie die OAuth-Autorisierung in Ihrem Browser ab

Verfuegbare Tools

Der Hedy MCP Server stellt 18 Tools bereit, die Ihr KI-Assistent verwenden kann, um auf Ihre Meeting-Daten zuzugreifen und diese zu organisieren:

Sitzungs-Tools

GetSessions

Was es tut: Listet Ihre letzten Meeting-Sitzungen auf, sortiert nach Startzeit (neueste zuerst)

Parameter:

  • limit (optional) - Anzahl der zurueckzugebenden Sitzungen (1-100)

  • after (optional) - Sitzungs-ID fuer die Paginierung

Beispielanfragen:

  • “Zeige mir meine letzten 10 Sitzungen”

  • “Liste alle Sitzungen dieser Woche auf”

  • “Welche Meetings hatte ich kuerzlich?”

GetSessionDetails

Was es tut: Ruft vollstaendige Details fuer eine bestimmte Sitzung ab, einschliesslich Metadaten, Teilnehmer und Transkript

Parameter:

  • sessionId (erforderlich) - Die ID der Sitzung

Beispielanfragen:

  • “Zeige mir die Details der Sitzung ABC123”

  • “Was wurde in meinem letzten Teammeeting besprochen?”

  • “Hole das Transkript fuer die Produktlaunch-Sitzung”

GetSessionHighlights

Was es tut: Gibt alle waehrend einer bestimmten Sitzung erfassten Highlights zurueck

Parameter:

  • sessionId (erforderlich) - Die ID der Sitzung

Beispielanfragen:

  • “Welche Highlights habe ich in Sitzung ABC123 gespeichert?”

  • “Zeige mir die wichtigsten Momente aus dem gestrigen Standup”

  • “Liste alle Highlights aus dem Budget-Meeting auf”

GetSessionToDos

Was es tut: Listet alle waehrend einer bestimmten Sitzung erstellten Aufgaben auf

Parameter:

  • sessionId (erforderlich) - Die ID der Sitzung

  • includeCompleted (optional) - Falls true, werden auch erledigte Aufgaben einbezogen (Standard: nur offene Aufgaben)

Beispielanfragen:

  • “Welche Aufgaben kamen aus Sitzung ABC123?”

  • “Zeige mir die Aufgaben aus dem Kundenmeeting, einschliesslich erledigter”

  • “Liste offene Aufgaben aus der gestrigen Planungssitzung auf”

Highlight-Tools

GetHighlights

Was es tut: Listet Ihre letzten Highlights ueber alle Sitzungen hinweg auf, sortiert nach neuesten zuerst

Parameter:

  • limit (optional) - Anzahl der zurueckzugebenden Highlights (1-100)

  • after (optional) - Highlight-ID fuer die Paginierung

Beispielanfragen:

  • “Zeige mir meine letzten 20 Highlights”

  • “Was habe ich diese Woche markiert?”

  • “Liste die letzten wichtigen Momente auf, die ich gespeichert habe”

GetHighlightDetails

Was es tut: Ruft vollstaendige Details fuer ein bestimmtes Highlight ab, einschliesslich Transkript-Auszug, Zeitstempel und Kontext

Parameter:

  • highlightId (erforderlich) - Die ID des Highlights

Beispielanfragen:

  • “Zeige mir Highlight XYZ789 im Detail”

  • “Was war der Kontext rund um das Budget-Highlight?”

  • “Hole das vollstaendige Transkript fuer Highlight XYZ789”

Aufgaben-Tools

GetToDos

Was es tut: Gibt alle Aufgaben ueber alle Ihre Sitzungen hinweg zurueck

Parameter:

  • includeCompleted (optional) - Falls true, werden auch erledigte Aufgaben einbezogen (Standard: nur offene Aufgaben)

Beispielanfragen:

  • “Was sind alle meine offenen Aufgaben?”

  • “Zeige mir alle Aufgaben, einschliesslich erledigter”

  • “Liste alles auf, was ich aus meinen Meetings erledigen muss”

Themen-Tools

KI-Assistenten koennen Ihre Themen einsehen und Ihnen bei der Organisation helfen, indem sie neue Themen erstellen, bestehende aktualisieren oder nicht mehr benoetigte Themen entfernen.

GetAllTopics

Was es tut: Listet alle Ihre Meeting-Themen und Ordner auf

Parameter:

  • includeArchived (optional) - Falls true, werden auch archivierte Themen einbezogen (Standard: nur aktive Themen)

Beispielanfragen:

  • “Welche Themen habe ich in Hedy?”

  • “Liste alle meine Meeting-Kategorien auf”

  • “Zeige mir alle Themen einschliesslich archivierter”

GetTopicDetails

Was es tut: Ruft Details fuer ein bestimmtes Thema ab, einschliesslich Beschreibung, Sitzungsanzahl und KI-generierter Erkenntnisse

Parameter:

  • topicId (erforderlich) - Die ID des Themas

Beispielanfragen:

  • “Zeige mir Details fuer das Thema Kundenmeetings”

  • “Wie viele Sitzungen sind in meinem Thema Team-Standups?”

  • “Welche Erkenntnisse hat Hedy zu meinem Thema Produktplanung?”

GetTopicSessions

Was es tut: 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 auf, die mit Kundenmeetings markiert sind”

  • “Welche Sitzungen sind in meinem 1:1s-Ordner?”

CreateTopic

Was es tut: Erstellt ein neues Thema zur Organisation Ihrer Meeting-Sitzungen

Parameter:

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

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

  • color (optional) - Farbe fuer das Thema (z.B. #FF5733)

  • iconName (optional) - Symbolname fuer das Thema

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

Beispielanfragen:

  • “Erstelle ein neues Thema namens Q1 Planung”

  • “Lege ein Thema fuer Kundenanrufe mit blauer Farbe an”

  • “Richte eine neue Kategorie fuer Interview-Sitzungen ein”

UpdateTopic

Was es tut: Aktualisiert den Namen, die Beschreibung, Farbe oder andere Einstellungen eines bestehenden Themas

Parameter:

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

  • name (optional) - Neuer Name fuer das Thema

  • description (optional) - Neue Beschreibung

  • color (optional) - Neue Farbe

  • iconName (optional) - Neues Symbol

  • topicContext (optional) - Neue benutzerdefinierte Anweisungen fuer die KI-Analyse

Beispielanfragen:

  • “Benenne das Thema Q1 Planung in Q2 Planung um”

  • “Aendere die Farbe meines Themas Kundenmeetings auf Gruen”

  • “Aktualisiere die Beschreibung fuer mein Thema Team-Standups”

DeleteTopic

Was es tut: Entfernt ein Thema. Sitzungen, die zuvor im Thema waren, bleiben erhalten, sind aber nicht mehr darunter gruppiert.

Parameter:

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

Beispielanfragen:

  • “Loesche das alte Thema Projekt Alpha”

  • “Entferne mein ungenutztes Thema Interview-Vorbereitung”

  • “Loesche das Thema namens Test”

Sitzungskontext-Tools

Sitzungskontexte ermoeglichen es Ihnen, Hintergrundinformationen bereitzustellen, die Hedy bei der Analyse Ihrer Meetings verwendet. KI-Assistenten koennen Ihnen helfen, diese Kontexte anzuzeigen und zu verwalten.

ListSessionContexts

Was es tut: Listet alle Ihre gespeicherten Sitzungskontexte auf, sortiert nach letzter Aktualisierung

Beispielanfragen:

  • “Zeige mir alle meine Sitzungskontexte”

  • “Welche Hintergrundkontexte habe ich eingerichtet?”

  • “Liste meine Meeting-Kontextprofile auf”

GetSessionContext

Was es tut: Ruft die Details eines bestimmten Sitzungskontexts ab

Parameter:

  • contextId (erforderlich) - Die ID des abzurufenden Kontexts

Beispielanfragen:

  • “Zeige mir die Details meines Arbeitskontexts”

  • “Was steht in meinem Standard-Sitzungskontext?”

CreateSessionContext

Was es tut: Erstellt einen neuen Sitzungskontext mit Hintergrundinformationen, die Hedy waehrend der Analyse verwendet

Parameter:

  • title (erforderlich) - Titel fuer den Kontext (max. 200 Zeichen)

  • content (optional) - Die Hintergrundinformationen und Anweisungen

  • isDefault (optional) - Als Standardkontext festlegen

Beispielanfragen:

  • “Erstelle einen neuen Kontext namens Vertriebsgespraeche mit Informationen zu meinen Produkten”

  • “Richte einen Kontext fuer meine Engineering-Team-Meetings ein”

  • “Erstelle einen neuen Standardkontext mit meiner Berufsrolle und Verantwortlichkeiten”

UpdateSessionContext

Was es tut: Aktualisiert einen bestehenden Sitzungskontext

Parameter:

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

  • title (optional) - Neuer Titel

  • content (optional) - Neue Hintergrundinformationen

  • isDefault (optional) - Als Standardkontext festlegen

Beispielanfragen:

  • “Aktualisiere meinen Arbeitskontext mit meiner neuen Teamstruktur”

  • “Fuege Informationen zu unseren Q2-Zielen zu meinem Standardkontext hinzu”

  • “Aendere meinen Vertriebskontext zum Standard”

DeleteSessionContext

Was es tut: Entfernt einen Sitzungskontext. Wenn Sie Ihren Standardkontext loeschen, wird automatisch ein anderer zum Standard.

Parameter:

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

Beispielanfragen:

  • “Loesche meinen alten Projekt-X-Kontext”

  • “Entferne den Kontext, den ich nicht mehr verwende”

Beispiel-Workflows

Wochenrueckblick

Fragen Sie Ihre KI: “Zeige mir meine Sitzungen dieser Woche, liste alle offenen Aufgaben auf und hebe wichtige Punkte hervor”

Was passiert: Die KI verwendet GetSessions mit Datumsfilterung, dann GetToDos, um Aufgaben zu finden, und kann fuer Details in bestimmte Sitzungen eintauchen.

Meeting-Vorbereitung

Fragen Sie Ihre KI: “Finde alle Sitzungen zur Q4-Roadmap und fasse die Kernpunkte 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 Aufgaben aus Kundenmeetings dieses Monats”

Was passiert: Die KI verwendet GetAllTopics, um das Thema Kundenmeetings zu finden, GetTopicSessions, um Sitzungen aufzulisten, und dann GetSessionToDos fuer jede Sitzung, um die Liste zusammenzustellen.

Themenanalyse

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

Was passiert: Die KI findet das Thema, ruft alle enthaltenen Sitzungen ab, liest Transkripte und Highlights und fuehrt dann die Analyse durch.

Ihre Daten organisieren

Fragen Sie Ihre KI: “Erstelle ein neues Thema namens Q2 Planung und richte einen Kontext fuer unsere Quartalsberichte ein”

Was passiert: Die KI verwendet CreateTopic, um das neue Thema zu erstellen, und dann CreateSessionContext, um Hintergrundinformationen fuer eine bessere Meeting-Analyse einzurichten.

Datenschutz und Sicherheit

  • OAuth 2.1 mit PKCE - Sichere, branchenstandard-konforme Authentifizierung

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

  • Sitzungsdaten sind geschuetzt - Die KI kann bei der Organisation von Themen und Kontexten helfen, kann aber Ihre Meeting-Aufnahmen oder Transkripte nicht loeschen

  • Nur auf Anfrage - Daten werden nur abgerufen, wenn Sie Anfragen stellen

  • Jederzeit widerrufbar - Sie koennen den KI-Zugriff jederzeit in Ihren Hedy-Einstellungen trennen

Voraussetzungen

  • Aktives Hedy-Abonnement (Pro oder Premium)

  • Cloud Sync in Ihren Hedy-Einstellungen aktiviert

  • Ein KI-Assistent, der MCP unterstuetzt (wie Claude)

Fehlerbehebung

KI-Client hat keine Option “Add MCP Server”

  • Pruefen Sie, ob Ihr Client Remote-MCP-Server unterstuetzt

  • Aktualisieren Sie auf die neueste Version

  • Suchen Sie in den Einstellungen nach MCP-Optionen

  • Einige Clients unterstuetzen nur lokale Server und benoetigen manuelle Konfiguration

Autorisierung schlaegt fehl

  • Stellen Sie sicher, dass Sie bei Hedy angemeldet sind

  • Pruefen Sie, ob Ihr Konto aktiv ist

  • Leeren Sie den Browser-Cache und versuchen Sie es erneut

  • Pruefen Sie die Internetverbindung

  • Versuchen Sie, https://api.hedy.bot/mcp/.well-known/oauth-protected-resource aufzurufen, um die Server-Erreichbarkeit zu ueberpruefen

KI kann nicht auf meine Daten zugreifen

  • Bestaetigen Sie, dass die OAuth-Autorisierung abgeschlossen wurde

  • Pruefen Sie, ob Sie Sitzungen in Ihrem Hedy-Konto haben

  • Pruefen Sie den Autorisierungsstatus in den KI-Client-Einstellungen

  • Versuchen Sie, die Verbindung zu trennen und neu herzustellen

Verbindung funktioniert nicht mehr

  • Der Access Token ist moeglicherweise abgelaufen - autorisieren Sie erneut

  • Falls Sie Ihr Hedy-Passwort geaendert haben, autorisieren Sie erneut

  • Pruefen Sie status.hedy.bot auf Servicestoerungenr

  • Entfernen Sie den Server und fuegen Sie ihn erneut hinzu

Client erfordert manuelle OAuth-Konfiguration

  • Falls Ihr Client keine automatische Erkennung unterstuetzt, verwenden Sie diese Einstellungen:

    • 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

KI meldet, dass ein Tool fehlgeschlagen ist oder einen Fehler zurueckgegeben hat

  • Pruefen Sie, ob die Sitzungs-/Highlight-/Themen-ID gueltig ist

  • Stellen Sie sicher, dass Sie Zugriff auf diese Daten haben

  • Ueberpruefen Sie, ob die angeforderten Daten in Ihrem Konto existieren

  • Versuchen Sie, spezifischer zu fragen (z.B. Sitzungstitel statt IDs angeben)

  • Pruefen Sie auf Rate-Limiting - warten Sie einen Moment und versuchen Sie es erneut

Best Practices

Fuer bessere Ergebnisse

  • Verwenden Sie aussagekraeftige Sitzungstitel - Erleichtert der KI das Auffinden

  • Organisieren Sie mit Themen - Gruppieren Sie zusammengehoerige Sitzungen

  • Erstellen Sie Highlights waehrend Meetings - Hilft der KI, wichtige Momente zu identifizieren

  • Fuegen Sie beschreibende Aufgabennotizen hinzu - Macht Aufgaben besser durchsuchbar

  • Seien Sie spezifisch bei Anfragen - Geben Sie Daten, Themen oder Schluesselwoerter an

Bei Anfragen an Ihre KI

  • Geben Sie Zeitraeume an - “Zeige Sitzungen der letzten Woche” ist klarer als “Zeige aktuelle Sitzungen”

  • Erwaehnen Sie Themen, wenn relevant - “Kundenmeetings-Sitzungen” statt “alle Sitzungen”

  • Bitten Sie um Zusammenfassungen - Die KI kann Daten aus mehreren Tools zusammenfassen

  • Fordern Sie bestimmte Formate an - “Erstelle eine Aufzaehlung” oder “Erstelle eine Tabelle”

  • Stellen Sie Nachfragen - Die KI kann tiefer in Ergebnisse eintauchen

Profi-Tipp: Die KI kann mehrere Tools in einer Anfrage kombinieren. Versuchen Sie komplexe Fragen wie “Finde alle offenen Aufgaben aus Kundenmeetings dieses Monats und ordne sie nach Prioritaet” oder “Erstelle ein neues Thema fuer unsere Produktlaunches und liste alle Sitzungen auf, die dazugehoeren sollten”, um die Leistungsfaehigkeit der MCP-Integration zu erleben.

Brauchen Sie Hilfe?

  • Lesen Sie die MCP-Dokumentation Ihres KI-Clients fuer client-spezifische Anleitungen

  • Besuchen Sie modelcontextprotocol.io fuer allgemeine MCP-Informationen

  • Kontaktieren Sie den Hedy-Support mit Fehlermeldungen und dem Namen Ihres KI-Clients

Verwandte Artikel

Audio- und Videodateien in Hedy importieren Online-Videos importieren Bestehende Transkripte in Hedy importieren

Wurde Ihre Frage beantwortet?