MCP 端點
最後更新
新增、登入與管理 MCP 伺服器及其工具的端點。
| Method | 路徑 | 說明 |
|---|---|---|
GET POST | /v1/mcp | local — 列出 / 新增 MCP server。POST {name, server} 把一筆設定寫入 MCP 設定檔；server 必須帶 command 或 url（否則回 400）。GET 另回傳 HTTP server 的 oauth: {name: bool}，表示哪些已持有 token |
POST | /v1/mcp/remove | local — {name}。移除 MCP server；名稱不在設定中時回 404 |
GET | /v1/mcp/status | local — 各 server 的連線狀態 |
POST | /v1/mcp/reconnect | local — 重連所有 MCP client 並重新註冊工具 |
GET | /v1/mcp/oauth?name=X | local — 單一 HTTP MCP server 的 SSE OAuth 登入，流程與 provider 相同：先送 {"url":...} 供瀏覽器開啟，再送 {"done":true,"ok":...}（登入後重連失敗時附 reconnect_error）。10 分鐘或 client 斷線後逾時。server 未設定或不是 HTTP/SSE server 時回 404 |
POST | /v1/mcp/oauth/callback | local — {name, url}。瀏覽器無法連到 daemon 在 localhost:17988 的 loopback listener 時，把 redirect URL 貼回來；code 由 URL query 解析。沒有等待中的登入時回 400 |
POST | /v1/mcp/oauth/client | local — {name, client_id, client_secret?, redirect_uri?}。為拒絕動態註冊的 server 儲存預先註冊的 OAuth client；redirect_uri 預設 http://localhost:17988/callback，必須與 provider console 完全一致。會先清除既有 token，回傳 {ok, redirect_uri}；404 條件與登入相同 |
DELETE | /v1/mcp/oauth | local — {name}。同時清除該 server 的 token 與 client 註冊 |