MCP server
Připojte Cursor, Claude Desktop, ChatGPT nebo jiné klienty MCP k veřejné API Speechdash.
Speechdash dodává oficiální server Model Context Protocol (MCP), který expozuje knihovnu a syntézu řeči jako nástroje. Použijte jej, když chcete, aby umělá inteligence zapsala dokumenty (včetně dokončených přepisů), vytvořila textové importy, překládala nebo exportovala, kontrolovala vaši peněženku nebo syntetizovala řeč bez psaní HTTP volání sami. Knihovna zahrnuje dokončené přepisy (source=transcription). Není zde nástroj pro přepisy: čtěte tyto úkoly pomocí nástrojů pro dokumenty. MCP nezačíná audio přepisové úkoly.
Můžete také přímo volat veřejnou REST API pomocí curl nebo vlastního klienta. MCP a HTTP sdílejí stejné koncové body, kredity a limity rychlosti, kde obě rozhraní existují.
Přijímací (tato stránka): Oficiální MCP Speechdash na mcp.speechdash.com umožňuje externím asistentům volat vaši knihovnu Speechdash.
Vyjímající (nastavení aplikace): Nastavení → Spojovníky připojuje třetí strany MCP servery k rozhraní chatu v aplikaci, když je tato funkce povolena. To není veřejný MCP server Speechdash.
Nikdy nedefinujte SPEECHDASH_API_KEY na veřejném nasazení mcp.speechdash.com. Každý klient musí být autentizován OAuth nebo osobním klíčem sh_live_… v hlavičce Authorization.
Před zahájením
Vytvořte API klíč pod Nastavení → API v aplikaci pro Cursor, Claude Desktop a další klienty, které přijímají klíče typu bearer. MCP používá stejné klíče sh_live_… jako HTTP. Podívejte se na přehled API.
ChatGPT (OAuth)
ChatGPT vyžaduje OAuth 2.1 + PKCE, nikoli vložený API klíč. Nezapojujte API klíč do rozhraní spojení ChatGPT.
- MCP URL:
https://mcp.speechdash.com/mcp - OAuth zdroj:
https://mcp.speechdash.com - Chráněné metadata zdroje:
https://mcp.speechdash.com/.well-known/oauth-protected-resource - Autorizační server (objev):
https://speechdash.com/.well-known/oauth-authorization-server
Přihlaste se svým účtem Speechdash, když ChatGPT požádá. Toky přístupu jsou rafinovány aplikací a přijímány MCP serverem a veřejnou API.
Návod k nastavení: Agents hub.
Nástroje
Každý nástroj MCP odpovídá jednomu REST koncovému bodu:
| MCP nástroj | 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 |
Server také expozuje zdroj speechdash://openapi (živý JSON OpenAPI).
MCP vs REST schopnosti
| Funkce | MCP | REST |
|---|---|---|
| Snapshot účtu | Ano (speechdash_get_account) | GET /v1/me |
| CRUD dokumentů (knihovna, včetně dokončených přepisů) | Ano | Ano |
| Spuštění audio přepisových úkolů | Ne (pouze aplikace) | Ne (pouze aplikace) |
| Ne-streamovaná řeč (5 tisíc znaků) | Ano | POST /v1/audio/speech |
| Streamovaná řeč (20 tisíc znaků) | Ne, použijte REST | POST /v1/audio/stream |
| Streamování s časovými razítky | Ne, použijte REST | POST /v1/audio/stream/with-timestamps |
| Překlad | Ano (speechdash_translate_document) | POST /v1/documents/{document_id}/translate |
| Export souborů | Ano (speechdash_export_document) | GET /v1/documents/{document_id}/export |
| Archivace / obnovení | Ano (is_archived na speechdash_update_document) | PUT /v1/documents/{document_id} |
| Kontrola zdraví | Ne | GET /health |
| OpenAPI JSON | Zdroj speechdash://openapi | GET /v1/openapi.json |
Fakturace
MCP syntéza řeči odečítá stejné kreditní peněženky jako REST a cloudové přehrávání v aplikaci. Vytváření dokumentů přes MCP nekonzumuje kredity, ale počítá se stejným denním limitem dokumentů jako aplikace a REST API. Volávejte speechdash_get_account před syntézou, abyste zkontrolovali svůj saldo.
speechdash_translate_document fakturuje stejné kreditní peněženky jako export MP3 (0,5 kreditu na každých 30 sekund odhadnuté řeči). speechdash_export_document může vrátit velké byte souborů: preferujte txt, csv, nebo srt v MCP. pdf a docx jsou binární. speechdash_update_document přijímá visibility pro stránku sdílení neoznačených dokumentů a is_archived pro archivaci nebo obnovení.
Cursor nebo Claude Desktop
Použijte Streamable HTTP proti hostovanému MCP serveru se svým osobním API klíčem. Příklad .cursor/mcp.json:
{
"mcpServers": {
"speechdash": {
"url": "https://mcp.speechdash.com/mcp",
"headers": {
"Authorization": "Bearer sh_live_your_key_here"
}
}
}
}Vytvořte klíč pod Nastavení → API v aplikaci.
Lokální vývoj (klon repozitáře)
Pokud pracujete z klonu repozitáře Speechdash:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcpVolitelně: zaměřte se na místní API pomocí SPEECHDASH_API_BASE=http://localhost:3003/v1, zatímco bun dev:api běží.
Streamable HTTP (lokální)
Pro HTTP klienty MCP během lokálního vývoje:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp:httpVýchozí koncový bod: http://127.0.0.1:3010/mcp
| Proměnná | Účel |
|---|---|
SPEECHDASH_API_KEY | Vyžadován pro stdio; volitelný na lokálním HTTP serveru, pokud klienti odesílají Authorization: Bearer |
SPEECHDASH_API_BASE | Základní URL API (výchozí https://api.speechdash.com/v1) |
MCP_TRANSPORT | stdio (výchozí) nebo http |
MCP_HOST | Host pro vázání HTTP (výchozí 127.0.0.1) |
MCP_PORT | Port HTTP (výchozí 3010) |
Dokumenty čitelné pro agenty
Strojově čitelné produktové kontexty pro AI crawlery: