Розробникам

Підключіть 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Ù, створіть застосунок у кабінеті розробника й отримайте ключ.