Speko MCP Server

什么是 Speko MCP Server？

位于 https://mcp.speko.ai/ 的 Speko MCP 服务器是公开、只读的 Speko Docs MCP：AI 助手无需登录，即可搜索和阅读 Speko 语音 AI 的 API、SDK、适配器、快速入门和迁移文档。

Speko 自称"语音 AI 的路由器"（the router for voice AI）。它提供托管的 Router，通过类型化契约把语音转文字（STT）、LLM 和文字转语音（TTS）流量发送给各家服务商；还提供面向 LiveKit 和 Pipecat 的开源客户侧 Gateway。Speko 还发布了覆盖 17 种语言的模型基准测试。这里收录的文档端点，是为了让编程智能体在写代码时随时查阅这些用法。涉及账户的操作（智能体、通话、电话号码）则由另一个需要认证的运营端点 https://mcp.speko.ai/mcp 负责。

如何使用 Speko MCP Server？

文档端点不需要账户、API 密钥或 OAuth 登录。在客户端中把它添加为远程 Streamable HTTP 服务器即可。

Claude Code

claude mcp add --transport http speko-docs https://mcp.speko.ai/

Claude Desktop 和 claude.ai

打开 Settings > Connectors > Add custom connector，取一个名称（例如"Speko Docs"），URL 填写 https://mcp.speko.ai/。

Cursor

在 ~/.cursor/mcp.json（或项目的 .cursor/mcp.json）中添加：

{
  "mcpServers": {
    "speko-docs": {
      "url": "https://mcp.speko.ai/"
    }
  }
}

VS Code

在 .vscode/mcp.json 中添加服务器：

{
  "servers": {
    "speko-docs": {
      "type": "http",
      "url": "https://mcp.speko.ai/"
    }
  }
}

连接完整的 Speko 工具集

如果要操作你的 Speko 账户，而不只是查文档，请连接运营端点。Speko 文档给出的命令如下：

npx @spekoai/mcp@latest init
claude mcp add --transport http speko https://mcp.speko.ai/mcp

该端点使用浏览器 OAuth 登录。做自动化时，也可以改为发送 Speko Platform API 密钥：Authorization: Bearer ${SPEKO_API_KEY}。密钥在 Speko Platform 控制台中创建和撤销，不能通过 MCP 管理。

Speko MCP Server 的主要功能

• 公开且只读：服务器自带说明写明它"从不暴露账户数据或写入工具，也不需要认证"。
• 内置 Speko 语音 AI 的 API、SDK、适配器、快速入门和迁移指南文档，以 MCP 资源形式提供。
• 文档索引资源（spekoai://docs/index）列出所有内置文档，每篇文档对应一个 spekoai://docs/{slug} 资源。
• 排序搜索返回 slug、标题、得分和摘要，适合在 API 校验报错后查找字段名。
• 设置工具返回运营端点、引导式安装命令，以及适用于 Claude Code、Codex、OpenCode 和 Cursor 的可直接复制的配置片段。
• 为支持 MCP Apps 的客户端提供设置卡片 UI 资源。

Speko MCP Server 工具

文档端点提供两个工具：

• 文档搜索：docs.search 搜索内置的 Speko 文档，为每条结果返回 slug、标题、得分和摘要。读取 spekoai://docs/{slug} 资源即可打开对应文档。
• 客户端设置：setup.connect 说明如何把 MCP 客户端连接到 Speko，返回运营端点、npx @spekoai/mcp@latest init 安装命令、登录方式以及各客户端的配置片段。

/mcp 运营端点的规模要大得多。Speko 的 MCP 指南称其提供 101 个工具，覆盖组织、智能体、会话、通话、电话号码、知识库、评测、部署、迁移辅助和用量数据。

Speko MCP Server 的使用场景

• 编写语音智能体时查阅 SDK 用法："在 Speko 文档里搜索如何在 LiveKit 中使用 Gateway 的 STT 插件。"
• API 报错后修正请求："我的 Speko 请求在 objective 字段上校验失败，帮我找到正确的字段格式。"
• 规划迁移："找到把现有语音智能体配置迁移到 Speko 的指南。"
• 帮同事配置客户端："怎样把 Speko 连接到 Cursor 和 Codex？"（智能体会调用 setup.connect。）
• 在决定连接账户级服务器之前，先为编程智能体提供安全、无需凭据的 Speko 背景资料。

Speko MCP Server 常见问题排查

• 需要账户操作，却只看到两个工具：你连接的是公开文档端点（https://mcp.speko.ai/）。请连接 https://mcp.speko.ai/mcp 并登录，以获得运营工具。
• 返回 401"Authentication required"：这来自 /mcp 运营端点，它需要 OAuth 登录或 Bearer API 密钥。根 URL 的文档端点两者都不需要。
• 在目录主机上调用工具返回"Unknown tool"：Speko 较精简的目录主机（例如 anthropic.speko.ai）按设计隐藏了部分工具，例如智能体部署和删除操作。