Для разработчиков

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

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

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

Попробовать бесплатно