Підключення AI-асистента через MCP

Що таке MCP-сервер Wlaunch

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

У цій статті зібрано коротку інструкцію. Усі клієнти, ліміти та розв'язання проблем описані на сторінці для розробників.

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

MCP-сервер входить до Розширеної ліцензії разом з API інтеграціями. Для підключення вам знадобляться Розширена ліцензія й персональний токен доступу.

Як отримати токен доступу

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

Поводьтеся з токеном як з паролем:

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

Як підключити асистента

Адреса сервера:

https://mcp.wlaunch.net/mcp

Сервер чекає на токен у стандартному заголовку в кожному запиті:

Authorization: Bearer <access_token>

У кроках для Claude Desktop нижче замініть <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 Code записує токен у свою конфігурацію відкритим текстом, тож поводьтеся з цим файлом як з обліковими даними.

Claude Desktop

Токен вводиться в розділі Request headers діалогу Add custom connector. Anthropic надає цей розділ у бета-версії обмеженому колу організацій: якщо у вашому діалозі його немає, підключіться через Claude Code. На тарифах Team і Enterprise власний конектор може додати лише власник (Owner), і тоді заголовок стає спільним для всіх в організації, тож там теж користуйтеся 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: не погоджуйтеся, бо вхід завершиться помилкою.
4. У розділі Request headers натисніть Add header, виберіть authorization і введіть значення Bearer <access_token>.
5. Натисніть Add.

Інструкції для Codex CLI, ChatGPT та інших MCP-клієнтів є на сторінці для розробників.

Як перевірити, що все працює

Запитайте свого асистента: «Які компанії бачить ця інтеграція?»

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

Що асистент може, а чого ні

• Читає дані через 25 інструментів: клієнти, записи, розклади, послуги, абонементи, замовлення, фінанси, зарплата, склад, оцінки, опитування, повідомлення, а також звіти: P&L, рух коштів, залишки коштів, статистика, утримання клієнтів.
• Лише читає. Жоден інструмент нічого не створює, не редагує, не скасовує й не видаляє: асистент не створить запис, не змінить ціну й не додасть клієнта.
• Бачить не більше, ніж ви. Кожен запит іде від імені вашого облікового запису з тими самими правами доступу, що й у бек-офісі. Якщо ваш обліковий запис не бачить зарплат філії, асистент їх теж не побачить.

Приклади запитань для власника й менеджера зібрані в окремому посібнику.