通過 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 文件。