Для разработчиков
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