Для розробників

MCP-сервер: підключіть Claude і ChatGPT

Wlaunch має сервер Model Context Protocol (MCP). Підключіть до нього Claude, ChatGPT чи будь-який інший MCP-клієнт, і ваш AI-асистент відповідатиме на запитання про дані вашого бізнесу у Wlaunch: клієнтів, записи, фінанси та звіти. Він лише читає дані й нічого не змінює.

Адреса MCP-сервера

https://mcp.wlaunch.net/mcp
  • Лише читання
  • Розширена ліцензія
  • Streamable HTTP

Markdown-версія (англійською)

Що вміє MCP-сервер

Він дає AI-асистенту доступ на читання до ваших даних у Wlaunch через 25 інструментів. Вони охоплюють:

  • Клієнти

  • Записи

  • Розклади

  • Послуги

  • Абонементи

  • Замовлення

  • Фінанси

  • Зарплата

  • Склад

  • Оцінки

  • Опитування

  • Повідомлення

  • Звіти: P&L, рух коштів, залишки коштів, статистика, утримання клієнтів

Кожен інструмент звертається до фіксованої адреси API, вибраної під час його розробки. Тож асистенту доступний перевірений перелік даних, а не будь-що, що він вирішить запитати.

Сервер лише читає. Жоден інструмент нічого не створює, не редагує, не скасовує й не видаляє: не створює записів, не змінює цін, не додає клієнтів. Кожен інструмент позначений як readOnlyHint: true.

Асистент також не бачить більше, ніж ви. Сервер не має власної авторизації: кожен запит іде до API Wlaunch від вашого імені, з тими самими правилами доступу за компаніями та правами, що й у бек-офісі. Якщо ваш обліковий запис не бачить зарплат філії, асистент їх теж не побачить.

Крім того, на сервері є 3 інструменти загального призначення для діагностики командою Wlaunch, наприклад wlaunch_api_get. На облікових записах клієнтів вони заблоковані: якщо асистент спробує їх викликати, ви побачите відмову.

Хто може ним користуватися

MCP-сервер входить до Розширеної ліцензії разом з API інтеграціями.

Для підключення вам знадобляться Розширена ліцензія й персональний токен доступу, який підтримка Wlaunch видає по запиту. Як його отримати, описано в наступному кроці.

Крок 1:Запросіть токен доступу

Токени доступу видає підтримка Wlaunch. Зверніться до підтримки й попросіть персональний токен доступу для свого облікового запису Wlaunch.

Підтримка надішле вам токен. У кожному прикладі нижче замініть <access_token> на нього.

Крок 2:Підключіть AI-клієнт

Сервер працює за протоколом MCP через Streamable HTTP і чекає на токен у стандартному заголовку Bearer у кожному запиті:

HTTP-заголовок
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:

~/.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.

Порядок кроків нижче важливий: спершу налаштуйте автентифікацію, потім заголовок.

  1. Відкрийте Customize → Connectors і натисніть Add custom connector.
  2. Введіть Wlaunch у поле Name (саме ця назва з'явиться у списку конекторів) і https://mcp.wlaunch.net/mcp у поле URL, потім натисніть Continue.
  3. У розділі Authentication виберіть No sign-in. Діалог може визначити Sign in now і вибрати його сам: не погоджуйтеся. Сервер не публікує метаданих OAuth discovery (кожна адреса /.well-known/oauth-* повертає 404), тож вхід не знайде сервера авторизації й завершиться помилкою. Коли вибрано No sign-in, розділ OAuth client більше не потрібен.
  4. У розділі Request headers натисніть Add header. Назва заголовка вибирається зі списку: виберіть authorization і введіть значення Bearer <access_token>. Залиште позначку Required. Вказуйте схему Bearer у значенні: токен без неї сервер відхилить. Інших назв заголовків сервер не читає, тож x-api-key та інші він проігнорує.
  5. Натисніть 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?"
}
EOF

require_approval визначає, чи модель чекатиме вашого підтвердження перед кожним викликом інструмента. У прикладі цього параметра немає, тож кожен виклик чекає на ваше підтвердження. Значення "never" можна ставити лише для асистента, у якого немає інструментів, що надсилають дані назовні: результати інструментів містять текст, який ввели ваші клієнти, наприклад імена й коментарі, і він може містити інструкції для моделі.

У цьому заголовку ваш токен Wlaunch передається OpenAI. Це таке саме рішення про довіру, як вставити його в будь-який хмарний асистент.

Інший MCP-клієнт

Використайте транспорт Streamable HTTP, адресу https://mcp.wlaunch.net/mcp і заголовок Authorization. У протоколі немає нічого специфічного для Wlaunch, тож підійде будь-який клієнт, який працює з MCP через HTTP і дозволяє задати заголовок.

Крок 3:Перевірте, що все працює

Запитайте свого асистента:

Які компанії бачить ця інтеграція?

Асистент має викликати wlaunch_company_context без аргументів і перелічити ваші компанії. Це єдиний інструмент, якому не потрібен ідентифікатор компанії, і з нього починається будь-яке інше запитання: він також повертає словник вашої компанії (статуси записів, філії, теги, типи фінансових операцій), без якого інші інструменти не відповідатимуть правильно.

Потім спробуйте справжнє запитання:

Скільки записів було завершено в нашій головній філії минулого місяця?

Що можна запитати

Найкраще працюють запитання, які ви поставили б менеджеру, а не ті, що ви набрали б у базі даних:

  • Які клієнти не записувалися з березня?
  • Яким був наш дохід минулого місяця в розрізі послуг?
  • Покажи розклад київської філії на наступний вівторок.
  • Клієнтка каже, що не отримала нагадування. Що сталося?
  • Які результати в кожного спеціаліста за першу половину червня?

Зазвичай асистент спершу читає словник вашої компанії, а вже потім робить інші запити.

Ліміти

Ліміти запитів

Ліміти рахуються за викликами інструментів, окремо для кожного користувача й кожної компанії, а загалом по всіх компаніях користувача вони обмежені в 3 рази більшим значенням.

Група лімітівЛімітІнструменти
general60 викликів за 5 хвилинУсі інші інструменти
expensive10 викликів за 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Досягнуто ліміту запитів. Дивіться ліміти вище.
upstreamAPI 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

Менше рутини, більше виручки

Записи, оплати, склад і зарплата в одній системі

Спробувати безкоштовно