24 maja 2026

Połącz GymTempo z Claude (MCP)

Zainstaluj @gymtempo/mcp, wygeneruj klucz API w aplikacji i podłącz Claude Code lub Cursor do swoich danych treningowych.

GymTempo MCP łączy kompatybilne asystenty AI z Twoim kontem — programami, rutynami, historią treningów i katalogiem ćwiczeń. Asystent może czytać Twoje dane i pomagać planować lub logować treningi.

Status

Beta — bezpłatnie na czas testów. Dostęp MCP będzie później częścią planu PRO. Na razie każde konto może wypróbować funkcję za darmo.

Czego potrzebujesz

Node.js 20+
Konto GymTempo (nawet puste — program możesz utworzyć przez MCP)
Klient MCP — Claude Code (CLI), Cursor lub Claude Desktop

Krok 1 — Zainstaluj serwer MCP

Zainstaluj pakiet globalnie, żeby klient MCP mógł uruchamiać gymtempo-mcp z dowolnego miejsca. Użyj menedżera pakietów, z którego zwykle korzystasz:

pnpm add -g @gymtempo/mcp

npm install -g @gymtempo/mcp

yarn global add @gymtempo/mcp

Sprawdź instalację:

which gymtempo-mcp

Alternatywa (bez instalacji globalnej): użyj npx -y @gymtempo/mcp zamiast gymtempo-mcp w przykładach poniżej. Konfiguracja Cursor domyślnie korzysta z tego wariantu.

Krok 2 — Wygeneruj klucz API

Otwórz GymTempo → Ustawienia → Dla deweloperów.
Kliknij Generuj klucz API.
Skopiuj klucz od razu — wyświetla się tylko raz. Zaczyna się od gtm_live_.
Przechowuj go bezpiecznie. Możesz go unieważnić i wygenerować ponownie w ustawieniach.

Dozwolony jest tylko jeden aktywny klucz na konto.

Krok 3 — Połącz Claude Code

Uruchom raz (podmień klucz na swój):

claude mcp add gymtempo --scope user \
  --env GYMTEMPO_API_KEY=gtm_live_TWOJ_KLUCZ \
  -- gymtempo-mcp

gymtempo — nazwa serwera w Claude
--scope user — dostępny we wszystkich projektach
--env GYMTEMPO_API_KEY=... — klucz z kroku 2
-- gymtempo-mcp — globalnie zainstalowany serwer MCP z kroku 1

Sprawdź, czy Claude widzi serwer:

claude mcp list

Potem zapytaj na przykład:

Wypisz moje programy w GymTempo.

Pokaż ostatnie 5 treningów.

Cursor

Dodaj do konfiguracji MCP w Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "gymtempo": {
      "command": "npx",
      "args": ["-y", "@gymtempo/mcp"],
      "env": {
        "GYMTEMPO_API_KEY": "gtm_live_TWOJ_KLUCZ"
      }
    }
  }
}

Uruchom Cursor ponownie. Instalacja globalna nie jest wymagana.

Jeśli masz globalną instalację:

{
  "mcpServers": {
    "gymtempo": {
      "command": "gymtempo-mcp",
      "env": {
        "GYMTEMPO_API_KEY": "gtm_live_TWOJ_KLUCZ"
      }
    }
  }
}

Claude Desktop

Edytuj ~/Library/Application Support/Claude/claude_desktop_config.json na macOS:

{
  "mcpServers": {
    "gymtempo": {
      "command": "gymtempo-mcp",
      "env": {
        "GYMTEMPO_API_KEY": "gtm_live_TWOJ_KLUCZ"
      }
    }
  }
}

Całkowicie zamknij i uruchom ponownie Claude Desktop.

Dostępne narzędzia

Narzędzie	Opis
`list_programs`	Lista programów treningowych
`list_routines`	Rutyny w programie
`get_routine`	Pełna rutyna z ćwiczeniami
`list_workouts`	Ostatnie treningi
`get_workout`	Pełny log treningu
`get_exercise_history`	Historia serii ćwiczenia
`list_exercises`	Wyszukiwanie w katalogu ćwiczeń
`create_program`	Utwórz program
`create_routine`	Utwórz rutynę
`update_routine`	Zaktualizuj rutynę
`log_workout`	Zaloguj ukończony trening

Usuwanie programów, rutyn i treningów odbywa się tylko w aplikacji GymTempo.

Rozwiązywanie problemów

Nieprawidłowy klucz API

Wygeneruj nowy klucz w Ustawienia → Dla deweloperów, zaktualizuj GYMTEMPO_API_KEY i uruchom klienta ponownie.

Limit zapytań

Poczekaj minutę i spróbuj ponownie (60/min, 500/godz. na konto).

`gymtempo-mcp: command not found`

Globalny katalog bin Twojego menedżera pakietów może nie być w PATH. Uruchom ponownie wybraną komendę instalacji powyżej albo użyj npx -y @gymtempo/mcp.

Serwer nie widoczny w Claude

claude mcp list
claude mcp remove gymtempo

Opcje muszą być przed nazwą serwera, a -- oddziela nazwę od polecenia.

Bezpieczeństwo

Traktuj gtm_live_... jak hasło.
Unieważnij klucz w ustawieniach, jeśli wycieknie.
Pakiet MCP zawiera publiczne dane połączenia Supabase (jak aplikacja webowa). Klucz API identyfikuje Ciebie.

Pytania? Napisz do nas.