Для розробників
MCP-сервер: підключіть Claude і ChatGPT
Wlaunch має сервер Model Context Protocol (MCP). Підключіть до нього Claude, ChatGPT чи будь-який інший MCP-клієнт, і ваш AI-асистент відповідатиме на запитання про дані вашого бізнесу у Wlaunch: клієнтів, записи, фінанси та звіти. Він лише читає дані й нічого не змінює.
Адреса MCP-сервера
https://mcp.wlaunch.net/mcp- Лише читання
- Розширена ліцензія
- Streamable HTTP
Що вміє MCP-сервер
Він дає AI-асистенту доступ на читання до ваших даних у Wlaunch через 25 інструментів. Вони охоплюють:
Клієнти
Записи
Розклади
Послуги
Абонементи
Замовлення
Фінанси
Зарплата
Склад
Оцінки
Опитування
Повідомлення
Звіти: P&L, рух коштів, залишки коштів, статистика, утримання клієнтів
Кожен інструмент звертається до фіксованої адреси API, вибраної під час його розробки. Тож асистенту доступний перевірений перелік даних, а не будь-що, що він вирішить запитати.
Сервер лише читає. Жоден інструмент нічого не створює, не редагує, не скасовує й не видаляє: не створює записів, не змінює цін, не додає клієнтів. Кожен інструмент позначений як readOnlyHint: true.
Асистент також не бачить більше, ніж ви. Сервер не має власної авторизації: кожен запит іде до API Wlaunch від вашого імені, з тими самими правилами доступу за компаніями та правами, що й у бек-офісі. Якщо ваш обліковий запис не бачить зарплат філії, асистент їх теж не побачить.
Крім того, на сервері є 3 інструменти загального призначення для діагностики командою Wlaunch, наприклад wlaunch_api_get. На облікових записах клієнтів вони заблоковані: якщо асистент спробує їх викликати, ви побачите відмову.
Хто може ним користуватися
MCP-сервер входить до Розширеної ліцензії разом з API інтеграціями.
Розширена ліцензія на сторінці цін
Для підключення вам знадобляться Розширена ліцензія й персональний токен доступу, який підтримка Wlaunch видає по запиту. Як його отримати, описано в наступному кроці.
Крок 1:Запросіть токен доступу
Токени доступу видає підтримка Wlaunch. Зверніться до підтримки й попросіть персональний токен доступу для свого облікового запису Wlaunch.
Запросити токен у підтримки Wlaunch
Підтримка надішле вам токен. У кожному прикладі нижче замініть <access_token> на нього.
Крок 2:Підключіть AI-клієнт
Сервер працює за протоколом MCP через Streamable HTTP і чекає на токен у стандартному заголовку Bearer у кожному запиті:
Authorization: Bearer <access_token>Claude Code
Покладіть токен у змінну середовища WLAUNCH_MCP_TOKEN, завантаживши його з менеджера секретів або системного сховища ключів, а потім додайте сервер із термінала:
claude mcp add --transport http wlaunch https://mcp.wlaunch.net/mcp \
--header "Authorization: Bearer $WLAUNCH_MCP_TOKEN"Перевірте, що сервер додано, командою claude mcp list, а видалити його можна командою claude mcp remove wlaunch. Не вводьте сам токен у команду: оболонка зберігає кожну команду в історії. Claude Code записує токен у свою конфігурацію відкритим текстом, тож поводьтеся з цим файлом як з обліковими даними.
Codex CLI
Коли токен уже в змінній середовища WLAUNCH_MCP_TOKEN, додайте сервер:
codex mcp add wlaunch \
--url https://mcp.wlaunch.net/mcp \
--bearer-token-env-var WLAUNCH_MCP_TOKENАбо додайте його у ~/.codex/config.toml:
[mcp_servers.wlaunch]
url = "https://mcp.wlaunch.net/mcp"
bearer_token_env_var = "WLAUNCH_MCP_TOKEN"bearer_token_env_var містить не сам токен, а назву змінної середовища: Codex читає її під час підключення й надсилає Authorization: Bearer <access_token>. Надавайте перевагу цьому способу, а не запису токена у файл. Це єдиний клієнт тут, який тримає токен поза конфігурацією та логами: завантажуйте токен у змінну середовища з менеджера секретів або системного сховища ключів, а не записуйте його відкритим текстом у профіль оболонки чи репозиторій.
Також існують http_headers (фіксоване значення) і env_http_headers (значення зі змінної середовища), але цей сервер читає лише заголовок Authorization, тож використовуйте bearer_token_env_var.
Claude Desktop
Додайте сервер як власний конектор. Токен вводиться в розділі Request headers діалогу Add custom connector.
Розділ Request headers Anthropic надає в бета-версії обмеженому колу організацій. Якщо у вашому діалозі немає розділу Request headers, ваш обліковий запис ще не має до нього доступу, і Claude Desktop не зможе передати цьому серверу ваш токен: підключіться через Claude Code.
На тарифах Team і Enterprise власний конектор може додати лише власник (Owner) у Organization settings → Connectors, і збережений там заголовок стає спільними обліковими даними для всіх в організації. Це суперечить правилу «один токен на людину», тож на цих тарифах підключайтеся через Claude Code.
Порядок кроків нижче важливий: спершу налаштуйте автентифікацію, потім заголовок.
- Відкрийте Customize → Connectors і натисніть Add custom connector.
- Введіть
Wlaunchу поле Name (саме ця назва з'явиться у списку конекторів) іhttps://mcp.wlaunch.net/mcpу поле URL, потім натисніть Continue. - У розділі Authentication виберіть No sign-in. Діалог може визначити Sign in now і вибрати його сам: не погоджуйтеся. Сервер не публікує метаданих OAuth discovery (кожна адреса
/.well-known/oauth-*повертає404), тож вхід не знайде сервера авторизації й завершиться помилкою. Коли вибрано No sign-in, розділ OAuth client більше не потрібен. - У розділі Request headers натисніть Add header. Назва заголовка вибирається зі списку: виберіть
authorizationі введіть значенняBearer <access_token>. Залиште позначку Required. Вказуйте схемуBearerу значенні: токен без неї сервер відхилить. Інших назв заголовків сервер не читає, тожx-api-keyта інші він проігнорує. - Натисніть Add. Діалог зберігає значення заголовків і більше їх не показує, тож тримайте токен там, звідки зможете його дістати.
Якщо authorization у списку неактивний, у вас досі вибрано Sign in now. У цьому режимі Claude сам заповнює цей заголовок і не дає його змінити. Поверніться, виберіть No sign-in і знову відкрийте список.
Після підключення на сторінці конектора з'явиться розділ Tool permissions: 28 інструментів лише для читання, разом з інструментами діагностики. Для кожного можна вибрати Always allow, Needs approval, Blocked або Custom, окремо чи для всієї групи одразу. Усі інструменти лише читають, але в їхніх результатах є текст, який ввели ваші клієнти, наприклад імена й коментарі, і такий текст може містити інструкції для асистента. Вибирайте Always allow, лише якщо в цього асистента немає інструментів, які можуть надсилати дані назовні; інакше залиште Needs approval, принаймні для wlaunch_api_get.
Застосунок ChatGPT
У застосунку ChatGPT власні конектори розташовані в Settings → Connectors, на тарифах, де є Developer Mode. Додайте сервер за адресою:
https://mcp.wlaunch.net/mcpДіалог конекторів ChatGPT розрахований на OAuth або роботу без автентифікації, а цьому серверу потрібен фіксований токен Bearer. Якщо діалог не дає поля для власного заголовка, таке поєднання не підтримується, і робочим шляхом є Responses API нижче. Ми не змогли перевірити, як поводиться поточна версія діалогу, тож спробуйте застосунок, а якщо не вийде, скористайтеся API.
ChatGPT: Responses API
Responses API від OpenAI приймає MCP-сервер як інструмент і дозволяє задати заголовки, а саме це потрібно цьому серверу. Коли токен уже в змінній середовища WLAUNCH_MCP_TOKEN, надішліть запит:
curl https://api.openai.com/v1/responses \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d @- <<EOF
{
"model": "gpt-5",
"tools": [{
"type": "mcp",
"server_label": "wlaunch",
"server_url": "https://mcp.wlaunch.net/mcp",
"headers": { "Authorization": "Bearer $WLAUNCH_MCP_TOKEN" }
}],
"input": "What companies can this integration see?"
}
EOFrequire_approval визначає, чи модель чекатиме вашого підтвердження перед кожним викликом інструмента. У прикладі цього параметра немає, тож кожен виклик чекає на ваше підтвердження. Значення "never" можна ставити лише для асистента, у якого немає інструментів, що надсилають дані назовні: результати інструментів містять текст, який ввели ваші клієнти, наприклад імена й коментарі, і він може містити інструкції для моделі.
У цьому заголовку ваш токен Wlaunch передається OpenAI. Це таке саме рішення про довіру, як вставити його в будь-який хмарний асистент.
Інший MCP-клієнт
Використайте транспорт Streamable HTTP, адресу https://mcp.wlaunch.net/mcp і заголовок Authorization. У протоколі немає нічого специфічного для Wlaunch, тож підійде будь-який клієнт, який працює з MCP через HTTP і дозволяє задати заголовок.
Крок 3:Перевірте, що все працює
Запитайте свого асистента:
Які компанії бачить ця інтеграція?
Асистент має викликати wlaunch_company_context без аргументів і перелічити ваші компанії. Це єдиний інструмент, якому не потрібен ідентифікатор компанії, і з нього починається будь-яке інше запитання: він також повертає словник вашої компанії (статуси записів, філії, теги, типи фінансових операцій), без якого інші інструменти не відповідатимуть правильно.
Потім спробуйте справжнє запитання:
Скільки записів було завершено в нашій головній філії минулого місяця?
Що можна запитати
Найкраще працюють запитання, які ви поставили б менеджеру, а не ті, що ви набрали б у базі даних:
- Які клієнти не записувалися з березня?
- Яким був наш дохід минулого місяця в розрізі послуг?
- Покажи розклад київської філії на наступний вівторок.
- Клієнтка каже, що не отримала нагадування. Що сталося?
- Які результати в кожного спеціаліста за першу половину червня?
Зазвичай асистент спершу читає словник вашої компанії, а вже потім робить інші запити.
Ліміти
Ліміти запитів
Ліміти рахуються за викликами інструментів, окремо для кожного користувача й кожної компанії, а загалом по всіх компаніях користувача вони обмежені в 3 рази більшим значенням.
| Група лімітів | Ліміт | Інструменти |
|---|---|---|
general | 60 викликів за 5 хвилин | Усі інші інструменти |
expensive | 10 викликів за 5 хвилин | reports_*, statistics_*, retention_*, clients_segment |
Коли ліміт вичерпано, ви не отримаєте HTTP 429, і заголовка Retry-After теж не буде. Виклик інструмента успішний на рівні протоколу й повертає помилку, у якій вказано групу, ліміт і скільки чекати:
{
"error": "rate_limited",
"message": "Rate limit reached for expensive tools: 10 calls per window.",
"guidance": "Wait 47 seconds before calling this tool again. …",
"metadata": { "bucket": "expensive", "limit": 10, "resetInMs": 47000 }
}Розмір сторінки та великі відповіді
За замовчуванням сторінка містить 20 записів, максимум 100: це межа самого API Wlaunch.
Великі відповіді скорочуються цілими рядками, рядок ніколи не обривається посередині. У такому разі відповідь про це повідомляє, а total лишається точним, тож кількості можна довіряти, навіть коли список неповний. Якщо потрібна лише кількість, це один виклик із size: 1.
Якщо щось пішло не так
Підключення відхилено з HTTP 401
Тіло відповіді й заголовок WWW-Authenticate містять машинозчитуваний код помилки. Дивіться на код, а не на текст: зрозумілий людині опис навмисно однаковий в усіх випадках, щоб той, хто підбирає доступ, не дізнався, яка частина його спроби хибна.
| Код | Що це означає | Що робити |
|---|---|---|
invalid_request | Заголовка Authorization немає, або він має неправильний формат. | Додайте заголовок у форматі Bearer <access_token>. |
invalid_token | Заголовок має правильний формат, але токен відхилено або він більше не дійсний. | Запросіть новий токен у підтримки Wlaunch і оновіть налаштування клієнта. |
Інструмент повертає помилку замість відповіді
Такі помилки приходять як звичайний результат інструмента з полем error, а не як HTTP-помилка:
| Код | Що це означає |
|---|---|
plan_restricted | Ваша ліцензія не містить цієї функції. Це не те саме, що відсутність даних: кількість невідома, а не нульова. |
forbidden | Вашому обліковому запису Wlaunch бракує прав на цю компанію чи ресурс. |
not_found | Такого ідентифікатора немає, або він вам недоступний. |
validation | Асистент передав хибний аргумент. Він має виправитися й повторити спробу. |
rate_limited | Досягнуто ліміту запитів. Дивіться ліміти вище. |
upstream | API Wlaunch недоступне або не відповіло вчасно. Повторіть спробу трохи пізніше. |
Відкликаний токен може працювати ще до хвилини
Сервер кешує перевірку токена на 60 секунд. Якщо токен анулювали, виклики можуть проходити ще до хвилини. Щойно виданий токен працює одразу.
Технічна довідка
- Адреса MCP
https://mcp.wlaunch.net/mcp- Транспорт
Streamable HTTP- Автентифікація
Bearer <access_token>у заголовкуAuthorization, єдиному заголовку, який читає сервер- Токен доступу
- Персональний, видає підтримка Wlaunch по запиту
- Метадані OAuth discovery
- Немає:
/.well-known/oauth-*повертає404 - Кеш перевірки токена
- 60 секунд
- Доступ
- Лише читання, кожен інструмент позначений
readOnlyHint: true - Інструменти
- 25