MCP-palvelin
Liitä Cursor-, Claude Desktop-, ChatGPT- tai muun MCP-asiakasliittymän Speechdashin julkiseen API:hin.
Speechdash toimittaa virallisen Model Context Protocol (MCP)-palvelimen, joka tarjoaa kirjasto- ja puheen synteesitoimintoja työkaluina. Käytä sitä, kun haluat AI-apun luetteloimaan asiakirjoja (mukaan lukien valmiit transkriptiot), luomaan tekstiimportteja, kääntämään tai viedä asiakirjoja, tarkistamaan lompakkosi tai synteesio puheen ilman, että kirjoitat HTTP-pyynnöitä itse. Kirjasto sisältää valmiit transkriptiot (source=transcription). Ei ole transkriptio-työkalua: lue nämä työt dokumenttityökaluilla. MCP ei käynnistä äänitranskriptiojätejä.
Voit myös kutsua julkista REST-API:ta suoraan curl-komennolla tai omalla asiakasliittymälläsi. MCP ja HTTP jakavat samat päätepisteet, luottokortit ja rajoitukset, missä molemmat pinnat esiintyvät.
Tulossa (tämä sivu): Speechdashin virallinen MCP osoitteessa mcp.speechdash.com sallii ulkoisten apujen kutsua omasi Speechdash-kirjastoa.
Lähtö (asetukset): Asetukset → Liittymät liittää kolmannen osapuolen MCP-palvelimet sisäänrakennettuun chat-käyttöliittymään, kun tämä ominaisuus on käytössä. Tämä ei ole Speechdashin julkinen MCP-palvelin.
Älä aseta SPEECHDASH_API_KEY:tä julkiselle mcp.speechdash.com-käyttöön. Jokainen asiakasliittymä tulee autentikoida OAuth:lla tai henkilökohtaisella sh_live_…-avaimella Authorization-päässä.
Ennen kuin aloitat
Luo API-avaimesta Asetukset → API sovelluksessa Cursorille, Claude Desktopille ja muille asiakasliittymille, jotka hyväksyvät kantajavaimien. MCP käyttää samoja sh_live_…-avaimia kuin HTTP. Katso API-yhteenveto.
ChatGPT (OAuth)
ChatGPT vaatii OAuth 2.1 + PKCE:tä, ei kopioitua API-avaimia. Älä kirjoita API-avaimia ChatGPT-liittymän käyttöliittymään.
- MCP-URL:
https://mcp.speechdash.com/mcp - OAuth-resurssi:
https://mcp.speechdash.com - Suojattu resurssin metadata:
https://mcp.speechdash.com/.well-known/oauth-protected-resource - Todentamispalvelin (löytö):
https://speechdash.com/.well-known/oauth-authorization-server
Kirjaudu sisään Speechdash-tilillesi, kun ChatGPT pyytää sinua. Tokensit valmistetaan sovelluksessa ja hyväksytään MCP-palvelimella ja julkisella API:lla.
Asennusohjeet: Agents hub.
Työkalut
Jokainen MCP-työkalu vastaa yhteen REST-päätepisteeseen:
| MCP-työkalu | 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 |
Palvelin tarjoaa myös resurssin speechdash://openapi (elävää OpenAPI JSON).
MCP vs REST-ominaisuudet
| Ominaisuus | MCP | REST |
|---|---|---|
| Tilin kuvaus | Kyllä (speechdash_get_account) | GET /v1/me |
| Dokumenttien CRUD (kirjasto, mukaan lukien valmiit transkriptiot) | Kyllä | Kyllä |
| Käynnistä äänitranskriptiojäte | Ei (sovellus ainoastaan) | Ei (sovellus ainoastaan) |
| Äänitiedoston synteesi (5000 merkkiä) | Kyllä | POST /v1/audio/speech |
| Virtaava äänisynteesi (20000 merkkiä) | Ei, käytä REST:ää | POST /v1/audio/stream |
| Virtaava synteesi aikamerkinnöin | Ei, käytä REST:ää | POST /v1/audio/stream/with-timestamps |
| Käännös | Kyllä (speechdash_translate_document) | POST /v1/documents/{document_id}/translate |
| Tiedoston viedä | Kyllä (speechdash_export_document) | GET /v1/documents/{document_id}/export |
| Arkistoida / palauttaa | Kyllä (is_archived speechdash_update_document) | PUT /v1/documents/{document_id} |
| Terveystarkastus | Ei | GET /health |
| OpenAPI JSON | Resurssi speechdash://openapi | GET /v1/openapi.json |
Hinnasto
MCP-puheen synteesi laskee samalta luottokorttilompakolta kuin REST ja pilvupalvelun kuuntelu sovelluksessa. Dokumenttien luominen MCP:n kautta ei kuluta luottoja, mutta se lasketaan samalle päivittäiselle dokumenttirajalle kuin sovellus ja REST-API. Kutsukaa speechdash_get_account ennen synteesiä tarkistaaksesi saldoasi.
speechdash_translate_document laskee samalta luottokorttilompakolta kuin MP3-viedä (0.5 luottoa aloitetusta 30 sekunnin arvioidusta puheesta). speechdash_export_document voi palauttaa suuria tiedostoja: suosittele txt, csv, tai srt MCP:llä. pdf ja docx ovat binääriä. speechdash_update_document hyväksyy visibility piilotetun jakamisen sivulle ja is_archived arkistoimiseen tai palauttamiseen.
Cursor tai Claude Desktop
Käytä Streamable HTTP:tä isäntäpalvelimen MCP-palvelimelle henkilökohtaisella API-avaimella. Esimerkki .cursor/mcp.json:
{
"mcpServers": {
"speechdash": {
"url": "https://mcp.speechdash.com/mcp",
"headers": {
"Authorization": "Bearer sh_live_your_key_here"
}
}
}
}Luo avain Asetukset → API sovelluksessa.
Paikallinen kehitys (repositorion kopio)
Jos työskentelet Speechdash-repositorion kopiosta:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcpVapaaehtoinen: ohjaa paikalliseen API:hin SPEECHDASH_API_BASE=http://localhost:3003/v1 kun bun dev:api on käynnissä.
Streamable HTTP (paikallinen)
HTTP MCP-asiakasliittymille paikallisessa kehityksessä:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp:httpOletuspäätepiste: http://127.0.0.1:3010/mcp
| Muuttuja | Käyttö |
|---|---|
SPEECHDASH_API_KEY | Vaaditaan stdio:lle; vapaaehtoinen paikalliselle HTTP-palvelimelle, jos asiakkaat lähettävät Authorization: Bearer |
SPEECHDASH_API_BASE | API:n pohja-URL (oletus https://api.speechdash.com/v1) |
MCP_TRANSPORT | stdio (oletus) tai http |
MCP_HOST | HTTP-kohde (oletus 127.0.0.1) |
MCP_PORT | HTTP-portti (oletus 3010) |
AI-käyttäjille luettavat dokumentit
Koneellisesti luettava tuote- ja kontekstitieto AI-käyttäjille: