MCP-Server
Verbinde Cursor, Claude Desktop, ChatGPT oder andere MCP-Klienten mit der öffentlichen Speechdash-API.
Speechdash liefert einen offiziellen Model Context Protocol (MCP)-Server aus, der die Bibliothek und Sprachsynthese als Tools bereitstellt. Verwende ihn, wenn du möchtest, dass ein KI-Assistent Dokumente (inklusive abgeschlossener Transkriptionen) auflistet, Textimporte erstellt, übersetzt oder exportiert, dein Wallet prüft oder Sprachsynthese durchführt, ohne selbst HTTP-Aufrufe zu schreiben. Die Bibliothek enthält abgeschlossene Transkriptionen (source=transcription). Es gibt kein Transkriptions-Tool: Lies diese Jobs mit den Dokument-Tools. MCP startet keine Audio-Transkriptionsjobs.
Du kannst auch die öffentliche REST-API direkt mit curl oder deinem eigenen Client aufrufen. MCP und HTTP teilen sich dieselben Endpunkte, Credits und Rate Limits, wo beide Oberflächen existieren.
Eingehend (diese Seite): Der offizielle Speechdash-MCP unter mcp.speechdash.com ermöglicht externen Assistenten, auf deine Speechdash-Bibliothek zuzugreifen.
Ausgehend (App-Einstellungen): Einstellungen → Verbinder fügt dritte MCP-Server der Chat-Oberfläche in der App hinzu, wenn diese Funktion aktiviert ist. Das ist nicht der öffentliche Speechdash-MCP-Server.
Setze SPEECHDASH_API_KEY niemals auf der öffentlichen mcp.speechdash.com-Instanz. Jeder Client muss sich mit OAuth oder einem persönlichen sh_live_…-Schlüssel im Authorization-Header authentifizieren.
Vorbereitung
Erstelle einen API-Schlüssel unter Einstellungen → API in der App für Cursor, Claude Desktop und andere Clients, die Bearer-Schlüssel akzeptieren. MCP verwendet dieselben sh_live_…-Schlüssel wie HTTP. Siehe API-Übersicht.
ChatGPT (OAuth)
ChatGPT benötigt OAuth 2.1 + PKCE, nicht einen eingekoppelten API-Schlüssel. Gib keinen API-Schlüssel in der ChatGPT-Verbindungs-Oberfläche ein.
- MCP-URL:
https://mcp.speechdash.com/mcp - OAuth-Ressource:
https://mcp.speechdash.com - Metadaten für geschützte Ressource:
https://mcp.speechdash.com/.well-known/oauth-protected-resource - Autorisierungsserver (Entdeckung):
https://speechdash.com/.well-known/oauth-authorization-server
Melde dich mit deinem Speechdash-Konto an, wenn ChatGPT dich dazu auffordert. Zugriffstoken werden von der App ausgegeben und vom MCP-Server und der öffentlichen API akzeptiert.
Setup-Anleitung: Agents hub.
Tools
Jedes MCP-Tool entspricht einem REST-Endpunkt:
| MCP-Tool | REST |
|---|---|
speechdash_get_account | GET /v1/me |
speechdash_list_documents | GET /v1/documents |
speechdash_get_document | GET /v1/documents/{document_id} |
speechdash_create_document | POST /v1/documents |
speechdash_update_document | PUT /v1/documents/{document_id} |
speechdash_translate_document | POST /v1/documents/{document_id}/translate |
speechdash_export_document | GET /v1/documents/{document_id}/export |
speechdash_delete_document | DELETE /v1/documents/{document_id} |
speechdash_list_voices | GET /v1/voices |
speechdash_get_voice | GET /v1/voices/{voice_id} |
speechdash_synthesize_speech | POST /v1/audio/speech |
Der Server stellt außerdem die Ressource speechdash://openapi (Live-OpenAPI-JSON) bereit.
MCP vs. REST-Funktionen
| Funktion | MCP | REST |
|---|---|---|
| Kontosnapshot | Ja (speechdash_get_account) | GET /v1/me |
| Dokument-CRUD (Bibliothek, inkl. abgeschlossene Transkriptionen) | Ja | Ja |
| Audio-Transkriptionsjobs starten | Nein (nur App) | Nein (nur App) |
| Nicht-streamende Sprachsynthese (5.000 Zeichen) | Ja | POST /v1/audio/speech |
| Streamende Sprachsynthese (20.000 Zeichen) | Nein, verwende REST | POST /v1/audio/stream |
| Streamende Synthese mit Zeitstempeln | Nein, verwende REST | POST /v1/audio/stream/with-timestamps |
| Übersetzen | Ja (speechdash_translate_document) | POST /v1/documents/{document_id}/translate |
| Datei-Export | Ja (speechdash_export_document) | GET /v1/documents/{document_id}/export |
| Archivieren / Wiederherstellen | Ja (is_archived in speechdash_update_document) | PUT /v1/documents/{document_id} |
| Gesundheitsprüfung | Nein | GET /health |
| OpenAPI-JSON | Ressource speechdash://openapi | GET /v1/openapi.json |
Abrechnung
MCP-Sprachsynthese belastet dasselbe Credit-Wallet wie REST und Cloud-Wiedergabe in der App. Das Erstellen von Dokumenten über MCP verbraucht keine Credits, zählt aber auf dieselbe tägliche Dokumentenobergrenze wie die App und REST-API. Rufe speechdash_get_account vor der Synthese auf, um dein Guthaben zu prüfen.
speechdash_translate_document belastet dasselbe Credit-Wallet wie MP3-Export (0,5 Credits pro gestarteten 30 Sekunden geschätzter Sprache). speechdash_export_document kann große Dateibytes zurückgeben: Bevorzuge txt, csv oder srt in MCP. pdf und docx sind binär. speechdash_update_document akzeptiert visibility für die nicht gelistete Freigabeseite und is_archived, um Dokumente zu archivieren oder wiederherzustellen.
Cursor oder Claude Desktop
Verwende Streamable HTTP gegen den gehosteten MCP-Server mit deinem persönlichen API-Schlüssel. Beispiel .cursor/mcp.json:
{
"mcpServers": {
"speechdash": {
"url": "https://mcp.speechdash.com/mcp",
"headers": {
"Authorization": "Bearer sh_live_dein_schlüssel_hier"
}
}
}
}Erstelle den Schlüssel unter Einstellungen → API in der App.
Lokale Entwicklung (Repository-Klon)
Falls du von einem Klon des Speechdash-Repositories arbeitest:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcpOptional: Richte eine lokale API mit SPEECHDASH_API_BASE=http://localhost:3003/v1 ein, während bun dev:api läuft.
Streamable HTTP (lokal)
Für HTTP-MCP-Clients während der lokalen Entwicklung:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp:httpStandard-Endpunkt: http://127.0.0.1:3010/mcp
| Variable | Zweck |
|---|---|
SPEECHDASH_API_KEY | Erforderlich für stdio; optional auf einem lokalen HTTP-Server, wenn Clients Authorization: Bearer senden |
SPEECHDASH_API_BASE | API-Basis-URL (Standard https://api.speechdash.com/v1) |
MCP_TRANSPORT | stdio (Standard) oder http |
MCP_HOST | HTTP-Bind-Host (Standard 127.0.0.1) |
MCP_PORT | HTTP-Port (Standard 3010) |
Agenten-lesbare Dokumente
Maschinenlesbarer Produktkontext für KI-Crawler: