Carbon Voice MCP Server

什么是 Carbon Voice MCP Server？

Carbon Voice MCP Server 是 Carbon Voice 官方的远程 MCP 服务器。Carbon Voice 是一款面向团队和 AI 智能体的异步语音消息应用。该服务器让 Claude、Cursor 等 MCP 客户端可以读取和发送语音消息，管理会话、文件夹和待办事项，并运行摘要等 AI 操作。

Carbon Voice 以一键语音消息为核心，消息会自动转写，并在此基础上提供 AI 摘要和待办事项。其开发商 PhononX 将 MCP 服务器开源（PhononX/cv-mcp-server），并在 https://mcp.carbonvoice.app 托管远程版本。远程版本使用 OAuth 2.1，因此你无需处理 API key。

如何使用 Carbon Voice MCP Server？

使用远程服务器只需要一个 Carbon Voice 账号。根据 README，HTTP 版本“完全运行在云端并使用 OAuth2 认证”，因此不需要 API key，也不需要安装 Node.js。首次使用时，客户端会打开浏览器窗口，你在其中登录 Carbon Voice 并授予权限。

https://mcp.carbonvoice.app

Claude Code

claude mcp add --transport http carbon-voice https://mcp.carbonvoice.app

运行 /mcp 并选择 Authenticate，完成 Carbon Voice 登录。

Claude Desktop 和 claude.ai

根据 README：打开 Search and Tools → Manage Connectors，点击 Add custom connector，命名为“Carbon Voice”，输入 https://mcp.carbonvoice.app 并保存，然后点击 Connect 并用 Carbon Voice 账号登录。

Cursor

README 中的远程配置：

{
  "mcpServers": {
    "Carbon Voice": {
      "url": "https://mcp.carbonvoice.app"
    }
  }
}

保存并重启 Cursor；首次使用时它会引导你完成 OAuth。

VS Code

在 .vscode/mcp.json 中：

{
  "servers": {
    "carbon-voice": {
      "type": "http",
      "url": "https://mcp.carbonvoice.app"
    }
  }
}

还有一个本地 stdio 版本（npx -y @carbonvoice/cv-mcp-server，配合 CARBON_VOICE_API_KEY），但其 API key 需要向 Carbon Voice 开发团队申请，因此远程服务器更简单。

Carbon Voice MCP Server 的主要功能

• Carbon Voice 团队的官方服务器，远程托管并使用 OAuth 2.1。
• 消息管理：列出、读取和发送会话消息及私信。
• 语音备忘录：可由文本（通过语音合成朗读）或公开 HTTPS URL 上的音频创建。
• 会话、用户和工作区查询。
• 文件夹操作：创建、重命名、移动和删除文件夹，并把消息归档到文件夹中。
• AI 操作：列出并在消息上运行 Carbon Voice 的 AI 提示，包括会话摘要。
• 待办事项：创建、分配和跟踪，并用 AI 从消息中提取建议的待办。
• 收件箱、未读和已听状态搜索、分享链接以及链接附件。

Carbon Voice MCP Server 的使用场景

• 快速了解进展：“总结我团队会话中还没听的消息。”
• 免手动更新：“给设计频道发一条语音备忘录，说评审改到周四。”
• 记录任务：“从 Sarah 今天的消息中提取待办事项并加到我的列表里。”
• 整理归档：“把所有关于第三季度发布的消息移到一个名为 Launch 的新文件夹。”
• 查看状态：“哪些待办事项分配给我并且还没完成？”

Carbon Voice MCP Server 常见问题排查

• 客户端没有显示工具。 远程服务器需要先完成 OAuth 登录才会列出工具；请完成浏览器流程，或在客户端的 MCP 设置中重新认证。
• 测试 URL 时出现“Missing Authorization header”。 这是未认证请求的正常响应；请使用支持 OAuth 的 MCP 客户端。
• 通过 URL 创建语音备忘录失败。 服务器只获取公开的 https 音频 URL，拒绝私有或回环地址，并限制文件大小（默认 25 MB）。
• 列表结果太长。 大多数读取工具接受可选的 response_fields 列表，只返回你需要的字段。