SpeechdashHelp Center

MCP 伺服器

連接 Cursor、Claude Desktop、ChatGPT 或其他 MCP 客戶端至 Speechdash 公共 API。

Speechdash 提供一個官方的 Model Context Protocol (MCP) 伺服器，將圖書館和語音合成作為 工具公開。當您希望 AI 助手列出文件（包括完成的轉寫）、創建文字匯入、翻譯或匯出、檢查您的錢包，或合成語音，而不必自行撰寫 HTTP 請求時，可以使用它。圖書館包含完成的轉寫 (source=transcription)。沒有轉寫工具：使用文件工具讀取這些工作。MCP 不會啟動音訊轉寫工作。

您也可以直接使用 curl 或自訂客戶端呼叫 公共 REST API。MCP 和 HTTP 共享相同的端點、信用額度和速率限制，只要兩個介面都存在。

進入式（本頁面）：Speechdash 的官方 MCP 位於 mcp.speechdash.com，讓外部助手呼叫 您的 Speechdash 圖書館。

出站（應用程式設定）：設定 → 連接器 會在啟用該功能時，將 第三方 MCP 伺服器附加到應用程式內的聊天 UI。這不是 Speechdash 的公共 MCP 伺服器。

千萬不要在公共 mcp.speechdash.com 部署中設定 SPEECHDASH_API_KEY。每個客戶端都必須透過 OAuth 或個人 sh_live_… 鑰匙在 Authorization 標頭中進行驗證。

開始之前

在應用程式中為 Cursor、Claude Desktop 和其他接受 Bearer 鑰匙的客戶端，在 設定 → API 下創建一個 API 鑰匙。MCP 使用與 HTTP 相同的 sh_live_… 鑰匙。請參閱 API 概覽。

ChatGPT (OAuth)

ChatGPT 需要 OAuth 2.1 + PKCE，而不是貼上 API 鑰匙。在 ChatGPT 連接器 UI 中，不要輸入 API 鑰匙。

  1. MCP URL: https://mcp.speechdash.com/mcp
  2. OAuth 資源: https://mcp.speechdash.com
  3. 受保護資源元資料: https://mcp.speechdash.com/.well-known/oauth-protected-resource
  4. 授權伺服器（發現）: https://speechdash.com/.well-known/oauth-authorization-server

當 ChatGPT 提示您登入時，請使用您的 Speechdash 帳戶登入。存根令牌由應用程式鑄造，並由 MCP 伺服器和公共 API 接受。

設定指南：Agents hub。

工具

每個 MCP 工具對應一個 REST 端點：

MCP 工具REST
speechdash_get_accountGET /v1/me
speechdash_list_documentsGET /v1/documents
speechdash_get_documentGET /v1/documents/{document_id}
speechdash_create_documentPOST /v1/documents
speechdash_update_documentPUT /v1/documents/{document_id}
speechdash_translate_documentPOST /v1/documents/{document_id}/translate
speechdash_export_documentGET /v1/documents/{document_id}/export
speechdash_delete_documentDELETE /v1/documents/{document_id}
speechdash_list_voicesGET /v1/voices
speechdash_get_voiceGET /v1/voices/{voice_id}
speechdash_synthesize_speechPOST /v1/audio/speech

伺服器也公開資源 speechdash://openapi（實時 OpenAPI JSON）。

MCP vs REST 功能

功能MCPREST
帳戶快照是 (speechdash_get_account)GET /v1/me
文件 CRUD（圖書館，包括完成的轉寫）是是
啟動音訊轉寫工作否（僅限應用程式）否（僅限應用程式）
非流式語音（5000 字）是POST /v1/audio/speech
流式語音（20000 字）否，請使用 RESTPOST /v1/audio/stream
帶時間戳的流式語音否，請使用 RESTPOST /v1/audio/stream/with-timestamps
翻譯是 (speechdash_translate_document)POST /v1/documents/{document_id}/translate
檔案匯出是 (speechdash_export_document)GET /v1/documents/{document_id}/export
歸檔 / 恢復是 (is_archived 在 speechdash_update_document)PUT /v1/documents/{document_id}
健康檢查否GET /health
OpenAPI JSON資源 speechdash://openapiGET /v1/openapi.json

計費

MCP 語音合成會從與 REST 和雲端播放相同的 信用錢包 中扣除。透過 MCP 創建文件不會消耗信用額度，但它會計入與應用程式和 REST API 相同的每日文件上限。在合成前，請呼叫 speechdash_get_account 檢查您的餘額。

speechdash_translate_document 會從與 MP3 匯出相同的信用錢包中扣除（每開始 30 秒估計語音的 0.5 個信用額度）。speechdash_export_document 可以返回大型檔案字節：在 MCP 中，請偏好 txt、csv 或 srt。pdf 和 docx 是二進位檔案。speechdash_update_document 接受 visibility 用於未列出的分享頁面，以及 is_archived 來歸檔或恢復。

Cursor 或 Claude Desktop

使用 Streamable HTTP 連接至托管的 MCP 伺服器，並使用您的個人 API 鑰匙。.cursor/mcp.json 的範例：

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

在應用程式中 設定 → API 下創建該鑰匙。

本地開發（倉庫複製）

如果您從 Speechdash 倉庫複製：

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

選擇性：在 bun dev:api 執行時，將 SPEECHDASH_API_BASE=http://localhost:3003/v1 指向本地 API。

Streamable HTTP（本地）

在本地開發時，對於 HTTP MCP 客戶端：

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

預設端點：http://127.0.0.1:3010/mcp

變數用途
SPEECHDASH_API_KEY針對標準輸入/輸出為必需；在 本地 HTTP 伺服器上，如果客戶端傳送 Authorization: Bearer，則為選擇性
SPEECHDASH_API_BASEAPI 基本 URL（預設 https://api.speechdash.com/v1）
MCP_TRANSPORTstdio（預設）或 http
MCP_HOSTHTTP 綁定主機（預設 127.0.0.1）
MCP_PORTHTTP 端口（預設 3010）

可供代理閱讀的文件

機器可讀產品上下文，供 AI 搜索器使用：

Agents hub（網站）

agents.md

OpenAPI JSON

GitHub 上的範例

相關

API 概覽

API 鑰匙與 MCP（使用者指南）

信用錢包

連接器（應用程式設定）

API 概覽

從您自己的應用程式調用 Speechdash，並創建授權該應用程式的 API 金鑰。

Account

Authenticated account and wallet.

On this page

開始之前ChatGPT (OAuth)工具MCP vs REST 功能計費Cursor 或 Claude Desktop本地開發（倉庫複製）Streamable HTTP（本地）可供代理閱讀的文件相關