24 травня 2026 р.

Підключення GymTempo до Claude (MCP)

Встановіть @gymtempo/mcp, створіть ключ API в додатку та підключіть Claude Code або Cursor до ваших тренувальних даних.

GymTempo MCP підключає сумісні AI-асистенти до вашого облікового запису — програм, рутин, історії тренувань і каталогу вправ. Асистент може читати ваші дані та допомагати планувати або записувати тренування.

Статус

Бета — безкоштовно під час тестування. Доступ MCP планується в тарифі PRO пізніше. Зараз кожен обліковий запис може спробувати функцію безкоштовно.

Що потрібно

Node.js 20+
Обліковий запис GymTempo (навіть порожній — програму можна створити через MCP)
MCP-клієнт — Claude Code (CLI), Cursor або Claude Desktop

Крок 1 — Встановіть MCP-сервер

Встановіть пакет глобально, щоб клієнт MCP міг запускати gymtempo-mcp звідусіль. Використайте менеджер пакетів, яким зазвичай користуєтеся:

pnpm add -g @gymtempo/mcp

npm install -g @gymtempo/mcp

yarn global add @gymtempo/mcp

Перевірте встановлення:

which gymtempo-mcp

Альтернатива (без глобального встановлення): використовуйте npx -y @gymtempo/mcp замість gymtempo-mcp у прикладах нижче. Конфіг Cursor за замовчуванням працює саме так.

Крок 2 — Створіть ключ API

Відкрийте GymTempo → Налаштування → Розробник.
Натисніть Створити ключ API.
Скопіюйте ключ одразу — він показується лише раз. Починається з gtm_live_.
Зберігайте його в безпечному місці. Можна скасувати та створити новий у налаштуваннях.

Дозволений лише один активний ключ на обліковий запис.

Крок 3 — Підключіть Claude Code

Виконайте один раз (замініть ключ на свій):

claude mcp add gymtempo --scope user \
  --env GYMTEMPO_API_KEY=gtm_live_ВАШ_КЛЮЧ \
  -- gymtempo-mcp

gymtempo — назва сервера в Claude
--scope user — доступний у всіх ваших проєктах
--env GYMTEMPO_API_KEY=... — ключ з кроку 2
-- gymtempo-mcp — глобально встановлений MCP-сервер з кроку 1

Перевірте, що Claude бачить сервер:

claude mcp list

Потім запитайте, наприклад:

Покажи мої програми в GymTempo.

Покажи останні 5 тренувань.

Cursor

Додайте до конфігурації MCP у Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "gymtempo": {
      "command": "npx",
      "args": ["-y", "@gymtempo/mcp"],
      "env": {
        "GYMTEMPO_API_KEY": "gtm_live_ВАШ_КЛЮЧ"
      }
    }
  }
}

Перезапустіть Cursor. Глобальне встановлення не обов’язкове.

Якщо встановлено глобально:

{
  "mcpServers": {
    "gymtempo": {
      "command": "gymtempo-mcp",
      "env": {
        "GYMTEMPO_API_KEY": "gtm_live_ВАШ_КЛЮЧ"
      }
    }
  }
}

Claude Desktop

Відредагуйте ~/Library/Application Support/Claude/claude_desktop_config.json на macOS:

{
  "mcpServers": {
    "gymtempo": {
      "command": "gymtempo-mcp",
      "env": {
        "GYMTEMPO_API_KEY": "gtm_live_ВАШ_КЛЮЧ"
      }
    }
  }
}

Повністю закрийте та перезапустіть Claude Desktop.

Доступні інструменти

Інструмент	Опис
`list_programs`	Список програм
`list_routines`	Рутини в програмі
`get_routine`	Повна рутина з вправами
`list_workouts`	Останні тренування
`get_workout`	Повний лог тренування
`get_exercise_history`	Історія підходів вправи
`list_exercises`	Пошук у каталозі вправ
`create_program`	Створити програму
`create_routine`	Створити рутину
`update_routine`	Оновити рутину
`log_workout`	Записати завершене тренування

Видалення програм, рутин і тренувань — лише в додатку GymTempo.

Усунення несправностей

Невірний ключ API

Створіть новий ключ у Налаштування → Розробник, оновіть GYMTEMPO_API_KEY і перезапустіть клієнт.

Перевищено ліміт запитів

Зачекайте хвилину (60/хв, 500/год на обліковий запис).

`gymtempo-mcp: command not found`

Глобальний каталог bin вашого менеджера пакетів може бути відсутній у PATH. Повторіть обрану команду встановлення вище або використайте npx -y @gymtempo/mcp.

Сервер не видно в Claude

claude mcp list
claude mcp remove gymtempo

Опції мають бути перед назвою сервера, -- відокремлює назву від команди.

Безпека

Ставтеся до gtm_live_... як до пароля.
Скасуйте ключ у налаштуваннях, якщо він потрапив стороннім.
Пакет MCP містить публічні дані підключення Supabase (як веб-додаток). Ключ API ідентифікує вас.

Питання? Напишіть нам.