Serwer MCP
Połącz z aplikacją Cursor, Claude Desktop, ChatGPT lub innymi klientami MCP z publicznym API Speechdash.
Speechdash dostarcza oficjalny serwer Model Context Protocol (MCP), który udostępnia bibliotekę i syntezę mowy jako narzędzia. Użyj go, gdy chcesz, aby asystent AI listował dokumenty (włączając ukończone transkrypcje), tworzył importy tekstu, tłumaczył lub eksportował, sprawdzał twoje portfel kredytowy lub syntezował mowę bez pisania własnych wywołań HTTP. Biblioteka zawiera ukończone transkrypcje (source=transcription). Nie ma narzędzia do transkrypcji: czytaj te zadania za pomocą narzędzi dokumentów. MCP nie uruchamia zadań transkrypcji audio.
Możesz również bezpośrednio wywoływać publiczne REST API przy użyciu curl lub własnego klienta. MCP i HTTP dzielą te same końcówki, kredyty i limity prędkości, gdzie istnieją obie powierzchnie.
Wejściowe (ta strona): Oficjalny MCP Speechdash na mcp.speechdash.com pozwala zewnętrznym asystentom wywoływać twoją bibliotekę Speechdash.
Wyjściowe (ustawienia aplikacji): Ustawienia → Połączniki łączy trzeciorzędowe serwery MCP z interfejsem chatowym w aplikacji, gdy ta funkcja jest włączona. To nie jest publiczny serwer MCP Speechdash.
Nigdy nie ustawiaj SPEECHDASH_API_KEY na publicznej wersji mcp.speechdash.com. Każdy klient musi się autentykować przy użyciu OAuth lub osobistego klucza sh_live_… w nagłówku Authorization.
Przed rozpoczęciem
Stwórz klucz API pod Ustawienia → API w aplikacji dla Cursor, Claude Desktop i innych klientów, które akceptują klucze typu bearer. MCP używa tych samych kluczy sh_live_… co HTTP. Zobacz przegląd API.
ChatGPT (OAuth)
ChatGPT wymaga OAuth 2.1 + PKCE, a nie wklejonego klucza API. Nie wpisuj klucza API w interfejsie połączeń ChatGPT.
- URL MCP:
https://mcp.speechdash.com/mcp - Zasób OAuth:
https://mcp.speechdash.com - Metadane zasobu chronionego:
https://mcp.speechdash.com/.well-known/oauth-protected-resource - Serwer autoryzacji (odkrywanie):
https://speechdash.com/.well-known/oauth-authorization-server
Zaloguj się za pomocą swojego konta Speechdash, gdy ChatGPT poprosi o to. Tokeny dostępu są emitowane przez aplikację i akceptowane przez serwer MCP oraz publiczne API.
Przewodnik po ustawieniach: Agents hub.
Narzędzia
Każde narzędzie MCP odpowiada jednemu końcowi REST:
| Narzędzie MCP | 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 |
Serwer udostępnia również zasób speechdash://openapi (żywy JSON OpenAPI).
MCP vs. REST możliwości
| Funkcja | MCP | REST |
|---|---|---|
| Snapshot konta | Tak (speechdash_get_account) | GET /v1/me |
| CRUD dokumentów (biblioteka, w tym ukończone transkrypcje) | Tak | Tak |
| Rozpoczęcie zadań transkrypcji audio | Nie (tylko aplikacja) | Nie (tylko aplikacja) |
| Synteza mowy (nieprzetwarzująca strumieniowo, 5k znaków) | Tak | POST /v1/audio/speech |
| Synteza mowy strumieniowa (20k znaków) | Nie, użyj REST | POST /v1/audio/stream |
| Strumieniowanie z czasami | Nie, użyj REST | POST /v1/audio/stream/with-timestamps |
| Tłumaczenie | Tak (speechdash_translate_document) | POST /v1/documents/{document_id}/translate |
| Eksport plików | Tak (speechdash_export_document) | GET /v1/documents/{document_id}/export |
| Archiwizacja / przywracanie | Tak (is_archived w speechdash_update_document) | PUT /v1/documents/{document_id} |
| Sprawdzenie stanu | Nie | GET /health |
| JSON OpenAPI | Zasób speechdash://openapi | GET /v1/openapi.json |
Rachunkowość
Synteza mowy MCP pobiera kredyty z tego samego portfela kredytowego co REST i odtwarzanie w chmurze w aplikacji. Tworzenie dokumentów przez MCP nie zużywa kredytów, ale liczy się w tym samym dziennym limicie dokumentów co aplikacja i REST API. Wywołaj speechdash_get_account przed syntezą, aby sprawdzić swój stan.
speechdash_translate_document pobiera kredyty z tego samego portfela co eksport MP3 (0.5 kredytów za rozpoczęte 30 sekund szacowanej mowy). speechdash_export_document może zwracać duże bajty plików: preferuj txt, csv, lub srt w MCP. pdf i docx są binarne. speechdash_update_document przyjmuje visibility dla niepublicznej strony udostępniania oraz is_archived, aby archiwizować lub przywracać.
Cursor lub Claude Desktop
Użyj Streamable HTTP przeciwko hostowanemu serwerowi MCP z twoim osobistym kluczem API. Przykładowy plik .cursor/mcp.json:
{
"mcpServers": {
"speechdash": {
"url": "https://mcp.speechdash.com/mcp",
"headers": {
"Authorization": "Bearer sh_live_your_key_here"
}
}
}
}Stwórz klucz pod Ustawienia → API w aplikacji.
Rozwoj lokalny (klon repozytorium)
Jeśli pracujesz z klonu repozytorium Speechdash:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcpOpcjonalnie: skieruj się na lokalne API przy użyciu SPEECHDASH_API_BASE=http://localhost:3003/v1 podczas uruchamiania bun dev:api.
Streamable HTTP (lokalnie)
Dla klientów MCP HTTP podczas lokalnego rozwoju:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp:httpDomyślny koniec: http://127.0.0.1:3010/mcp
| Zmienna | Cel |
|---|---|
SPEECHDASH_API_KEY | Wymagany dla stdio; opcjonalny na lokalnym serwerze HTTP, jeśli klienty wysyłają Authorization: Bearer |
SPEECHDASH_API_BASE | Podstawowa URL API (domyślnie https://api.speechdash.com/v1) |
MCP_TRANSPORT | stdio (domyślne) lub http |
MCP_HOST | Host do wiązania HTTP (domyślnie 127.0.0.1) |
MCP_PORT | Port HTTP (domyślnie 3010) |
Dokumenty czytelne dla agentów
Czytelne dla maszyn konteksty produktowe dla crawlerów AI: