GARMIN CONNECT + TWÓJ ASYSTENT AI

Twoje treningi.
Lepsze pytania.

Połącz swoje dane Garmin z asystentem AI i pytaj o trening, sen oraz regenerację. Krok po kroku, na własnym serwerze.

Oficjalny Garmin Personal API · tylko odczyt · projekt open source

PROSTY POMYSŁ

Twoje dane mają kontekst.

Garmin zbiera wiele informacji. MCP to pomost, dzięki któremu wybrany asystent może odczytać je wtedy, gdy o to poprosisz — i pomóc Ci dostrzec zależności.

01 / GARMIN CONNECT

Twoje dane

Aktywności, tętno, sen, HRV i inne dane dostępne w oficjalnym Personal API Garmina.

02 / TWÓJ SERWER

Własne połączenie

Serwer działa na Twoim koncie Cloudflare. Klucz Garmina zapisujesz jako sekret, a dostęp zatwierdzasz samodzielnie.

03 / ASYSTENT AI

Pytania po ludzku

Zapytaj o ostatnie treningi, porównaj tygodnie i sprawdź zmiany w regeneracji.

Tylko odczytCloudflare FreeBez hasła Garmin w MCPWłasna instancja
ZANIM ZACZNIESZ

Ty decydujesz,
kogo podłączysz.

Instrukcja nie wysyła danych do autora tej strony. Twój serwer działa na Twoim koncie Cloudflare. Gdy pytasz asystenta, potrzebne dane są przekazywane z Garmina przez Cloudflare do dostawcy wybranego asystenta AI.

Nie wklejaj klucza Garmin, tokenów ani kodów logowania do czatu lub formularza na tej stronie. Nie podawaj ich również agentowi wdrażającemu.

PRZEWODNIK WDROŻENIA

Uruchom własny serwer.

Potrzebujesz kont Garmin Connect i Cloudflare, komputera z przeglądarką, terminala oraz konta w wybranym asystencie. Poniższa ścieżka korzysta z Cloudflare. Nazwy opcji w panelach mogą się zmienić.

Koszty: serwer jest przeznaczony do użytku w Cloudflare Free, ale ten plan ma limity. Dostępność własnych MCP w asystentach zależy od konta, kraju i planu. Sprawdź warunki przed rozpoczęciem.
1. Przygotuj projekt na komputerze

Zainstaluj Node.js, Git oraz pnpm. Projekt wskazuje wersje w plikach .node-version i package.json. Otwórz terminal i uruchom:

git clone https://github.com/lukasamd/garmin-mcp.git
cd garmin-mcp
corepack enable
pnpm install --frozen-lockfile
pnpm check
pnpm wrangler login

Otworzy się logowanie Cloudflare. Zaloguj się samodzielnie i zatwierdź dostęp. Jeżeli polecenie instalacji lub logowania nie działa, skorzystaj z promptu dla agenta poniżej.

2. Utwórz Workera i zabezpiecz autoryzację
  1. W panelu Cloudflare przejdź do Workers & Pages. Jeśli nie masz subdomeny workers.dev, skonfiguruj ją. Utwórz Worker garmin-mcp z szablonu „Hello World”.
  2. Zapisz jego adres: garmin-mcp.TWOJA-SUBDOMENA.workers.dev.
  3. Otwórz Cloudflare Zero Trust. Przy pierwszym uruchomieniu wybierz plan Free i utwórz zespół.
  4. W Access → Applications dodaj aplikację typu Self-hosted. Wybierz adres Workera oraz ścieżkę /authorize. Dodaj regułę Allow → Emails z Twoim adresem e-mail; wybierz logowanie jednorazowym kodem (One-time PIN).
  5. W prywatnym oknie przeglądarki otwórz adres Workera z dopiskiem /authorize. Przed stroną Workera powinien pojawić się ekran Cloudflare Access. Jeśli nie, popraw regułę.
  6. W szczegółach aplikacji Access znajdź Application Audience (AUD) Tag.

Chroń ścieżkę /authorize, nie cały Worker: klient MCP musi dotrzeć do /mcp i endpointów OAuth. Na chronionej stronie możesz zatwierdzić klienta po sprawdzeniu jego nazwy i adresu.

3. Utwórz klucz i zapisz sekrety
  1. W terminalu projektu wpisz pnpm wrangler secret put ACCESS_AUD. Wklej AUD dopiero w odpowiedzi na ukryty monit i zatwierdź.
  2. Zaloguj się do Garmin Connect → Personal API, utwórz klucz, zapoznaj się z warunkami i wybierz jego ważność. Klucz jest wyświetlany tylko raz.
  3. W terminalu wpisz pnpm wrangler secret put GARMIN_API_KEY. Wklej klucz dopiero w odpowiedzi na ukryty monit i zatwierdź. Nie dopisuj go do polecenia.

Jeśli masz już aktywny klucz Personal API, sprawdź skutki jego zastąpienia dla innych połączeń. Traktuj klucz jak hasło.

4. Wdróż i przetestuj

W tym samym katalogu uruchom:

pnpm wrangler deploy

Jeśli Wrangler zapyta o utworzenie KV, potwierdź. Skopiuj adres swojego Workera i dopisz /mcp. Sprawdź, czy bez logowania endpoint odrzuca żądanie:

curl -sS -o /dev/null -w 'HTTP %{http_code}\n' https://TWOJ-WORKER.workers.dev/mcp

Oczekiwane: HTTP 401. Sam ten wynik nie potwierdza poprawności pozostałych zabezpieczeń. Po podłączeniu klienta sprawdź również odczyt aktywności, snu i HRV.

5. Podłącz asystenta

ChatGPT: w Plugins wybierz dodanie własnego serwera MCP, wklej adres kończący się na /mcp, wybierz OAuth i przejdź autoryzację. Dostępność opcji może zależeć od konta. Nasz test z kontem Plus w Work zakończył się powodzeniem.

Claude: w Connectors wybierz dodanie własnego konektora, wpisz adres MCP i przejdź autoryzację. Anthropic podaje dostępność również w planie Free, z limitem jednego własnego konektora. Przed rozpoczęciem sprawdź aktualne wymagania.

Gemini: dostępność własnych aplikacji MCP jest ograniczona. Google opisuje obecnie m.in. wymaganie przebywania w USA, konto osobiste i język angielski; sprawdź bieżące warunki. Gemini CLI jest osobnym narzędziem. Zgodność tych klientów z tą konfiguracją wymaga testu.

Podczas autoryzacji sprawdź nazwę aplikacji i adres docelowy na stronie zgody. Po zmianie listy narzędzi może być wymagane jej odświeżenie lub rozpoczęcie nowej rozmowy.

GOTOWE DO SKOPIOWANIA

Poproś agenta o pomoc.

Możesz użyć agenta programistycznego do przeprowadzenia konfiguracji lub poprosić podłączonego asystenta o analizę. Dane dostępowe wprowadzaj samodzielnie.

Pomoc we wdrożeniu

Pomóż mi uruchomić prywatny, tylko do odczytu serwer Garmin MCP z https://github.com/lukasamd/garmin-mcp na Cloudflare Free. Najpierw sprawdź README i warunki mojego środowiska. Prowadź mnie etapami i wyjaśniaj prosto. Nie proś o hasła, klucz Garmin, tokeny ani kody w rozmowie i ich nie zapisuj w repozytorium ani logach. Logowanie, akceptację warunków oraz wpisanie sekretów wykonam samodzielnie. Skonfiguruj Cloudflare Access tylko dla /authorize oraz OAuth dla /mcp. Przed publikacją sprawdź konfigurację, nie udostępniaj moich danych innym osobom. Po wdrożeniu sprawdź brak dostępu bez tokenu oraz, po mojej autoryzacji, odczyt aktywności, HRV i snu. Nie deklaruj sukcesu bez testów.

Podsumowanie tygodnia

Korzystając z mojego Garmin MCP, przeanalizuj ostatnie cztery pełne tygodnie treningu. Porównaj liczbę i czas treningów, dystans oraz intensywność biegania i jazdy. Uwzględnij sen, HRV oraz ewentualne luki w danych. Pokaż zakres dat i oddziel obserwacje od przypuszczeń. Zaproponuj ostrożne kierunki treningu na kolejny tydzień, zaznaczając, że nie znasz wszystkich czynników wpływających na regenerację.
DOBRZE WIEDZIEĆ

Najczęstsze pytania.

Czy muszę płacić?

Projekt jest open source. Cloudflare oferuje plan Free z limitami; dostępność konta i warunki usług mogą się zmieniać. Asystent może mieć własne ograniczenia lub wymagać odpowiedniego planu. Duże pliki FIT mogą przekroczyć limity darmowego Workera.

Czy mogę użyć czegoś innego niż Cloudflare?

Istnieją lokalne serwery MCP i rozwiązania uruchamiane w Dockerze. Ten projekt jest jednak oparty na Workers, Cloudflare KV i Access; przeniesienie go wymaga zmian w kodzie i zabezpieczeniach. Nie przedstawiamy jeszcze innej ścieżki jako przetestowanej.

Jak odłączyć dostęp albo wymienić klucz?

Odłącz aplikację w wybranym asystencie. Klucz Garmin możesz usunąć w ustawieniach Personal API, co unieważnia powiązane tokeny Garmin. Nowy klucz wpisz poleceniem pnpm wrangler secret put GARMIN_API_KEY. Aby unieważnić wszystkich klientów OAuth tego Workera, wyczyść jego namespace KV — ponowna autoryzacja będzie potrzebna wszystkim klientom. Nie usuwaj innych zasobów KV.

Czy AI widzi Training Readiness?

Ten serwer udostępnia tylko dane obsługiwane przez jego narzędzia. VO₂ max może być dostępne, jeśli Garmin zwróci dane. Bezpośredniego odczytu Training Readiness obecny serwer nie wystawia; analiza snu i HRV nie jest jego dokładnym odpowiednikiem.