SpeechdashHelp Center

MCP 服务器

将 Cursor、Claude Desktop、ChatGPT 或其他 MCP 客户端连接到 Speechdash 公共 API。

Speechdash 提供了一个官方的 模型上下文协议 (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 和其他接受令牌的客户端在应用中的设置 → 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 与 REST 功能对比

功能MCPREST
账户快照是 (speechdash_get_account)GET /v1/me
文档 CRUD（库，包括完成的转录）是是
开始音频转录任务否（仅限应用）否（仅限应用）
非流式语音（5k 字符）是POST /v1/audio/speech
流式语音（20k 字符）否，使用 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

使用可流式 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。

流式 HTTP（本地）

对于本地开发中的 HTTP MCP 客户端：

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

默认端点：http://127.0.0.1:3010/mcp

变量用途
SPEECHDASH_API_KEY对于 stdio 来说是必需的；在本地 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.md

OpenAPI JSON

GitHub 上的示例

相关

API 概览

API 键和 MCP（用户指南）

信用钱包

连接器（应用设置）

API 概览

通过您自己的应用程序调用 Speechdash，并创建授权该应用程序的 API 密钥。

Account

Authenticated account and wallet.

On this page

开始之前ChatGPT（OAuth）工具MCP 与 REST 功能对比计费Cursor 或 Claude Desktop本地开发（仓库克隆）流式 HTTP（本地）代理可读文档相关