開發者
將 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 應用程式。