開發者

將 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Ù,在開發者主控台建立應用程式並取得金鑰。