Подключение AI-агентов к Fitness365 MCP

Как подключить MCP-сервер Fitness365 к ChatGPT, Claude, GigaCode Desktop, DeepSeek и другим клиентам. Первая часть для сотрудников клуба, вторая — для разработчиков.

Описание инструментов, формат запросов и ответов — в справочнике для разработчиков; готовые вопросы для владельца клуба — в каталоге типовых сценариев.

Подключение для пользователей клуба

Инструкция для сотрудников клуба: как подключить MCP-сервер CRM к ChatGPT (OpenAI), Claude, GigaCode Desktop или DeepSeek и задавать ассистенту вопросы по данным клуба обычным языком, например: «сколько сегодня посетителей в клубе?».

Что понадобится#

Где взять ключ CRM#

В CRM откройте Настройки → CRM → Настройки по умолчанию (адрес раздела …fitness365.ru/#/crm-module-settings/List). В карточке найдите поле «Ключ CRM (Ключ для авторизации в системе Девпарк)» и скопируйте значение. Это тот же токен, что описан в разделе «Авторизация» (параметр CrmToken).

Рис. 1. Поле «Ключ CRM» в настройках CRMРис. 1. Поле «Ключ CRM» в настройках CRM
Рис. 1. Поле «Ключ CRM» в настройках CRM
Ключ CRM — это пароль к данным клуба. Он находится прямо в адресе сервера, поэтому не публикуйте адрес в чатах и не передавайте посторонним. Если ключ попал не в те руки, замените его в настройках CRM и обновите подключение.

ChatGPT (OpenAI)#

  1. Нажмите на своё имя внизу слева и выберите Настройки.
Рис. 2. Меню профиля → Настройки
Рис. 2. Меню профиля → Настройки
  1. В настройках в блоке Интеграции откройте Плагины и нажмите Просмотреть каталог.
Рис. 3. Настройки → Интеграции → Плагины → Просмотреть каталог
Рис. 3. Настройки → Интеграции → Плагины → Просмотреть каталог
  1. На странице плагинов нажмите Добавить (справа вверху) и выберите Добавить пользовательский сервер MCP.
Рис. 4. Добавить → Добавить пользовательский сервер MCP
Рис. 4. Добавить → Добавить пользовательский сервер MCP
  1. Заполните форму:
    • Название: любое, например Fitness365 или название клуба.
    • Описание: необязательно, например «Мой клуб».
    • Подключение: вкладка «URL-адрес сервера», в поле адрес https://<ваш-домен>.fitness365.ru/mcp/mcp?token=<КЛЮЧ_CRM>.
    • Аутентификация: «Без аутентификации».
    Поставьте галочку «Я понимаю и хочу продолжить» и нажмите Создать в виде плагина.
Рис. 5. Форма «Добавить пользовательский сервер MCP»
Рис. 5. Форма «Добавить пользовательский сервер MCP»
  1. Откройте Новый чат. При первом запуске выберите подключение в меню: наберите название подключения или откройте список через «+». Затем задайте вопрос, например: «сколько сегодня посетителей в клубе?».
Рис. 6. Выбор подключения в новом чате (делается один раз при начале чата)
Рис. 6. Выбор подключения в новом чате (делается один раз при начале чата)

Наличие пункта «Добавить пользовательский сервер MCP» зависит от тарифа и версии ChatGPT. Если пункта нет, проверьте настройки тарифа или обратитесь в поддержку OpenAI. В скриншотах использован аккаунт Free, гарантий для всех тарифов нет.

Claude (claude.ai и Claude Desktop)#

  1. Откройте Customize → Connectors (прямая ссылка: claude.ai/customize/connectors).
  2. Нажмите + Add, затем Add custom connector.
  3. Введите название (например, Fitness365) и вставьте адрес сервера https://<ваш-домен>.fitness365.ru/mcp/mcp?token=<КЛЮЧ_CRM>. Нажмите Continue.
  4. В блоке Authentication выберите No sign in (вход не нужен, ключ уже в адресе). Нажмите Continue, затем Add.
  5. В нужном чате нажмите «+» слева внизу (или введите /), наведите на Connectors и включите подключение. Переключатель действует для конкретного чата.
  6. Задайте вопрос по клубу. Когда Claude попросит разрешение на вызов инструмента, нажмите Allow. Вариант Allow always выбирайте только для проверенных инструментов.

Важно знать#

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, отдельной установки для него не требуется. Параметры подключения:

Шаг 1. Откройте раздел MCP#

В левом меню GigaCode Desktop нажмите MCP (значок скрепки между пунктами «Навыки» и «Агенты»).

Пункт «MCP» в левом меню GigaCode Desktop (между «Навыки» и «Агенты»)
Пункт «MCP» в левом меню GigaCode Desktop (между «Навыки» и «Агенты»).

Шаг 2. Добавьте новый сервер#

На экране «MCP» нажмите + Добавить сервер в верхней части окна.

Кнопка «Добавить сервер» на экране «MCP»
Кнопка «Добавить сервер» на экране «MCP».

Шаг 3. Заполните параметры сервера#

В окне «Добавить MCP-сервер» введите имя, оставьте транспорт HTTP, вставьте адрес в поле «URL сервера» и нажмите Сохранить (справа внизу). Блок «Расширенные настройки» для подключения не нужен: ключ передаётся в адресе. Мы его не проверяли.

Окно «Добавить MCP-сервер»: имя, транспорт HTTP, URL сервера
Окно «Добавить 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#

  1. Установите Cherry Studio и откройте Настройки → Модельные сервисы (в английской версии Settings → Model Services). Откройте провайдера DeepSeek.
  2. Вставьте ключ в поле «API-ключ». Адрес API по умолчанию https://api.deepseek.com, менять его не нужно.
  3. Нажмите «Получить список моделей», добавьте нужные модели знаком «+» и включите переключатель провайдера вверху справа. Проверьте работу кнопкой «Проверить».

Шаг 3. Добавьте MCP-сервер Fitness365#

  1. Откройте Настройки → MCP → MCP-серверы → Добавить.
  2. Укажите название, тип удалённого сервера (Streamable HTTP; если такого нет, используйте SSE или HTTP) и адрес https://<ваш-домен>.fitness365.ru/mcp/mcp?token=<КЛЮЧ_CRM>. Сохраните и включите сервер.
  3. Откройте сведения о сервере и убедитесь, что он в нормальном статусе и показывает список инструментов. Если нет, посмотрите журнал сервера.
  4. Привяжите сервер к ассистенту или агенту, который работает на модели DeepSeek, затем задайте вопрос по клубу.

Названия пунктов Cherry Studio сверяли по документации на китайском языке, поэтому в вашей версии подписи могут отличаться. Типы сервера (Streamable HTTP, SSE) и привязка к ассистенту в документации описаны не полностью, ориентируйтесь на окно «Добавить» в вашей версии. Модели DeepSeek тоже переименовываются: выбирайте из списка, который вернёт кнопка «Получить список моделей».

Как проверить подключение и с чего начать#

  1. Откройте новый чат и включите подключение Fitness365.
  2. Задайте первый запрос: «Какие у меня филиалы?». Ассистент должен вызвать инструмент get_branches и вернуть список филиалов клуба. Так проверяются и адрес, и ключ.
  3. Затем задайте рабочий вопрос, например: «Сколько посетителей было вчера?» или «Какая выручка за прошлую неделю по филиалам?». Если вопрос про период, называйте даты: максимальный период одного запроса — 3 месяца.
  4. Готовые формулировки для владельца клуба, с описанием того, что и как считается, собраны в каталоге типовых вопросов и решений.

Администратор может проверить адрес и ключ без ассистента. В терминале (подставьте ключ клуба):

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":"Неверный или отсутствующий токен."} значит, что адрес верный, но ключ не принят.

Права доступа и данные#

Безопасность и если что-то не работает#

Типовые ошибки#

Что вы видитеПричинаЧто делать
Неверный или отсутствующий токен. (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 });