Hedy MCP-Server: Entwicklerleitfaden zu 18 Tools und API-Zugriff

Entwicklerleitfaden für den Hedy MCP-Server

Dies ist der technische Begleiter zu unserer ursprünglichen MCP-Launch-Ankündigung. Er dokumentiert den vollständigen Tool-Katalog, das Authentifizierungsmodell und Workflow-Muster für Entwickler, die Claude oder andere MCP-kompatible Clients über Ihren KI-Meeting-Assistenten mit ihren Hedy-Meeting-Daten verbinden – mit 18 verfügbaren Tools und erweiterten API-Funktionen.

Hedy verbindet sich über das Model Context Protocol (MCP) direkt mit Claude und anderen KI-Assistenten. Ihre KI-Tools können auf Ihre Meeting-Daten zugreifen, sie organisieren und damit arbeiten, ohne dass Sie Informationen manuell zwischen Anwendungen kopieren müssen.

Was das konkret bedeutet

Der MCP Server gibt KI-Assistenten wie Claude Desktop über 18 spezialisierte Tools direkten Zugriff auf Ihre Hedy-Daten. Folgendes wird dadurch möglich:

Sitzungsverwaltung
KI-Assistenten können Ihre Meeting-Transkripte, Zusammenfassungen und Erkenntnisse abrufen. Bitten Sie Claude, „die Budgetdiskussion aus dem Kundenmeeting letzte Woche zu finden”, und er zieht die exakte Sitzung mit vollem Kontext heraus.

Topic-Organisation
Erstellen und verwalten Sie Topics programmatisch. Ihre KI kann verwandte Meetings automatisch organisieren, Wissensdatenbanken aus Gesprächsserien aufbauen und die Projektentwicklung über mehrere Sitzungen hinweg verfolgen.

Highlight-Erfassung
Greifen Sie auf gespeicherte Highlights mit ihrer KI-generierten Analyse zu. Erstellen Sie Lernleitfäden aus Vorlesungs-Highlights, kompilieren Sie Entscheidungspunkte aus Business-Meetings oder extrahieren Sie Schlüsselzitate aus Interviews.

Aufgabenintegration
Ziehen Sie To-Do-Einträge direkt in Ihren Workflow. KI-Assistenten können Aufgaben projektübergreifend zusammenfassen, überfällige Tasks identifizieren oder konsolidierte Aufgabenlisten aus mehreren Meetings erstellen.

Technische Implementierung

Der MCP Server läuft unter https://api.hedy.bot/mcp und authentifiziert sich mit Ihrem Hedy API-Schlüssel. Die Konfiguration dauert etwa zwei Minuten:

1. Generieren Sie einen API-Schlüssel in Hedys Kontoeinstellungen
2. Fügen Sie die MCP-Server-URL zu Claude Desktop oder Ihrem bevorzugten MCP-kompatiblen Client hinzu
3. Konfigurieren Sie die Authentifizierung mit Ihrem API-Schlüssel
4. Beginnen Sie, Ihre Meeting-Daten in natürlicher Sprache abzufragen

Die Integration unterstützt sowohl sitzungsbezogene Abfragen („Was haben wir über Preisgestaltung besprochen?”) als auch sitzungsübergreifende Analysen („Zeige mir alle Aufgaben aus Kundenmeetings dieses Monats”).

Datenschutzarchitektur

Die MCP-Integration wahrt Hedys Privacy-First-Design. Daten bleiben bei der Übertragung und im Ruhezustand verschlüsselt. Der MCP Server bietet Lesezugriff auf Ihre Meeting-Daten – KI-Assistenten können Informationen abrufen und analysieren, aber Ihre originalen Sitzungen oder Transkripte nicht verändern.

Die Authentifizierung ist nutzerspezifisch. Nur KI-Tools, die mit Ihrem API-Schlüssel konfiguriert sind, können auf Ihre Daten zugreifen. Schlüssel können bei Bedarf sofort über die Kontoeinstellungen widerrufen werden.

Verfügbare Tools

Der MCP Server bietet 18 spezialisierte Tools, nach Funktion organisiert:

Sitzungszugriff

• Sitzungsdetails mit vollständigen Transkripten und Metadaten abrufen
• Sitzungen mit Filterung nach Datum, Topic oder Typ auflisten
• Sitzungsübergreifend nach bestimmten Inhalten suchen

Topic-Verwaltung

• Topics mit benutzerdefinierten Kontexten und Anweisungen erstellen
• Topics mit Sitzungsanzahl und Metadaten auflisten
• Topic-Details einschließlich aller verknüpften Sitzungen abrufen
• Topic-Konfigurationen programmatisch aktualisieren

Highlights und Aufgaben

• Highlights mit KI-generierten Erkenntnissen abrufen
• To-Dos mit Erledigungsstatus auflisten
• Highlights nach Sitzung oder Topic filtern
• Aufgabendetails mit Fristen und Metadaten abrufen

Praxisanwendungen

Forschungsanalyse
Akademiker nutzen die Integration, um Erkenntnisse über Vorlesungsreihen hinweg zu synthetisieren. Bitten Sie Claude, „die drei theoretischen Rahmenwerke zu vergleichen, die in den Wochen 4–6 besprochen wurden”, und er zieht relevante Inhalte aus mehreren Sitzungen, erstellt Querverweise und generiert eine vergleichende Analyse.

Kundenmanagement
Berater pflegen umfassende Kundenhistorien. Die KI kann „das morgige Meeting mit [Kunde] vorbereiten, indem alle vorherigen Diskussionen über deren Q4-Strategie überprüft werden” und ein Briefing-Dokument mit relevantem Kontext, offenen Verpflichtungen und vorgeschlagenen Gesprächspunkten erstellen.

Wissensmanagement
Teams bauen institutionelles Wissen auf. Die MCP-Integration ermöglicht KI-Assistenten, strukturierte Dokumentationen aus Meeting-Serien zu erstellen, Best Practices aus Retrospektiven zu extrahieren und technische Spezifikationen aus Design-Diskussionen zu kompilieren.

Workflow-Automatisierung
Entwickler integrieren Hedy-Daten in benutzerdefinierte Systeme. Kombinieren Sie MCP-Zugriff mit n8n oder Make.com, um automatisierte Workflows zu erstellen, die Meeting-Erkenntnisse an Projektmanagement-Tools weiterleiten, CRMs aktualisieren oder Follow-up-Aktionen auslösen.

Anforderungen und Kompatibilität

Die MCP-Integration funktioniert mit jedem MCP-kompatiblen Client. Bestätigte kompatible Anwendungen:

• Claude Desktop (macOS und Windows)
• Cline
• Zed
• Benutzerdefinierte Implementierungen mit dem MCP SDK

Ein Hedy Pro Abonnement bietet vollen API-Zugang für die MCP-Integration. Nutzer des kostenlosen Tarifs haben eingeschränkten API-Zugang, der zum Testen, aber nicht für Produktiv-Workflows geeignet ist.

Erste Schritte

Vollständige Einrichtungsanleitungen sind in Hedys Hilfedokumentation verfügbar. Der Konfigurationsprozess umfasst das Generieren eines API-Schlüssels, das Hinzufügen des MCP Servers zu Ihrem KI-Client und das Testen der Verbindung mit einer einfachen Abfrage.

Für Entwickler, die benutzerdefinierte Integrationen erstellen, deckt die API-Dokumentation Authentifizierungsmethoden, Rate Limits und Response-Schemas ab. Der MCP Server unterstützt Standard-MCP-Protokollfunktionen einschließlich Tool-Discovery und Capability-Verhandlung.

Was das ermöglicht

Die MCP-Integration transformiert, wie Fachleute Meeting-Intelligence nutzen. Statt manuell vergangene Sitzungen zu durchsuchen oder Informationen in Dokumente zu kopieren, übernehmen KI-Assistenten die schwere Arbeit – relevanten Kontext finden, Informationen über Gespräche hinweg synthetisieren und handlungsrelevante Erkenntnisse präsentieren.

Das ist wichtig, weil professionelle Arbeit zunehmend in Gesprächen stattfindet. Das in Meetings, Calls und Diskussionen erfasste Wissen repräsentiert bedeutende organisatorische Intelligenz. Die MCP-Integration macht diese Intelligenz für die KI-Tools zugänglich, die Sie bereits für Analyse, Schreiben und Entscheidungsfindung nutzen.

Für Organisationen bedeutet das, dass Meeting-Daten zu einer durchsuchbaren Wissensbasis werden. Für Einzelpersonen bedeutet es, dass jedes Gespräch, das Sie mit Hedy geführt haben, für aktuelle Arbeit verfügbar wird – ohne manuelle Organisation.

Technisches Fundament

Die Implementierung folgt der MCP-Spezifikation Version 1.0 und gewährleistet Kompatibilität mit dem wachsenden Ökosystem MCP-fähiger Anwendungen. Die Server-Architektur unterstützt gleichzeitige Anfragen, implementiert effizientes Caching für häufig abgerufene Daten und enthält automatische Retry-Logik für vorübergehende Fehler.

Antwortzeiten liegen typischerweise zwischen 100–500ms für Sitzungsabruf und 200–1000ms für komplexe sitzungsübergreifende Abfragen, abhängig von Datenvolumen und Analysetiefe.

Zukünftige Entwicklung

Die aktuelle Implementierung bietet umfassenden Lesezugriff auf Hedy-Daten. Zukünftige Updates werden Schreibfähigkeiten hinzufügen, die KI-Assistenten ermöglichen, während der Analyse Highlights zu erstellen, benutzerdefinierte Tags zu Sitzungen hinzuzufügen und programmatisch Notizen zu Meetings anzufügen.

Die Integration mit zusätzlichen Protokollen über MCP hinaus wird basierend auf der Ökosystem-Adoption und Nutzeranfragen evaluiert.

Hilfe erhalten

Dokumentation ist in Hedys Help Center verfügbar, einschließlich Einrichtungsanleitungen für beliebte KI-Clients, Fehlerbehebung bei häufigen Konfigurationsproblemen und Beispielabfragen für verschiedene Anwendungsfälle.

Die Hedy Slack Community enthält einen #mcp-integration-Kanal, in dem Nutzer Konfigurationen teilen, Workflows diskutieren und sich gegenseitig bei technischen Implementierungsfragen unterstützen.

Die MCP-Integration ist ab sofort für Hedy Pro Nutzer verfügbar. Generieren Sie Ihren API-Schlüssel in den Kontoeinstellungen, um Ihre KI-Assistenten mit Ihrer Meeting-Intelligence zu verbinden.

Häufig gestellte Fragen

Wie viele Tools stellt der Hedy MCP Server bereit?

18 spezialisierte Tools, organisiert in vier Gruppen: Sitzungszugriff (Transkripte, Suche, Listen), Topic Management (Topics mit eigenen Kontexten erstellen/aktualisieren/auflisten), Highlights & Aufgaben (KI-Erkenntnisse, Abschlussstatus, Deadlines) und Webhooks/Session Contexts (seit Januar 2026 schreibfähig).

Unterstützt der Hedy MCP Server Schreiboperationen?

Ja, seit Januar 2026. KI-Assistenten können Topics und Session Contexts erstellen und verwalten, Webhooks konfigurieren und Topic-Konfigurationen aktualisieren. Lesezugriff bleibt der Standard, aber schreibfähige Tools werden dort bereitgestellt, wo die Operation sinnvoll ist.

Wie funktioniert die Hedy MCP-Authentifizierung?

Der Hedy MCP Server verwendet OAuth 2.1. Ihr KI-Client öffnet ein Browserfenster zur Anmeldung und Berechtigungsprüfung; ein Access Token wird ausgestellt, sobald Sie autorisieren. Keine statischen API-Schlüssel zum Rotieren. Tokens können in den Hedy-Kontoeinstellungen widerrufen werden.

Wie lautet die URL des Hedy MCP Server?

https://api.hedy.bot/mcp für US-Konten. Konten mit EU-Datenresidenz verwenden https://eu-api.hedy.bot/mcp. Fügen Sie die URL Ihrem MCP-kompatiblen Client hinzu (Claude Desktop, Cline, Zed, Cursor, Claude Code) und authentifizieren Sie sich über OAuth.

Welche Antwortzeiten und Rate Limits hat der MCP Server?

Der Sitzungsabruf dauert typischerweise 100–500 ms; sitzungsübergreifende Abfragen 200–1000 ms, je nach Datenvolumen und Analysetiefe. Der Server unterstützt parallele Requests mit effizientem Caching für häufig abgerufene Daten und automatischer Wiederholungslogik bei vorübergehenden Fehlern.