開發者
將 WŬMÙ 連接到您的系統
WŬMÙ 提供三種整合方式:應用程式透過支援 PKCE 的 OAuth 2.0 登入,並透過附 OpenAPI 描述的 REST API v2 處理資料;AI 助理則透過連結連接到 MCP 伺服器。
密鑰在開發者控制台發出:登入 WŬMÙ,建立應用程式並取得 client_id。
https://wumu.ai
- 授權
- /api/oauth/authorize
- 權杖
- /api/oauth/token
- REST API v2
- /api/v2
- OpenAPI
- /api/v2/openapi.json
- MCP 伺服器
- /mcp
三種連接方式
選擇連接方式
您自己的應用程式或服務透過 OAuth 和 REST API 連接。AI 助理透過 MCP 伺服器連接,毋須註冊應用程式。
支援 PKCE 的 OAuth 2.0
適用於在 WŬMÙ 用戶同意後處理其資料的網站、服務和流動應用程式。
- 配合 PKCE(S256)的授權碼與更新權杖輪換;伺服器之間的呼叫使用 client_credentials
- 用戶會看到同意畫面,只授予所需的權限範圍:個人資料、文件、聊天、聯絡人等
- 公開客戶端(流動應用程式和 SPA)不會獲發密鑰
- 以 HMAC-SHA256 簽署的 Webhook,以及開發者控制台內的請求與傳送記錄
- 新的應用程式經 WŬMÙ 管理員審核後開始運作
REST API v2
用於文件、試算表、AI 聊天、即時通訊、聯絡人、日曆及 WŬMÙ 其他部分的 JSON API。
- 機器可讀的 OpenAPI 描述,列明每項操作所需的權限範圍
- 存取權杖透過 Authorization: Bearer 標頭傳送
- 每組「應用程式—用戶」設有每分鐘請求上限;超出時回應 429
MCP 伺服器
AI 助理透過連結連接到 WŬMÙ 帳戶——毋須密鑰、毋須開發者應用程式,也毋須安裝任何程式。
- Claude(claude.ai、Claude Desktop、Claude Code)、開發者模式下的 ChatGPT、Cursor,以及其他支援遠端 MCP 伺服器與 OAuth 登入的客戶端
- 您以自己的帳戶登入並自行選擇開放的部分;讀取和修改是兩個獨立的開關
- 含有他人資料的部分——查詢、即時通訊、聯絡人——預設為關閉
- 您可隨時在帳戶的安全設定中中斷助理連接
連接網址
https://wumu.ai/mcp適用於 wumu.ai 帳戶https://wumu.ru/mcp適用於 wumu.ru 帳戶(俄羅斯)
請求範例
您的第一個請求
透過 OAuth 取得存取權杖並放在標頭中:第一個請求會傳回您與 AI 律師最近的五個聊天,需要 read:chats 權限。第二個指令會將 WŬMÙ 的 MCP 伺服器加入 Claude Code。
# 與 AI 律師最近的五個聊天
curl "https://wumu.ai/api/v2/threads?agent=lawyer&limit=5" \
-H "Authorization: Bearer $TOKEN"# 將 WŬMÙ 的 MCP 伺服器加入 Claude Code
claude mcp add --transport http wumu https://wumu.ai/mcp開發者常見問題
使用 WŬMÙ API 需要付費計劃嗎?
OAuth 應用程式和 REST API v2 毋須付費計劃:任何 WŬMÙ 計劃(包括免費計劃)都可建立應用程式。AI 助理在免費計劃下亦可連接到 WŬMÙ 的 MCP 伺服器,存取您的個人資料、城市草稿和說明中心;其他部分需要您本人的 Pro 或更高計劃,Business 試用期同樣適用。
如何取得 WŬMÙ API 密鑰?
登入 WŬMÙ 並開啟開發者控制台。建立應用程式,填寫名稱、重新導向網址和權限範圍。您會取得 client_id,伺服器端應用程式還會取得 client_secret——它只會顯示一次,請妥善保存。應用程式經 WŬMÙ 管理員審核後開始發出權杖。
WŬMÙ REST API 的描述在哪裡?
REST API v2 的 OpenAPI 描述毋須登入即可在 /api/v2/openapi.json 取得:可匯入任何支援 OpenAPI 的工具,或據此產生客戶端。WŬMÙ 授權伺服器的元數據位於 /.well-known/openid-configuration。
開啟 OpenAPI 描述WŬMÙ API 有請求數量限制嗎?
有。REST API v2 對每組「應用程式—用戶」設有限制:預設每分鐘 100 次請求,部分範疇(如即時通訊)有各自的上限。超出時伺服器會傳回狀態碼 429,請稍後再試。透過 MCP 連接的 AI 助理同樣有每分鐘請求上限。
WŬMÙ 的 MCP 伺服器和 OAuth 應用程式有何分別?
WŬMÙ 的 MCP 伺服器是為 AI 助理預備的現成連接:毋須註冊任何東西,只要貼上網址並以您的帳戶登入即可。當您開發自己的整合——代表用戶呼叫 REST API v2 的網站、服務或流動應用程式——時,就需要 OAuth 應用程式。