MCP-server
Tilmeld Cursor, Claude Desktop, ChatGPT eller andre MCP-klienter til Speechdash's offentlige API.
Speechdash leverer en officiel Model Context Protocol (MCP) server, der udstiller biblioteket og talegenerering som værktøjer. Brug det, når du vil have en AI-assistent til at liste dokumenter (inklusive færdige transkriptioner), oprette tekstimporter, oversætte eller eksportere, kontrollere din wallet, eller generere tale uden selv at skrive HTTP-kald. Biblioteket indeholder færdige transkriptioner (source=transcription). Der er ingen transkriptionsværktøj: læs disse jobs med dokumentværktøjerne. MCP starter ikke audio-transkriptionsjobs.
Du kan også kalde den offentlige REST-API direkte med curl eller din egen klient. MCP og HTTP deler de samme endpoints, kreditter og rate-limitter, hvor begge overflader eksisterer.
Indgående (denne side): Speechdash's officielle MCP på mcp.speechdash.com tillader eksterne assistenter at kalde din Speechdash-bibliotek.
Udgående (app-indstillinger): Indstillinger → Tilkoblinger knytter tredjeparts-MCP-servere til chat-UI'et i appen, når denne funktion er aktiveret. Det er ikke Speechdash's offentlige MCP-server.
Indstil aldrig SPEECHDASH_API_KEY på den offentlige mcp.speechdash.com-udplacering. Hvert klientprogram skal autentificere sig med OAuth eller et personligt sh_live_…-nøgle i Authorization-hovedet.
Før du starter
Opret en API-nøgle under Indstillinger → API i appen til Cursor, Claude Desktop og andre klienter, der accepterer bærer-nøgler. MCP bruger de samme sh_live_…-nøgler som HTTP. Se API-overblik.
ChatGPT (OAuth)
ChatGPT kræver OAuth 2.1 + PKCE, ikke en indsat API-nøgle. Indtast ikke en API-nøgle i ChatGPT-tilkoblingsgrænsefladen.
- MCP URL:
https://mcp.speechdash.com/mcp - OAuth-resource:
https://mcp.speechdash.com - Beskyttet ressource metadata:
https://mcp.speechdash.com/.well-known/oauth-protected-resource - Autoriseringsserver (opdagelse):
https://speechdash.com/.well-known/oauth-authorization-server
Log ind med din Speechdash-konto, når ChatGPT bedrer dig om det. Adgangstokener udstedes af appen og accepteres af MCP-serveren og den offentlige API.
Opsætningsvejledning: Agents hub.
Værktøjer
Hvert MCP-værktøj mapper til en REST-endpoint:
| MCP-værktøj | 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 |
Serveren udstiller også ressourcen speechdash://openapi (live OpenAPI JSON).
MCP vs REST-funktioner
| Funktion | MCP | REST |
|---|---|---|
| Konto-snapshot | Ja (speechdash_get_account) | GET /v1/me |
| Dokument-CRUD (bibliotek, inklusive færdige transkriptioner) | Ja | Ja |
| Start af audio-transkriptionsjobs | Nej (app kun) | Nej (app kun) |
| Ikke-strømmende tale (5k tegn) | Ja | POST /v1/audio/speech |
| Strømmende tale (20k tegn) | Nej, brug REST | POST /v1/audio/stream |
| Strømmende med tidsstempler | Nej, brug REST | POST /v1/audio/stream/with-timestamps |
| Oversættelse | Ja (speechdash_translate_document) | POST /v1/documents/{document_id}/translate |
| Fil-eksport | Ja (speechdash_export_document) | GET /v1/documents/{document_id}/export |
| Arkivering / genopretning | Ja (is_archived på speechdash_update_document) | PUT /v1/documents/{document_id} |
| Sundhedstjek | Nej | GET /health |
| OpenAPI JSON | Ressource speechdash://openapi | GET /v1/openapi.json |
Regning
MCP-talegenerering debiterer samme kreditwallet som REST og cloud-afspilning i appen. At oprette dokumenter via MCP forbruger ikke kreditter, men det tæller med i den samme daglige dokumentgrænse som appen og REST-API'en. Kalder speechdash_get_account før syntesen for at kontrollere din balance.
speechdash_translate_document debiterer samme kreditwallet som MP3-eksport (0,5 kreditter pr. startet 30 sekunder af estimeret tale). speechdash_export_document kan returnere store filbytes: foretrukne formater i MCP er txt, csv, eller srt. pdf og docx er binære. speechdash_update_document accepterer visibility for den ulistede delingsside og is_archived til at arkivere eller genoprette.
Cursor eller Claude Desktop
Brug Streamable HTTP mod den hostede MCP-server med din personlige API-nøgle. Eksempel .cursor/mcp.json:
{
"mcpServers": {
"speechdash": {
"url": "https://mcp.speechdash.com/mcp",
"headers": {
"Authorization": "Bearer sh_live_your_key_here"
}
}
}
}Opret nøglen under Indstillinger → API i appen.
Lokalt udviklingsmiljø (repository-klon)
Hvis du arbejder med en klon af Speechdash-repositoryet:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcpValgfrit: pej på en lokal API med SPEECHDASH_API_BASE=http://localhost:3003/v1 mens bun dev:api kører.
Streamable HTTP (lokal)
For HTTP-MCP-klienter under lokal udvikling:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp:httpStandard endpoint: http://127.0.0.1:3010/mcp
| Variabel | Formål |
|---|---|
SPEECHDASH_API_KEY | Krævet for stdio; valgfri på en lokal HTTP-server, hvis klienter sender Authorization: Bearer |
SPEECHDASH_API_BASE | API-base URL (standard https://api.speechdash.com/v1) |
MCP_TRANSPORT | stdio (standard) eller http |
MCP_HOST | HTTP-bindingshost (standard 127.0.0.1) |
MCP_PORT | HTTP-port (standard 3010) |
Agent-læselige dokumenter
Maskinlæselig produktkontekst til AI-crawlere: