MCP-server
Verbinder Cursor, Claude Desktop, ChatGPT, of andere MCP-cliënten met de openbare Speechdash API.
Speechdash levert een officiële Model Context Protocol (MCP) server die de bibliotheek en tekst-naar-spraak als hulpmiddelen blootstelt. Gebruik deze server als je een AI-assistent wilt laten documenten (inclusief afgeronde transcripties) lijsten, tekstimporteert, vertaalt of exporteert, je portemonnee controleert, of spraak synthetiseert zonder zelf HTTP-aanroepen te schrijven. De bibliotheek bevat afgeronde transcripties (source=transcription). Er is geen hulpmiddel voor transcripties: lees die taken met de documenthulpmiddelen. MCP start geen audio-transcriptieopdrachten.
Je kunt ook de openbare REST API rechtstreeks oproepen met curl of je eigen cliënt. MCP en HTTP delen dezelfde eindpunten, creditten en rate-limits waar beide interfaces bestaan.
Inkomend (deze pagina): De officiële MCP van Speechdash op mcp.speechdash.com stelt externe assistenten in staat jouw Speechdash-bibliotheek aan te roepen.
Uitgaand (app-instellingen): Instellingen → Verbindingen koppelt derde-partij MCP-servers aan het in-app chatvenster als deze functie is ingeschakeld. Dit is niet de openbare MCP-server van Speechdash.
Zet nooit SPEECHDASH_API_KEY in op de openbare mcp.speechdash.com-deployments. Elke cliënt moet zich authenticeren met OAuth of een persoonlijke sh_live_…-sleutel in het Authorization-koptekst.
Voordat je begint
Maak een API-sleutel aan onder Instellingen → API in de app voor Cursor, Claude Desktop en andere cliënten die dragertoegangsbewijzen accepteren. MCP gebruikt dezelfde sh_live_…-sleutels als HTTP. Zie API-overzicht.
ChatGPT (OAuth)
ChatGPT vereist OAuth 2.1 + PKCE, niet een geplakte API-sleutel. Voer geen API-sleutel in het ChatGPT-verbindervenster in.
- MCP-URL:
https://mcp.speechdash.com/mcp - OAuth-ressourcen:
https://mcp.speechdash.com - Gebeschermde resourcemetadaten:
https://mcp.speechdash.com/.well-known/oauth-protected-resource - Autorisatieserver (ontdekking):
https://speechdash.com/.well-known/oauth-authorization-server
Log in met je Speechdash-account als ChatGPT je daarom vraagt. Toegangstokens worden door de app geslagen en geaccepteerd door de MCP-server en de openbare API.
Setup-walkthrough: Agents hub.
Hulpmiddelen
Elk MCP-hulpmiddel correspondeert met één REST-eindpunt:
| MCP-hulpmiddel | 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 |
De server blootstelt ook de resource speechdash://openapi (live OpenAPI JSON).
MCP vs REST-capaciteiten
| Functie | MCP | REST |
|---|---|---|
| Account-snapshot | Ja (speechdash_get_account) | GET /v1/me |
| Document-CRUD (bibliotheek, inclusief afgeronde transcripties) | Ja | Ja |
| Audio-transcriptieopdrachten starten | Nee (app alleen) | Nee (app alleen) |
| Niet-stroomende spraak (5k tekens) | Ja | POST /v1/audio/speech |
| Stroomende spraak (20k tekens) | Nee, gebruik REST | POST /v1/audio/stream |
| Stroomende spraak met tijdstempels | Nee, gebruik REST | POST /v1/audio/stream/with-timestamps |
| Vertalen | Ja (speechdash_translate_document) | POST /v1/documents/{document_id}/translate |
| Bestandsexport | Ja (speechdash_export_document) | GET /v1/documents/{document_id}/export |
| Archiveren / herstellen | Ja (is_archived op speechdash_update_document) | PUT /v1/documents/{document_id} |
| Gezondheidscontrole | Nee | GET /health |
| OpenAPI JSON | Resource speechdash://openapi | GET /v1/openapi.json |
Facturatie
MCP-spraaksynthese debiteert dezelfde creditportemonnee als REST en cloud-afspelen in de app. Documenten aanmaken via MCP verbruikt geen creditten, maar het telt mee voor de dagelijkse documentenlimiet zoals in de app en REST API. Roep speechdash_get_account aan voordat je synthese uitvoert om je saldo te controleren.
speechdash_translate_document factureert dezelfde creditportemonnee als MP3-export (0,5 credit per gestarte 30 seconden geschatte spraak). speechdash_export_document kan grote bestandbytes teruggeven: voorkeur voor txt, csv, of srt in MCP. pdf en docx zijn binair. speechdash_update_document accepteert visibility voor de niet-lijstpagina delen en is_archived om te archiveren of te herstellen.
Cursor of Claude Desktop
Gebruik Streamable HTTP tegen de gehoste MCP-server met je persoonlijke API-sleutel. Voorbeeld .cursor/mcp.json:
{
"mcpServers": {
"speechdash": {
"url": "https://mcp.speechdash.com/mcp",
"headers": {
"Authorization": "Bearer sh_live_your_key_here"
}
}
}
}Maak de sleutel aan onder Instellingen → API in de app.
Lokale ontwikkeling (repository clone)
Als je werkt met een clone van de Speechdash-repository:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcpOptioneel: wijz de lokale API aan met SPEECHDASH_API_BASE=http://localhost:3003/v1 terwijl bun dev:api draait.
Streamable HTTP (lokaal)
Voor HTTP-MCP-cliënten tijdens lokale ontwikkeling:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp:httpStandaardeindpunt: http://127.0.0.1:3010/mcp
| Variabele | Doel |
|---|---|
SPEECHDASH_API_KEY | Vereist voor stdio; optioneel op een lokaal HTTP-server als cliënten Authorization: Bearer versturen |
SPEECHDASH_API_BASE | API-base URL (standaard https://api.speechdash.com/v1) |
MCP_TRANSPORT | stdio (standaard) of http |
MCP_HOST | HTTP-bindhost (standaard 127.0.0.1) |
MCP_PORT | HTTP-port (standaard 3010) |
AI-crawler-leesbare documentatie
Machine-leesbare productcontext voor AI-crawlers: