開發者

將 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
所有操作都在 OpenAPI 描述中

開發者常見問題

使用 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 應用程式。

開始整合

登入 WŬMÙ,在開發者控制台建立應用程式並取得密鑰。