MCP-server
Koppl Speechdash til Cursor, Claude Desktop, ChatGPT, eller andre MCP-klienter via Speechdash' offentlige API.
Speechdash leverer en offisiell Model Context Protocol (MCP) server som eksponerer biblioteket og talegenerering som verktøy. Bruk denne når du vil at en AI-assistent skal liste dokumenter (inkludert ferdige transkripsjoner), lage tekstimporter, oversette eller eksportere, sjekke din lommebok, eller generere tale uten å skrive HTTP-kall selv. Biblioteket inkluderer ferdige transkripsjoner (source=transcription). Det finnes ikke et transkripsjonsverktøy: les disse jobbene med dokumentverktøyene. MCP starter ikke lydtranskripsjonsjobber.
Du kan også kalle den offentlige REST-APIen direkte med curl eller din egen klient. MCP og HTTP deler de samme endene, kredittene og hastighetsbegrensningene der begge grensesnitt eksisterer.
Innbundet (denne siden): Speechdash' offisielle MCP på mcp.speechdash.com lar eksterne assistenter ringe din Speechdash-bibliotek.
Utbundet (appinnstillinger): Innstillinger → Tilkoblinger knytter tredjeparts MCP-servere til chat-grensesnittet i appen når denne funksjonen er aktivert. Dette er ikke Speechdash' offentlige MCP-server.
Sett aldri SPEECHDASH_API_KEY på den offentlige mcp.speechdash.com-utplassen. Hver klient må autentisere seg med OAuth eller et personlig sh_live_…-nøkkel i Authorization-hodet.
Før du starter
Opprett en API-nøkkel under Innstillinger → API i appen for Cursor, Claude Desktop og andre klienter som tar imot bærer-nøkler. MCP bruker de samme sh_live_…-nøklene som HTTP. Se API-oversikt.
ChatGPT (OAuth)
ChatGPT krever OAuth 2.1 + PKCE, ikke en innsatt API-nøkkel. Fyll ikke ut en API-nøkkel i ChatGPT-tilkoblingsgrensesnittet.
- MCP-URL:
https://mcp.speechdash.com/mcp - OAuth-resurs:
https://mcp.speechdash.com - Vernt resursmetadata:
https://mcp.speechdash.com/.well-known/oauth-protected-resource - Autoriseringsserver (oppdagelse):
https://speechdash.com/.well-known/oauth-authorization-server
Logg inn med din Speechdash-konto når ChatGPT ber om det. Tilgangstokener blir myntet av appen og akseptert av MCP-serveren og offentlige API.
Oppsett-gjennomgang: Agents hub.
Verktøy
Hvert MCP-verktøy mapper til en REST-endepunkt:
| MCP-verktøy | 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 eksponerer også ressursen speechdash://openapi (levende OpenAPI JSON).
MCP vs REST-funksjonalitet
| Funksjon | MCP | REST |
|---|---|---|
| Konto-snapshot | Ja (speechdash_get_account) | GET /v1/me |
| Dokument-CRUD (bibliotek, inkludert ferdige transkripsjoner) | Ja | Ja |
| Start lydtranskripsjonsjobber | Nei (app bare) | Nei (app bare) |
| Ikke-strømmende tale (5k tegn) | Ja | POST /v1/audio/speech |
| Strømmende tale (20k tegn) | Nei, bruk REST | POST /v1/audio/stream |
| Strømmende med tidsstempler | Nei, bruk REST | POST /v1/audio/stream/with-timestamps |
| Oversettelse | Ja (speechdash_translate_document) | POST /v1/documents/{document_id}/translate |
| Fil-eksport | Ja (speechdash_export_document) | GET /v1/documents/{document_id}/export |
| Arkivering / gjenoppretting | Ja (is_archived på speechdash_update_document) | PUT /v1/documents/{document_id} |
| Helse-sjekk | Nei | GET /health |
| OpenAPI JSON | Ressurs speechdash://openapi | GET /v1/openapi.json |
Regning
MCP-talegenerering debiterer samme kredittlommebok som REST og sky-avspilling i appen. Å lage dokumenter via MCP bruker ikke kreditter, men det teller med i samme daglige dokumentgrense som appen og REST-APIen. Kall speechdash_get_account før generering for å sjekke balansen.
speechdash_translate_document debiterer samme kredittlommebok som MP3-eksport (0.5 kreditter per startet 30 sekunder estimert tale). speechdash_export_document kan returnere store filbytter: foretrekker txt, csv, eller srt i MCP. pdf og docx er binære. speechdash_update_document tar imot visibility for den ulistede delingsiden og is_archived for å arkivere eller gjenopprette.
Cursor eller Claude Desktop
Bruk Streamable HTTP mot den hostede MCP-serveren med din personlige API-nøkkel. Eksempel .cursor/mcp.json:
{
"mcpServers": {
"speechdash": {
"url": "https://mcp.speechdash.com/mcp",
"headers": {
"Authorization": "Bearer sh_live_your_key_here"
}
}
}
}Opprett nøkkelen under Innstillinger → API i appen.
Lokalt utviklingsmiljø (repository-klon)
Hvis du jobber med en klon av Speechdash-repositoriet:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcpValgfritt: peik på en lokal API med SPEECHDASH_API_BASE=http://localhost:3003/v1 mens bun dev:api kjører.
Streamable HTTP (lokal)
For HTTP-MCP-klienter under lokal utvikling:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp:httpStandard-endepunkt: http://127.0.0.1:3010/mcp
| Variabel | Formål |
|---|---|
SPEECHDASH_API_KEY | Kreves for stdio; valgfritt 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-bind-vert (standard 127.0.0.1) |
MCP_PORT | HTTP-port (standard 3010) |
Agent-lesbare dokumenter
Maskinlesbare produktkontekster for AI-krøllere: