通过 Claude 使用 MCP
通过 Model Context Protocol 从 Claude Desktop 驱动你的 Buda 智能体——用 API 密钥完成认证，直接在对话中调用 Buda。
你不该被迫离开正在进行的对话。 Buda 提供了一个 Model Context Protocol（MCP） 服务器，因此 Claude Desktop——以及任何支持 MCP 的客户端——都能直接调用你的 Buda 账户：列出智能体、启动任务、读取结果，全程无需切换应用。
MCP 是什么
MCP 是一个开放标准，让 AI 客户端能够调用外部工具并读取外部数据。Buda 的 MCP 端点把 Buda 的公开 API 封装为 MCP 工具，因此 MCP 客户端可以用你的 API 密钥完成认证，代表你操作你的账户。
配置 Claude Desktop
创建一个 API 密钥。 在 Buda 中打开 设置 → API 密钥 并生成一个。请立即复制——它只会显示这一次。详情见 认证。
把 Buda 添加到你的 MCP 配置中。 在 Claude Desktop 的 MCP 服务器配置里，添加一条指向 Buda 端点的条目：
{
"mcpServers": {
"buda": {
"url": "https://buda.im/api/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}重启 Claude Desktop，让它加载这个新服务器，然后确认 Buda 的工具已出现，便可开始让它对你的 Buda 账户执行操作。
用 API 密钥完成认证
Buda 的 MCP 服务器使用 bearer 认证——把你的 API 密钥放在 Authorization 请求头中，格式与上面所示完全一致。同一个密钥也驱动着 Buda 的 REST API，而 MCP 服务器会以持有该密钥的用户身份执行操作。请像对待密码一样对待它：不要放进共享配置中，一旦泄露就立即轮换。
任何持有你 API 密钥的人都能在 Buda 中以你的身份执行操作。请妥善保管，一旦泄露，立即在 设置 → API 密钥 中将其吊销。
可用的工具与资源
MCP 服务器由 Buda 的公开 OpenAPI 接口生成，因此其工具与 REST API 保持一致——列出和管理智能体、启动任务、读取它们的输出。如需操作的权威清单以及完整的请求与响应结构，请参阅 MCP 参考 和 REST API 文档。