开发者
MCP 参考
Buda 的 Model Context Protocol 端点——URL、认证请求头，以及由 REST API 生成的工具。
让任何 MCP 客户端操作你的 Buda 账户。 Buda 提供一个 Model Context Protocol（MCP）服务器，它将 /api/v1 REST API 封装为 MCP 工具。把 Claude、Cursor 或任何支持 MCP 的客户端指向它，用你的 API 密钥认证，客户端就能列出智能体、启动会话、管理 Drive 并读取结果——使用的正是与 REST API 完全相同的操作。
如果你只是想一步步配置 Claude Desktop，请参阅 MCP 与 Claude。本页是技术参考。
端点与认证
| 值 | |
|---|---|
| 端点 | https://buda.im/api/mcp |
| 传输方式 | HTTP（Streamable HTTP） |
| 认证请求头 | Authorization: Bearer sk_... |
| 服务器名称 | Buda MCP |
认证是必需的。Bearer 令牌必须是一个 Buda API 密钥（必须以 sk_ 开头）；任何其他值都会被拒绝。该密钥解析到你账户的方式与在 REST API 中完全相同，并且 Buda 会在每次调用时记录该密钥的最近请求时间。
{
"mcpServers": {
"buda": {
"url": "https://buda.im/api/mcp",
"headers": { "Authorization": "Bearer sk_your_api_key" }
}
}
}请像对待任何存放 sk_ 密钥的地方一样对待 MCP 配置——不要把它留在共享机器和版本控制中。轮换与安全相关内容请参阅身份认证。
可用工具
Buda 的 MCP 工具是直接从 REST API 契约生成的，因此工具集始终与实时的 /api/v1 表面保持一致。每个 REST 操作都会变成一个 MCP 工具，输入和输出完全相同。其中包括（但不限于）：
- 用户——读取已认证的账户（
/users/me）。 - 空间——列出并创建空间（租户）。
- 智能体——列出并创建托管的 Claw（爪）智能体。
- Drive——列出、读取并写入智能体的 Drive 文件。
- 会话——创建会话、发送消息、读取状态与回复、取消运行。
- 定时任务——列出、创建、启用/禁用并运行智能体的定时任务。
如需获取权威且始终最新的工具列表及其精确的结构定义，请在 Swagger UI 或 OpenAPI JSON 中浏览源契约——其中的每个操作都会作为一个 MCP 工具开放出来。
限制
- 仅支持一种凭证类型。 MCP 端点只接受
sk_API 密钥；嵌入令牌和会话 Cookie 在此处无效。 - 账户作用域。 工具作用于该 API 密钥所能访问的范围——与 REST API 的权限相同，不会更多。
- 流式对话。 MCP 工具用于启动和读取智能体运行；逐 token 的实时流式输出由 REST 的流式端点提供，而非 MCP。