Розробникам
Підключіть 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.aihttps://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Запитання розробників
Чи потрібен платний тариф, щоб працювати з 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 від імені користувачів.