MCP-server
Koppla ihop Cursor, Claude Desktop, ChatGPT eller andra MCP-klienter till Speechdash:s offentliga API.
Speechdash levererar en officiell Model Context Protocol (MCP)-server som exponerar biblioteket och talgenerering som verktyg. Använd den när du vill att en AI-assistent ska lista dokument (inklusive färdiga transkriptioner), skapa textimporter, översätta eller exportera, kontrollera ditt plånbokskonto eller generera tal utan att skriva HTTP-anrop själv. Biblioteket inkluderar färdiga transkriptioner (source=transcription). Det finns inget transkriptionsverktyg: läsa dessa jobb med dokumentverktygen. MCP startar inte ljudtranskriptionsjobb.
Du kan också direkt anropa den offentliga REST-API:n med curl eller din egen klient. MCP och HTTP delar samma ändpunkter, krediter och takter när båda gränssnitt existerar.
Inkommande (denna sida): Speechdash:s officiella MCP på mcp.speechdash.com låter externa assistenter anropa din Speechdash-bibliotek.
Utgående (app-inställningar): Inställningar → Kopplingar kopplar tredjeparts-MCP-servrar till in-app-chat-gränssnittet när den här funktionen är aktiverad. Det är inte Speechdash:s offentliga MCP-server.
Sätt aldrig SPEECHDASH_API_KEY på den offentliga mcp.speechdash.com-installationen. Varje klient måste autentisera sig med OAuth eller ett personligt sh_live_…-nyckel i Authorization-rubriken.
Innan du börjar
Skapa en API-nyckel under Inställningar → API i appen för Cursor, Claude Desktop och andra klienter som accepterar bärarnycklar. MCP använder samma sh_live_…-nycklar som HTTP. Se API-översikt.
ChatGPT (OAuth)
ChatGPT kräver OAuth 2.1 + PKCE, inte en inkopierad API-nyckel. Använd inte en API-nyckel i ChatGPT-anslutningsgränssnittet.
- MCP-URL:
https://mcp.speechdash.com/mcp - OAuth-resurs:
https://mcp.speechdash.com - Skyddad resursmetadata:
https://mcp.speechdash.com/.well-known/oauth-protected-resource - Autoriseringsserver (upptäckt):
https://speechdash.com/.well-known/oauth-authorization-server
Logga in med ditt Speechdash-konto när ChatGPT ber dig. Tillgångstoken genereras av appen och accepteras av MCP-servern och den offentliga API:n.
Sätt upp genomgång: Agents hub.
Verktyg
Varje MCP-verktyg motsvarar en REST-ändpunkt:
| MCP-verktyg | 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 |
Servern exponerar även resursen speechdash://openapi (levande OpenAPI JSON).
MCP vs REST-funktioner
| Funktion | MCP | REST |
|---|---|---|
| Konto-snapshot | Ja (speechdash_get_account) | GET /v1/me |
| Dokument-CRUD (bibliotek, inklusive färdiga transkriptioner) | Ja | Ja |
| Starta ljudtranskriptionsjobb | Nej (app endast) | Nej (app endast) |
| Icke-streamad talgenerering (5k tecken) | Ja | POST /v1/audio/speech |
| Streamad talgenerering (20k tecken) | Nej, använd REST | POST /v1/audio/stream |
| Streamad med tidsstämplar | Nej, använd REST | POST /v1/audio/stream/with-timestamps |
| Översättning | Ja (speechdash_translate_document) | POST /v1/documents/{document_id}/translate |
| Filexport | Ja (speechdash_export_document) | GET /v1/documents/{document_id}/export |
| Arkivera / återställa | Ja (is_archived på speechdash_update_document) | PUT /v1/documents/{document_id} |
| Hälsokontroll | Nej | GET /health |
| OpenAPI JSON | Resurs speechdash://openapi | GET /v1/openapi.json |
Fakturering
MCP-talgenerering debiterar samma kreditplånbok som REST och molnspelning i appen. Att skapa dokument via MCP förbrukar inte krediter, men det räknas mot samma dagliga dokumentgräns som appen och REST-API:n. Anropa speechdash_get_account innan syntesen för att kontrollera ditt saldo.
speechdash_translate_document debiterar samma kreditplånbok som MP3-export (0.5 krediter per startad 30 sekunder av uppskattat tal). speechdash_export_document kan returnera stora filbyte: föredra txt, csv, eller srt i MCP. pdf och docx är binära. speechdash_update_document accepterar visibility för den olistade delningssidan och is_archived för att arkivera eller återställa.
Cursor eller Claude Desktop
Använd Streamable HTTP mot den hostade MCP-servern med din personliga API-nyckel. Exempel .cursor/mcp.json:
{
"mcpServers": {
"speechdash": {
"url": "https://mcp.speechdash.com/mcp",
"headers": {
"Authorization": "Bearer sh_live_your_key_here"
}
}
}
}Skapa nyckeln under Inställningar → API i appen.
Lokalt utvecklingsarbete (repositarienumkopiering)
Om du arbetar från en kopia av Speechdash-reposititoriet:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcpValfritt: peka på en lokal API med SPEECHDASH_API_BASE=http://localhost:3003/v1 medan bun dev:api körs.
Streamable HTTP (lokal)
För HTTP-MCP-klienter under lokalt utvecklingsarbete:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp:httpStandardändpunkt: http://127.0.0.1:3010/mcp
| Variabel | Syfte |
|---|---|
SPEECHDASH_API_KEY | Krävs för stdio; valfritt på en lokal HTTP-server om klienter skickar Authorization: Bearer |
SPEECHDASH_API_BASE | API-bas-URL (standard https://api.speechdash.com/v1) |
MCP_TRANSPORT | stdio (standard) eller http |
MCP_HOST | HTTP-bindningshost (standard 127.0.0.1) |
MCP_PORT | HTTP-port (standard 3010) |
Agentläsbara dokument
Maskinläsbara produktkontext för AI-krällare: