Przejdź do treści
OpenAthlete

Serwer MCP

Twoje treningi w Claude i ChatGPT

Połącz z OpenAthlete asystenta, za którego już płacisz. Czyta Twój kalendarz, aktywności i formę, a za Twoją zgodą planuje 12-tygodniowy blok prosto w kalendarzu. Stamtąd treningi trafiają na zegarek.

  • 25 narzędzi
  • Za darmo w każdym planie
  • OAuth, odczyt i zapis osobno
Claude · OpenAthlete

Ułóż mi 12-tygodniowy plan na maraton 14 marca, 5 biegów w tygodniu, długie wybieganie w niedziele.

  • get_athlete_contextstrefy, VMA, forma −6
  • get_training_volumeostatnie 12 tygodni
  • plan_sessions60 treningów, 4 bloki

Twój plan jest w kalendarzu: 60 treningów w 4 blokach, próg we wtorki, długie wybiegania od 1h30 do 2h50 w niedziele, lżejszy co czwarty tydzień, dwa tygodnie taperingu. Treningi będą trafiać na Twojego Garmina w miarę zbliżania się ich dat.

W jednym akapicie

Czym jest MCP

Model Context Protocol to otwarty standard, który pozwala asystentowi AI korzystać z narzędzi udostępnianych przez inną aplikację. OpenAthlete jest serwerem MCP: po połączeniu Claude lub ChatGPT może wywoływać na Twoim koncie funkcje takie jak get_training_load czy plan_sessions, tak jak Ty klikasz w aplikacji. Model działa po stronie Twojego asystenta, więc OpenAthlete nic za niego nie płaci, Ty też nie: serwer MCP jest darmowy w każdym planie, także na instancjach self-hosted.

Przykłady

O co możesz zapytać

Cztery prośby i narzędzia, które asystent wywołuje, żeby na nie odpowiedzieć.

“Ułóż mi 12-tygodniowy plan na maraton 14 marca, 5 biegów w tygodniu, z długim wybieganiem w niedziele.”

get_athlete_context→get_training_load→get_training_volume→plan_sessions

“Od wczoraj mam gorączkę. Dostosuj moje najbliższe dwa tygodnie.”

create_period→get_calendar→move_sessions→update_session

“Jak wypadł zeszły tydzień w porównaniu z planem? Czy moja forma pasuje na sobotni start?”

get_calendar→get_activity→get_training_load

“Moje nowe FTP to 265 W: zapisz je i zaktualizuj strefy mocy.”

log_metrics→update_training_zone

Narzędzia

25 narzędzi: kalendarz, obciążenie, aktywności, planowanie

Treningi są odczytywane i zapisywane w zwykłych jednostkach: czas w sekundach, tempo jako 4:35 na km, Twoje strefy po id albo procenty VMA, FTP lub tętna maksymalnego. Daty są w Twojej strefie czasowej.

Dostęp do odczytu

read · 12
  • get_athlete_context

    Dzisiejsza data i strefa czasowa, wskaźniki, strefy, kondycja i forma, ostatnie 4 tygodnie, nadchodzące starty, okresy i kontuzje. Agenci wywołują to jako pierwsze.

  • get_calendar

    Zaplanowane treningi (wykonane, opuszczone lub do zrobienia), starty, notatki, aktywności i okresy między dwiema datami.

  • get_sessionget_activity

    Ustrukturyzowany trening danej sesji; okrążenia aktywności i Twoje odpowiedzi na pytania po aktywności.

  • get_activitiesget_training_volume

    Historia treningów i tygodniowa objętość w każdej dyscyplinie.

  • get_training_load

    Tygodniowe obciążenie, wykonane i planowane, z kondycją, zmęczeniem i formą prognozowanymi na zaplanowane treningi.

  • get_metricsget_capacitiesget_records

    Historia wskaźników (waga, tętno spoczynkowe, HRV, sen), możliwości i najlepsze wyniki.

  • list_workout_templateslist_athletes

    Twoja biblioteka treningów; dla trenerów — zawodnicy, których prowadzą.

Dostęp do zapisu, dodatkowo

write · 11
  • plan_sessions

    Dodaje naraz do 60 treningów z rozpisaną strukturą, startów i notatek. Zapisują się wszystkie albo żaden.

  • update_session

    Zmienia trening, start lub notatkę; przy treningu powtarzanym — ten i kolejne.

  • move_sessionscopy_sessionsrepeat_session

    Przesuwa lub kopiuje treningi o dni, powtarza trening co kilka tygodni.

  • delete_sessions

    Usuwa zaplanowane treningi. Wykonane treningi i zapisane aktywności nigdy nie są usuwane.

  • create_periodupdate_perioddelete_period

    Bloki treningowe i okresy bez treningu: podróż, choroba, kontuzja.

  • log_metricsupdate_training_zone

    Zapisuje pomiary, zmienia strefę po teście.

Konfiguracja

Połączone w dwie minuty

Adres jest wszędzie ten sam. Na instancji self-hosted to https://<twoja domena>/api/mcp.

Instrukcja konfiguracji
URLhttps://api.openathlete.org/mcp

Claude

claude.ai i aplikacja desktopowa, potem również na telefonie. Jeden własny konektor w darmowym planie

  1. 1Customize › Connectors › Add custom connector
  2. 2Wklej adres, potem Connect
  3. 3Zaloguj się do OpenAthlete i wybierz Zezwól
Przewodnik krok po kroku

ChatGPT

Plany Business, Enterprise i Edu w chwili sprawdzania; Pro ma tylko odczyt

  1. 1Plugins › + › Add custom MCP server
  2. 2Wklej adres, wybierz OAuth, utwórz go jako plugin
  3. 3Zezwól na dostęp w OpenAthlete
Przewodnik krok po kroku

Claude Code

W terminalu, potem /mcp, żeby się zalogować

claude mcp add --transport http openathlete https://api.openathlete.org/mcp

Cursor, VS Code, Twój własny agent

OAuth, jeśli klient go obsługuje, w przeciwnym razie osobisty token z Ustawienia › Agenci AI, pokazywany tylko raz

{
  "mcpServers": {
    "openathlete": {
      "url": "https://api.openathlete.org/mcp",
      "headers": { "Authorization": "Bearer oa_pat_..." }
    }
  }
}

Dla trenerów

Pracuj ze wszystkimi zawodnikami naraz

Asystent trenera ma dostęp do prowadzonych przez niego zawodników, na tych samych zasadach co w aplikacji. Wyświetla ich listę, a potem przy każdej prośbie wskazuje zawodnika. Poproś o przegląd tygodnia wszystkich albo przerób blok jednego zawodnika po paskudnym przeziębieniu.

OpenAthlete dla trenerów
ChatGPT · OpenAthlete

Jak u każdego z moich zawodników wypadł zeszły tydzień w porównaniu z planem?

  • list_athletes6 zawodników
  • get_calendar× 6, zeszły tydzień

Czterech z sześciu zrealizowało 90% lub więcej planowanego czasu. Léa opuściła oba mocne treningi i w czwartek napisała „spięta łydka”. Marc zrobił o 30% więcej niż w planie.

Bezpieczeństwo

Bezpieczeństwo i uprawnienia

To, co asystent robi z Twoimi danymi, zależy od niego i jego dostawcy. Podłączaj tylko te, którym ufasz.

OAuth 2.1 z PKCE: każdego asystenta zatwierdzasz na stronie OpenAthlete. Nigdy nie widzi Twojego hasła.

Odczyt i zapis są rozdzielone. Asystent z dostępem do odczytu nawet nie dostaje narzędzi do zapisu.

Tokeny są przechowywane jako hashe. Tokeny dostępu ważne są godzinę; tokeny odświeżania są jednorazowe, a skradziony token użyty dwa razy unieważnia dostęp.

Tokeny osobiste są ważne 30, 90 lub 365 dni albo bezterminowo. Każde połączenie unieważnisz w Ustawienia › Agenci AI; przestaje działać przy następnym żądaniu.

Asystenci mają dostęp do Twoich treningów, nie do konta: bez zmiany hasła, urządzeń czy subskrypcji, bez usuwania Twojej historii.

Pytania, które ludzie zadają

Tak, w każdym planie, także Free, i na instancjach self-hosted. Model działa po stronie Twojego asystenta, na Twoim koncie Claude lub ChatGPT.

Claude (claude.ai, desktop, mobile i Claude Code), ChatGPT w trybie deweloperskim, Cursor, VS Code i każdy klient MCP obsługujący OAuth lub token bearer.

Nie. Wykonane treningi i zapisane aktywności to Twoja historia i przez MCP są tylko do odczytu. Może zmieniać lub usuwać wyłącznie treningi jeszcze do zrobienia.

Tak, dokładnie tak jak te, które planujesz sam: na Garmina, Suunto lub COROS, jeśli eksport treningów jest włączony.

Tak. Zatwierdź tylko zakres odczytu albo utwórz osobisty token z dostępem do odczytu. Asystent nie będzie wtedy mógł niczego zmienić.

Tak. Adres to https://<twoja domena>/api/mcp, z tym samym procesem OAuth i tymi samymi narzędziami.

Daj asystentowi prawdziwe dane do pracy

Załóż konto, połącz zegarek, żeby wczytały się Twoje aktywności, a potem dodaj OpenAthlete jako konektor.

Za darmo na zawsze. Bez karty kredytowej.