開發者
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。