开发者

将 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Ù,在开发者控制台创建应用并获取密钥。