Разработчикам

Подключите WŬMÙ к своим системам

WŬMÙ открыт для интеграций тремя способами: приложения входят через OAuth 2.0 с PKCE и работают с данными через REST API v2 с описанием OpenAPI, а ИИ-помощники подключаются к 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. ИИ-помощник — через 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.ai
    • https://wumu.ru/mcpДля аккаунта на wumu.ru (Россия)

Пример запроса

Первый запрос

Получите токен доступа через OAuth и передайте его в заголовке: первый запрос вернёт пять последних чатов с ИИ-юристом, для него нужна область read:chats. Вторая команда подключает MCP-сервер WŬMÙ в Claude Code.

# пять последних чатов с ИИ-юристом
curl "https://wumu.ai/api/v2/threads?agent=lawyer&limit=5" \
  -H "Authorization: Bearer $TOKEN"
# подключить MCP-сервер WŬMÙ в Claude Code
claude mcp add --transport http wumu https://wumu.ai/mcp
Все операции — в описании OpenAPI

Вопросы разработчиков

Нужен ли платный тариф, чтобы работать с 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 от имени пользователей.

Начните интеграцию

Войдите в WŬMÙ, создайте приложение в кабинете разработчика и получите ключ.