开发者
将 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 应用。