Разработчикам
Подключите WŬMÙ к своим системам
WŬMÙ открыт для интеграций тремя способами: приложения входят через OAuth 2.0 с PKCE и работают с данными через REST API v2 с описанием OpenAPI, а ИИ-помощники подключаются к MCP-серверу по ссылке.
Ключ выдаётся в кабинете разработчика: войдите в WŬMÙ, создайте приложение и получите client_id.
https://wumu.ru
- Авторизация
- /api/oauth/authorize
- Токены
- /api/oauth/token
- REST API v2
- /api/v2
- OpenAPI
- /api/v2/openapi.json
- MCP-сервер
- /mcp
Три способа подключения
Выберите, как подключиться
Своё приложение или сервис подключается через OAuth и REST API. ИИ-помощник — через MCP-сервер, без регистрации приложения.
OAuth 2.0 с PKCE
Для сайтов, сервисов и мобильных приложений, которые работают с данными пользователя WŬMÙ с его согласия.
- Код авторизации с PKCE (S256) и ротацией токенов обновления; для связи сервер–сервер — client_credentials
- Пользователь видит экран согласия и выдаёт только нужные области доступа: профиль, документы, чаты, контакты и другие
- Публичным клиентам — мобильным приложениям и SPA — секрет не выдаётся
- Вебхуки с подписью HMAC-SHA256 и журнал запросов и доставок в кабинете разработчика
- Новое приложение начинает работать после проверки администратором WŬMÙ
REST API v2
JSON API к документам, таблицам, чатам с ИИ, мессенджеру, контактам, календарю и другим разделам WŬMÙ.
- Машиночитаемое описание OpenAPI: у каждой операции указаны нужные области доступа
- Токен доступа передаётся в заголовке Authorization: Bearer
- Лимит запросов в минуту на пару «приложение — пользователь»; при превышении — ответ 429
MCP-сервер
ИИ-помощник подключается к аккаунту WŬMÙ по ссылке — без ключей, без приложения разработчика и без установки программ.
- Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT в режиме разработчика, Cursor и другие клиенты с поддержкой удалённых MCP-серверов и входа через OAuth
- Вы входите своим аккаунтом и сами включаете разделы; чтение и изменение — отдельными переключателями
- Разделы с данными других людей — заявки, мессенджер, контакты — по умолчанию выключены
- Отключить помощника можно в любой момент в настройках безопасности аккаунта
Адрес подключения
https://wumu.ai/mcpДля аккаунта на wumu.aihttps://wumu.ru/mcpДля аккаунта на wumu.ru (Россия)
Пример запроса
Первый запрос
Получите токен доступа через OAuth и передайте его в заголовке: первый запрос вернёт пять последних чатов с ИИ-юристом, для него нужна область read:chats. Вторая команда подключает MCP-сервер WŬMÙ в Claude Code.
# пять последних чатов с ИИ-юристом
curl "https://wumu.ru/api/v2/threads?agent=lawyer&limit=5" \
-H "Authorization: Bearer $TOKEN"# подключить MCP-сервер WŬMÙ в Claude Code
claude mcp add --transport http wumu https://wumu.ru/mcpВопросы разработчиков
Нужен ли платный тариф, чтобы работать с API WŬMÙ?
Для приложений OAuth и REST API v2 платный тариф не нужен: приложение создаётся на любом тарифе WŬMÙ, включая бесплатный. ИИ-помощника можно подключить к MCP-серверу WŬMÙ и на бесплатном тарифе — с доступом к профилю, черновикам в городе и справке; для остальных разделов нужен собственный тариф Pro или выше, пробный период Business тоже подходит.
Как получить ключ API WŬMÙ?
Войдите в WŬMÙ и откройте кабинет разработчика. Создайте приложение: название, адреса возврата и области доступа. Вы получите client_id, а серверное приложение — ещё и client_secret: он показывается один раз, сохраните его. Приложение начнёт выдавать токены после проверки администратором WŬMÙ.
Где найти описание REST API WŬMÙ?
Описание REST API v2 в формате OpenAPI открыто без входа по адресу /api/v2/openapi.json: его можно загрузить в любой инструмент, который понимает OpenAPI, или сгенерировать по нему клиента. Параметры сервера авторизации WŬMÙ — по адресу /.well-known/openid-configuration.
Открыть описание OpenAPIЕсть ли у API WŬMÙ ограничения на число запросов?
Да. На REST API v2 действует лимит на пару «приложение — пользователь»: по умолчанию 100 запросов в минуту, у некоторых разделов, например мессенджера, — свой. При превышении сервер отвечает статусом 429 — повторите запрос позже. У подключения ИИ-помощника по MCP тоже есть лимит запросов в минуту.
Чем MCP-сервер WŬMÙ отличается от приложения OAuth?
MCP-сервер WŬMÙ — готовое подключение для ИИ-помощников: ничего не нужно регистрировать, достаточно вставить адрес и войти своим аккаунтом. Приложение OAuth нужно, когда вы пишете свою интеграцию — сайт, сервис или мобильное приложение, которое обращается к REST API v2 от имени пользователей.