MCP-server
Je training, in Claude en ChatGPT
Koppel de assistent waar je al voor betaalt aan OpenAthlete. Hij leest je agenda, activiteiten en vorm, en plant met jouw toestemming een blok van 12 weken rechtstreeks in je agenda. Van daaruit gaan de trainingen naar je horloge.
- 25 tools
- Gratis bij elk abonnement
- OAuth, lezen en schrijven gescheiden
Maak een schema van 12 weken voor een marathon op 14 maart, 5 lopen per week, lange duurloop op zondag.
- get_athlete_contextzones, VMA, vorm −6
- get_training_volumelaatste 12 weken
- plan_sessions60 trainingen, 4 blokken
Je schema staat in de agenda: 60 trainingen in 4 blokken, drempel op dinsdag, lange duurlopen van 1u30 tot 2u50 op zondag, elke vierde week lichter, twee weken taper. De trainingen komen op je Garmin naarmate hun datum nadert.
In één alinea
Wat MCP is
Het Model Context Protocol is een open standaard waarmee een AI-assistent tools kan gebruiken die een andere app aanbiedt. OpenAthlete is een MCP-server: eenmaal gekoppeld kunnen Claude of ChatGPT functies zoals get_training_load of plan_sessions op je account aanroepen, zoals jij door de app zou klikken. Het model draait aan de kant van je assistent, dus OpenAthlete betaalt er niets voor, en jij ook niet: de MCP-server is gratis bij elk abonnement, zelf gehoste instanties inbegrepen.
Voorbeelden
Wat je kunt vragen
Vier verzoeken en de tools die de assistent aanroept om ze te beantwoorden.
“Maak een schema van 12 weken voor een marathon op 14 maart, 5 lopen per week, met mijn lange duurloop op zondag.”
get_athlete_context→get_training_load→get_training_volume→plan_sessions“Ik heb sinds gisteren koorts. Pas mijn komende twee weken aan.”
create_period→get_calendar→move_sessions→update_session“Hoe ging vorige week vergeleken met het schema? Is mijn vorm goed voor de wedstrijd van zaterdag?”
get_calendar→get_activity→get_training_load“Mijn nieuwe FTP is 265 W: leg hem vast en werk mijn vermogenszones bij.”
log_metrics→update_training_zoneTools
25 tools: agenda, belasting, activiteiten, planning
Trainingen worden gelezen en geschreven in gewone eenheden: duur in seconden, tempo's als 4:35 per km, je zones op id, of percentages van VMA, FTP of maximale hartslag. Datums staan in jouw tijdzone.
Leestoegang
read · 12get_athlete_contextDatum en tijdzone van vandaag, metingen, zones, fitheid en vorm, de laatste 4 weken, komende wedstrijden, periodes en blessures. Agents roepen dit als eerste aan.
get_calendarGeplande trainingen (gedaan, gemist of te doen), wedstrijden, notities, activiteiten en periodes tussen twee datums.
get_sessionget_activityDe gestructureerde training van een sessie; de ronden van een activiteit en je antwoorden op de vragen na de activiteit.
get_activitiesget_training_volumeTrainingshistorie en weekvolume per sport.
get_training_loadWeekbelasting, gedaan en gepland, met fitheid, vermoeidheid en vorm doorgetrokken over de geplande trainingen.
get_metricsget_capacitiesget_recordsHistorie van metingen (gewicht, rusthartslag, HRV, slaap), capaciteiten en beste prestaties.
list_workout_templateslist_athletesJe trainingsbibliotheek; voor coaches de atleten die ze coachen.
Schrijftoegang, daarbovenop
write · 11plan_sessionsVoegt tot 60 trainingen met gestructureerde opbouw, wedstrijden en notities tegelijk toe. Alles wordt opgeslagen, of niets.
update_sessionWijzigt een training, een wedstrijd of een notitie; bij een herhaalde training deze en de volgende.
move_sessionscopy_sessionsrepeat_sessionVerplaatst of kopieert trainingen met een aantal dagen, herhaalt er een om de paar weken.
delete_sessionsVerwijdert geplande trainingen. Gedane trainingen en opgenomen activiteiten worden nooit verwijderd.
create_periodupdate_perioddelete_periodTrainingsblokken, en periodes zonder training: reizen, ziekte, blessure.
log_metricsupdate_training_zoneLegt metingen vast, wijzigt een zone na een test.
Instellen
Gekoppeld in twee minuten
Het adres is overal hetzelfde. Op een zelf gehoste instantie is het https://<jouw domein>/api/mcp.
https://api.openathlete.org/mcpClaude
claude.ai en de desktopapp, daarna ook op mobiel. Eén eigen connector met het gratis abonnement
- 1Customize › Connectors › Add custom connector
- 2Plak het adres, dan Connect
- 3Log in bij OpenAthlete en kies Toestaan
ChatGPT
Business-, Enterprise- en Edu-abonnementen toen we het controleerden; Pro kan alleen lezen
- 1Plugins › + › Add custom MCP server
- 2Plak het adres, kies OAuth, maak het aan als plugin
- 3Sta het toe in OpenAthlete
Claude Code
In een terminal, dan /mcp om in te loggen
claude mcp add --transport http openathlete https://api.openathlete.org/mcpCursor, VS Code, je eigen agent
OAuth als de client het ondersteunt, anders een persoonlijke token uit Instellingen › AI-agents, één keer getoond
{
"mcpServers": {
"openathlete": {
"url": "https://api.openathlete.org/mcp",
"headers": { "Authorization": "Bearer oa_pat_..." }
}
}
}Voor coaches
Werk met al je atleten tegelijk
De assistent van een coach bereikt de atleten die hij coacht, met dezelfde regels als in de app. Hij zet ze op een rij en geeft bij elk verzoek de atleet mee. Vraag om een terugblik op ieders week, of herwerk het blok van één atleet na een flinke verkoudheid.
OpenAthlete voor coachesHoe verliep vorige week voor elk van mijn atleten vergeleken met het schema?
- list_athletes6 atleten
- get_calendar× 6, vorige week
Vier van de zes haalden 90% of meer van de geplande tijd. Léa miste beide kwaliteitstrainingen en schreef donderdag "kuit stijf". Marc deed 30% meer dan gepland.
Beveiliging
Beveiliging en toestemmingen
Wat een assistent met je gegevens doet, is aan hem en zijn aanbieder. Koppel alleen de assistenten die je vertrouwt.
OAuth 2.1 met PKCE: je keurt elke assistent goed op een pagina van OpenAthlete. Hij ziet nooit je wachtwoord.
Lezen en schrijven zijn gescheiden. Een assistent met leestoegang krijgt de tools die schrijven niet eens aangeboden.
Tokens worden gehasht opgeslagen. Toegangstokens zijn een uur geldig; vernieuwingstokens zijn eenmalig, en een gestolen token die twee keer wordt gebruikt, trekt de toegang in.
Persoonlijke tokens zijn 30, 90 of 365 dagen geldig, of verlopen nooit. Trek elke koppeling in via Instellingen › AI-agents; ze stopt bij het volgende verzoek.
Assistenten bereiken je training, niet je account: geen wachtwoordwijziging, geen wijziging van apparaat of abonnement, geen verwijdering van je historie.
Veelgestelde vragen
Ja, bij elk abonnement, Gratis inbegrepen, en op zelf gehoste instanties. Het model draait aan de kant van je assistent, onder je Claude- of ChatGPT-account.
Claude (claude.ai, desktop, mobiel en Claude Code), ChatGPT in ontwikkelaarsmodus, Cursor, VS Code en elke MCP-client die OAuth of een bearer-token ondersteunt.
Nee. Gedane trainingen en opgenomen activiteiten zijn je historie en zijn via MCP alleen-lezen. Hij kan alleen trainingen wijzigen of verwijderen die nog moeten komen.
Ja, precies zoals de trainingen die je zelf plant: naar Garmin, Suunto of COROS als het exporteren van trainingen aanstaat.
Ja. Keur alleen de leesscope goed, of maak een persoonlijke token met leestoegang. De assistent kan dan niets wijzigen.
Ja. Het adres is https://<jouw domein>/api/mcp, met dezelfde OAuth-flow en tools.
De rest van de wekelijkse cyclus
Alle functiesGeef je assistent iets echts om mee te werken
Maak een account, koppel je horloge zodat je activiteiten binnenkomen, en voeg OpenAthlete daarna toe als connector.
Voor altijd gratis. Geen creditcard.