Подключение AI-агентов к Fitness365 MCP
Как подключить MCP-сервер Fitness365 к ChatGPT, Claude, GigaCode Desktop, DeepSeek и другим клиентам. Первая часть для сотрудников клуба, вторая — для разработчиков.
Описание инструментов, формат запросов и ответов — в справочнике для разработчиков; готовые вопросы для владельца клуба — в каталоге типовых сценариев.
Подключение для пользователей клуба
Инструкция для сотрудников клуба: как подключить MCP-сервер CRM к ChatGPT (OpenAI), Claude, GigaCode Desktop или DeepSeek и задавать ассистенту вопросы по данным клуба обычным языком, например: «сколько сегодня посетителей в клубе?».
Что понадобится#
- Адрес MCP-сервера клуба:
https://<ваш-домен>.fitness365.ru/mcp/mcp?token=<КЛЮЧ_CRM>. Замените<ваш-домен>на домен своего клуба. Адрес заканчивается на/mcp/mcp(два раза «mcp»): первое — приложение на сервере, второе — точка подключения. Если указать только один/mcp, сервер ответит ошибкой 405. - Ключ CRM. Он подставляется в адрес вместо
<КЛЮЧ_CRM>. - Аккаунт в ChatGPT или Claude, установленное приложение GigaCode Desktop либо (для DeepSeek) приложение-клиент с поддержкой MCP.
Где взять ключ CRM#
В CRM откройте Настройки → CRM → Настройки по умолчанию (адрес раздела …fitness365.ru/#/crm-module-settings/List). В карточке найдите поле «Ключ CRM (Ключ для авторизации в системе Девпарк)» и скопируйте значение. Это тот же токен, что описан в разделе «Авторизация» (параметр CrmToken).
ChatGPT (OpenAI)#
- Нажмите на своё имя внизу слева и выберите Настройки.
- В настройках в блоке Интеграции откройте Плагины и нажмите Просмотреть каталог.
- На странице плагинов нажмите Добавить (справа вверху) и выберите Добавить пользовательский сервер MCP.
- Заполните форму:
- Название: любое, например
Fitness365или название клуба. - Описание: необязательно, например «Мой клуб».
- Подключение: вкладка «URL-адрес сервера», в поле адрес
https://<ваш-домен>.fitness365.ru/mcp/mcp?token=<КЛЮЧ_CRM>. - Аутентификация: «Без аутентификации».
- Название: любое, например
- Откройте Новый чат. При первом запуске выберите подключение в меню: наберите название подключения или откройте список через «+». Затем задайте вопрос, например: «сколько сегодня посетителей в клубе?».
Наличие пункта «Добавить пользовательский сервер MCP» зависит от тарифа и версии ChatGPT. Если пункта нет, проверьте настройки тарифа или обратитесь в поддержку OpenAI. В скриншотах использован аккаунт Free, гарантий для всех тарифов нет.
Claude (claude.ai и Claude Desktop)#
- Откройте Customize → Connectors (прямая ссылка:
claude.ai/customize/connectors). - Нажмите + Add, затем Add custom connector.
- Введите название (например,
Fitness365) и вставьте адрес сервераhttps://<ваш-домен>.fitness365.ru/mcp/mcp?token=<КЛЮЧ_CRM>. Нажмите Continue. - В блоке Authentication выберите No sign in (вход не нужен, ключ уже в адресе). Нажмите Continue, затем Add.
- В нужном чате нажмите «+» слева внизу (или введите
/), наведите на Connectors и включите подключение. Переключатель действует для конкретного чата. - Задайте вопрос по клубу. Когда Claude попросит разрешение на вызов инструмента, нажмите Allow. Вариант Allow always выбирайте только для проверенных инструментов.
Важно знать#
- На Free можно добавить только один пользовательский коннектор. На Pro, Max, Team и Enterprise ограничения нет.
- Team и Enterprise: коннектор добавляет владелец организации (Organization settings → Connectors → Add → Custom → Web), после чего участники нажимают Connect в Customize → Connectors.
- Claude обращается к серверу из облака Anthropic, поэтому адрес должен быть доступен из интернета. Домен
*.fitness365.ruдля этого подходит. - Изменить коннектор нельзя: удалите его (Remove или меню «…») и добавьте заново с новым адресом.
- Ключ можно передавать не только в адресе, но и в заголовке запроса
X-Crm-Token: <КЛЮЧ_CRM>: сервер принимает оба способа, а если указаны оба, берёт заголовок. Заголовок безопаснее: ключ не попадает в адрес и в журналы прокси. Если в вашей версии платформы есть поле для собственных заголовков запроса, укажите ключ там, а адрес оставьте без?token=…. Если такого поля нет, используйте адрес с?token=…. Работу заголовка в интерфейсе Claude мы не проверяли. Если коннектор не подключается, сообщите нам.
Claude Code (для разработчиков)#
Одна команда в терминале (адрес обязательно в кавычках из-за символов ? и =):
claude mcp add --transport http fitness365 "https://<ваш-домен>.fitness365.ru/mcp/mcp?token=<КЛЮЧ_CRM>"
Область действия по умолчанию — текущий проект. Чтобы подключение работало во всех проектах, добавьте --scope user. Проверить: claude mcp list (должно быть «Connected») или команда /mcp внутри Claude Code. Удалить: claude mcp remove fitness365.
Тот же сервер в файле .mcp.json:
{"mcpServers":{"fitness365":{"type":"http","url":"https://<ваш-домен>.fitness365.ru/mcp/mcp?token=<КЛЮЧ_CRM>"}}}
Не храните ключ в файле, который попадает в общий репозиторий.
GigaCode Desktop#
Сам GigaCode Desktop устанавливается по инструкции GitVerse. В нём MCP-сервер добавляется по HTTP, отдельной установки для него не требуется. Параметры подключения:
- Имя: любое, например
fitness365. - Транспорт:
HTTP(в окне он выбран по умолчанию; SSE и STDIO не нужны). - URL сервера:
https://<ваш-домен>.fitness365.ru/mcp/mcp?token=<КЛЮЧ_CRM>, где<ваш-домен>— домен вашего клуба (например,club123), а<КЛЮЧ_CRM>— ключ из CRM (см. «Где взять ключ CRM»).
Шаг 1. Откройте раздел MCP#
В левом меню GigaCode Desktop нажмите MCP (значок скрепки между пунктами «Навыки» и «Агенты»).
Шаг 2. Добавьте новый сервер#
На экране «MCP» нажмите + Добавить сервер в верхней части окна.
Шаг 3. Заполните параметры сервера#
В окне «Добавить MCP-сервер» введите имя, оставьте транспорт HTTP, вставьте адрес в поле «URL сервера» и нажмите Сохранить (справа внизу). Блок «Расширенные настройки» для подключения не нужен: ключ передаётся в адресе. Мы его не проверяли.
Шаг 4. Проверьте подключение#
После сохранения сервер появится в списке «Ваши серверы». Зелёный индикатор рядом с названием означает, что подключение успешно, красный — что есть проблема с подключением. Затем откройте новый чат и задайте первый запрос: «Какие у меня филиалы?». Ассистент должен вызвать инструмент get_branches и вернуть список филиалов (подробнее — «Как проверить подключение и с чего начать»).
Если подключение не работает#
| Что видно | Что делать |
|---|---|
| Красный индикатор | Проверьте, что адрес вставлен целиком, вместе с ?token=…, и заканчивается на /mcp/mcp, а ключ совпадает с полем «Ключ CRM». Проверьте доступ к интернету и работу сервера (команда curl ниже). |
| Сервер не появился в списке | Добавьте сервер ещё раз. |
| Сервер есть, но инструменты не видны | Перезапустите GigaCode Desktop. |
| Ошибка подключения | Убедитесь, что ключ CRM активен и скопирован без пробелов и переносов. Остальные коды ошибок — в таблице «Типовые ошибки» ниже. |
Скриншоты сняты в GigaCode Desktop; названия пунктов могут отличаться в других версиях. Для этого клиента мы подтвердили только добавление сервера по HTTP с ключом в адресе, передачу ключа заголовком X-Crm-Token не проверяли.
DeepSeek#
Встроенной поддержки MCP в чате DeepSeek мы не нашли: сайт и приложение DeepSeek не позволяют подключить пользовательский MCP-сервер, по крайней мере подтвердить это не удалось. Модель DeepSeek через API вызывает только функции, которые передаёт ваша программа. Поэтому DeepSeek подключают через сторонний клиент, который умеет и MCP, и API DeepSeek. Ниже пример с бесплатным приложением Cherry Studio.
Шаг 1. API-ключ DeepSeek#
Зарегистрируйтесь на platform.deepseek.com, откройте раздел API Keys и создайте ключ (строка вида sk-…). Использование API платное, по тарифам DeepSeek.
Шаг 2. Добавьте DeepSeek в Cherry Studio#
- Установите Cherry Studio и откройте Настройки → Модельные сервисы (в английской версии Settings → Model Services). Откройте провайдера DeepSeek.
- Вставьте ключ в поле «API-ключ». Адрес API по умолчанию
https://api.deepseek.com, менять его не нужно. - Нажмите «Получить список моделей», добавьте нужные модели знаком «+» и включите переключатель провайдера вверху справа. Проверьте работу кнопкой «Проверить».
Шаг 3. Добавьте MCP-сервер Fitness365#
- Откройте Настройки → MCP → MCP-серверы → Добавить.
- Укажите название, тип удалённого сервера (Streamable HTTP; если такого нет, используйте SSE или HTTP) и адрес
https://<ваш-домен>.fitness365.ru/mcp/mcp?token=<КЛЮЧ_CRM>. Сохраните и включите сервер. - Откройте сведения о сервере и убедитесь, что он в нормальном статусе и показывает список инструментов. Если нет, посмотрите журнал сервера.
- Привяжите сервер к ассистенту или агенту, который работает на модели DeepSeek, затем задайте вопрос по клубу.
Названия пунктов Cherry Studio сверяли по документации на китайском языке, поэтому в вашей версии подписи могут отличаться. Типы сервера (Streamable HTTP, SSE) и привязка к ассистенту в документации описаны не полностью, ориентируйтесь на окно «Добавить» в вашей версии. Модели DeepSeek тоже переименовываются: выбирайте из списка, который вернёт кнопка «Получить список моделей».
Как проверить подключение и с чего начать#
- Откройте новый чат и включите подключение Fitness365.
- Задайте первый запрос: «Какие у меня филиалы?». Ассистент должен вызвать инструмент
get_branchesи вернуть список филиалов клуба. Так проверяются и адрес, и ключ. - Затем задайте рабочий вопрос, например: «Сколько посетителей было вчера?» или «Какая выручка за прошлую неделю по филиалам?». Если вопрос про период, называйте даты: максимальный период одного запроса — 3 месяца.
- Готовые формулировки для владельца клуба, с описанием того, что и как считается, собраны в каталоге типовых вопросов и решений.
Администратор может проверить адрес и ключ без ассистента. В терминале (подставьте ключ клуба):
curl -s -X POST "https://<ваш-домен>.fitness365.ru/mcp/mcp" \
-H "X-Crm-Token: <КЛЮЧ_CRM>" \
-H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"check","version":"1"}}}'
В ответе должен быть блок serverInfo. Ответ {"error":"Неверный или отсутствующий токен."} значит, что адрес верный, но ключ не принят.
Права доступа и данные#
- Почти все инструменты Fitness365 только читают данные. Исключение — три инструмента записи:
crm_task_create(создать CRM-задачу по клиенту или лиду),lead_create(создать лида) иclient_create(создать клиента). Они работают только если администратор включил запись (опцияMcp:EnableWrites, по умолчанию выключена). Эти инструменты только добавляют записи (при создании задачи у клиента обновляется поле «последняя задача»); удалять данные клуба через подключение нельзя. - Вызовы инструментов чтения можно разрешать (в Claude — Allow). Вызовы инструментов записи подтверждайте по одному и не выбирайте Allow always: ассистент создаёт реальные записи в CRM клуба.
- Ключ CRM даёт доступ ко всем данным клуба, в том числе к персональным данным клиентов и к зарплатам сотрудников. Передавайте его только тем, кто имеет право видеть эти данные. Ключ виден пользователям, у которых есть доступ к настройкам CRM; при необходимости администратор заменяет его там же.
- Ответы ассистента строятся на данных клуба, которые передаются в выбранный AI-сервис. Решение о том, какому сервису доверить такие данные, принимает владелец клуба.
Безопасность и если что-то не работает#
- Подключайте только серверы, которым доверяете. Ненадёжный MCP-сервер может получить доступ к данным из чата или заставить ассистента совершить лишние действия. OpenAI и Anthropic предупреждают об этом в окнах подключения.
- Ключ CRM находится в адресе. Не отправляйте адрес в мессенджеры и общие чаты. Администратор клуба может заменить ключ в настройках CRM (Рис. 1), после этого подключение нужно создать заново.
- Проверьте, что адрес вставлен целиком, вместе с
?token=…, без пробелов и переносов, и что токен совпадает с полем «Ключ CRM» в CRM. - Если ассистент «не видит» подключение, начните новый чат и включите подключение заново (в ChatGPT и Claude подключение выбирается в каждом чате).
Типовые ошибки#
| Что вы видите | Причина | Что делать |
|---|---|---|
Неверный или отсутствующий токен. (HTTP 401) | Ключ не совпал с полем «Ключ CRM», пустой или в адресе не передан; у клуба нет активной записи настроек CRM; неверный домен клуба. Ответ намеренно одинаковый во всех этих случаях. | Сверьте адрес целиком с полем «Ключ CRM» (Рис. 1), проверьте домен клуба. Если ключ меняли, удалите подключение и создайте заново. |
| Ошибка 405 | В адресе только один /mcp. | Используйте адрес с двумя mcp: https://<ваш-домен>.fitness365.ru/mcp/mcp?token=…. |
| Ошибка 404 | Лишние или неверные символы в пути. | Адрес должен заканчиваться на /mcp/mcp (с ?token=… или без, если ключ передаётся в заголовке). |
| Ошибка 400 | Сервис не смог определить клуб по домену. | Проверьте домен клуба в адресе (без опечаток, без лишних символов). |
Превышен лимит запросов для клуба. Повторите позже. (HTTP 429) | Для каждого клуба действует лимит запросов (по умолчанию 3 за 60 секунд). Один вопрос ассистента состоит из нескольких запросов. | Подождите минуту и повторите. Если ограничение мешает работе, обратитесь к администратору сервера: лимит задаётся параметром Mcp:RateLimit. |
| Ошибка 503 | Сервис не смог обратиться к базе клуба. | Повторите позже. Если не проходит, сообщите в поддержку время и название клуба. |
| Ошибка о длине периода | Запрошен период длиннее 3 месяцев. | Разбейте запрос на периоды до 3 месяцев. Ассистент обычно делает это сам. |
An error occurred invoking '…' | Непредвиденная ошибка при выполнении инструмента. | Повторите запрос. Если ошибка повторяется, сообщите в поддержку название инструмента (оно в сообщении) и время. |
| Ассистент «не видит» инструменты Fitness365 | Подключение не включено в этом чате или список инструментов устарел. | Начните новый чат и включите подключение. Если не помогло, удалите и добавьте подключение заново. |
Для разработчиков: подключение из кода и отладка
Endpoint: https://<host>/mcp/mcp (транспорт Streamable HTTP). Хост клуба — его поддомен. Путь заканчивается на /mcp/mcp: сервис опубликован как приложение /mcp, внутри него точка подключения тоже /mcp; запрос на один /mcp получит ответ 405. При локальном запуске приложения нет, путь один: http://localhost:5180/mcp.
Claude Code#
claude mcp add --transport http fitness365 "https://<host>/mcp/mcp?token=<ТОКЕН>"
claude mcp list # fitness365 — connected
Claude Desktop / claude.ai#
Settings → Connectors → Add custom connector: имя Fitness365, URL https://<host>/mcp/mcp?token=<ТОКЕН>. Для claude.ai сервер должен быть доступен по HTTPS из интернета.
Клиенты, которые поддерживают только stdio, подключаются через мост mcp-remote:
{
"mcpServers": {
"fitness365": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://<host>/mcp/mcp?token=<ТОКЕН>"]
}
}
}
MCP Inspector#
npx @modelcontextprotocol/inspector
# Transport: Streamable HTTP, URL: https://<host>/mcp/mcp
# Заголовок: X-Crm-Token = <ТОКЕН>
C# (ModelContextProtocol SDK)#
var transport = new HttpClientTransport(new HttpClientTransportOptions
{
Endpoint = new Uri("https://<host>/mcp/mcp"),
AdditionalHeaders = new Dictionary<string, string> { ["X-Crm-Token"] = token }
});
await using var client = await McpClient.CreateAsync(transport); // initialize
var tools = await client.ListToolsAsync(); // tools/list
var result = await client.CallToolAsync("visits_summary", // tools/call
new Dictionary<string, object?> { ["period"] = "today", ["compare"] = true });