MCP szerver

A Speechdash egy hivatalos Model Context Protocol (MCP) szervert csomagol, amely a könyvtárat és a beszédszintézist eszközökként nyújtja. Használd azt, ha egy AI asszisztenst akarsz használni a dokumentumok listázásához (beleértve a kész feljegyzéseket), a szöveg importjának létrehozásához, fordításához vagy exportálásához, a péntehesedés ellenőrzéséhez, vagy a beszédszintézishez anélkül, hogy HTTP hívásokat írnál magad. A könyvtár tartalmaz kész feljegyzéseket (source=transcription). Nincs beszédfeljegyzés eszköz: olvasd be ezeket a dokumentum eszközökkel. Az MCP nem indít hangfelvételi feljegyzési feladatokat.

A nyilvános REST API-t is közvetlenül hívhatod curl-lel vagy saját klienteddel. Az MCP és az HTTP ugyanazokat az végpontokat, hitelpontokat és sebességkorlátokat osztják meg, ahol mindkét felület létezik.

Előzetes lépések

Létrehoz egy API kulcsot a Beállítások → API menüpontban a Cursor, Claude Desktop, és egyéb klientek számára, amelyek elfogadják a hitelesítő kulcsokat. Az MCP ugyanazokat a sh_live_… kulcsokat használja, mint az HTTP. Lásd az API áttekintést.

ChatGPT (OAuth)

A ChatGPT az OAuth 2.1 + PKCE-t igényel, nem egy beillesztett API kulcsot. Ne adj be API kulcsot a ChatGPT kapcsoló UI-be.

1. MCP URL: https://mcp.speechdash.com/mcp
2. OAuth erőforrás: https://mcp.speechdash.com
3. Védett erőforrás metadata: https://mcp.speechdash.com/.well-known/oauth-protected-resource
4. Hitelesítő szerver (felfedezés): https://speechdash.com/.well-known/oauth-authorization-server

Bejelentkezz a Speechdash fiókoddal, amikor a ChatGPT megkéri. Az access tokeneket az alkalmazás verzi és elfogadja az MCP szerver és nyilvános API.

Beállítások útmutató: Agents hub.

Eszközök

Minden MCP eszköz egy REST végpontra tér vissza:

A szerver továbbá a speechdash://openapi erőforrást is kínál (élő OpenAPI JSON).

MCP vs REST képességei

Számlázás

Az MCP beszédszintézise lefizetésre kerül a hitelesítési péntehesedés-ből, mint a REST és a felhőbeli lejátszás az alkalmazásban. A dokumentumok létrehozása az MCP-n keresztül nem fogyaszt hitelpontokat, de számít a naponta megengedett dokumentum korláthoz, mint az alkalmazás és a REST API esetében. Hívd meg a speechdash_get_account-t a szintézis előtt, hogy ellenőrizd a számlád állapotát.

A speechdash_translate_document ugyanazt a hitelesítési péntehesedést fogyasztja, mint az MP3 exportálás (0.5 hitelpont minden 30 másodperc becsült beszédért). A speechdash_export_document nagy fájlbytekokat is visszaadhathat: preferálj txt, csv, vagy srt-et az MCP-ben. A pdf és docx bináris. A speechdash_update_document elfogad visibility-t a nyilvántartatlan megosztási oldallal és is_archived-t az archíváláshoz vagy visszaállításhoz.

Cursor vagy Claude Desktop

Használd a Streamable HTTP-t a szállított MCP szerverrel a személyes API kulcsoddal. Példa .cursor/mcp.json:

{
  "mcpServers": {
    "speechdash": {
      "url": "https://mcp.speechdash.com/mcp",
      "headers": {
        "Authorization": "Bearer sh_live_your_key_here"
      }
    }
  }
}

Létrehozd a kulcsot a Beállítások → API menüpontban az alkalmazásban.

Helyi fejlesztés (repository klón)

Ha egy Speechdash repository klónból dolgozol:

export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp

Opcionális: irányíts egy helyi API-ra SPEECHDASH_API_BASE=http://localhost:3003/v1-re, miközben a bun dev:api fut.

Streamable HTTP (helyi)

HTTP MCP klientek számára a helyi fejlesztés során:

export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp:http

Default végpont: http://127.0.0.1:3010/mcp

Agent-olvasható dokumentumok

Gépolvasható termékkontextus AI crawler-ek számára:

Kapcsolódó