Server MCP
Il tuo allenamento, dentro Claude e ChatGPT
Collega a OpenAthlete l'assistente che già paghi. Legge il tuo calendario, le attività e la forma e, con il tuo permesso, pianifica un blocco di 12 settimane direttamente nel calendario. Da lì, le sedute vanno sul tuo orologio.
- 23 strumenti
- Gratis su tutti i piani
- OAuth, lettura e scrittura separate
Preparami una tabella di 12 settimane per una maratona il 14 marzo, 5 uscite a settimana, lungo la domenica.
- get_athlete_contextzone, VAM, freschezza −6
- get_training_volumeultime 12 settimane
- plan_sessions60 sedute, 4 blocchi
La tua tabella è nel calendario: 60 sedute in 4 blocchi, soglia il martedì, lunghi da 1h30 a 2h50 la domenica, una settimana di scarico ogni quattro, due settimane di tapering. Gli allenamenti arriveranno sul tuo Garmin man mano che si avvicinano le date.
In un paragrafo
Cos'è MCP
Il Model Context Protocol è uno standard aperto che permette a un assistente IA di usare strumenti forniti da un'altra app. OpenAthlete è un server MCP: una volta collegato, Claude o ChatGPT possono chiamare funzioni come get_training_load o plan_sessions sul tuo account, come faresti tu cliccando nell'app. Il modello gira dal lato del tuo assistente, quindi OpenAthlete non paga nulla, e nemmeno tu: il server MCP è gratuito su tutti i piani, istanze self-hosted comprese.
Esempi
Cosa puoi chiedere
Quattro richieste e gli strumenti che l'assistente usa per rispondere.
“Preparami una tabella di 12 settimane per una maratona il 14 marzo, 5 uscite a settimana, con il lungo la domenica.”
get_athlete_context→get_training_load→get_training_volume→plan_sessions“Ho la febbre da ieri. Adatta le mie prossime due settimane.”
create_period→get_calendar→move_sessions→update_session“Com'è andata la settimana scorsa rispetto al piano? Sarò abbastanza fresco per la gara di sabato?”
get_calendar→get_activity→get_training_load“La mia nuova FTP è 265 W: registrala e aggiorna le mie zone di potenza.”
log_metrics→update_training_zoneStrumenti
23 strumenti: calendario, carico, attività, pianificazione
Gli allenamenti si leggono e si scrivono in unità semplici: durate in secondi, andature come 4:35 al km, le tue zone per id, o percentuali di VAM, FTP o frequenza cardiaca massima. Le date sono nel tuo fuso orario.
Accesso in lettura
read · 12get_athlete_contextData di oggi e fuso orario, metriche, zone, forma e freschezza, le ultime 4 settimane, le prossime gare, periodi e infortuni. Gli agenti lo chiamano per primo.
get_calendarSedute pianificate (svolte, saltate o da fare), gare, note, attività e periodi tra due date.
get_sessionget_activityL'allenamento strutturato di una seduta; i giri di un'attività e le tue risposte alle domande post-attività.
get_activitiesget_training_volumeStorico degli allenamenti e volume settimanale per sport.
get_training_loadCarico settimanale, svolto e pianificato, con forma, fatica e freschezza proiettate sulle sedute pianificate.
get_metricsget_capacitiesget_recordsStorico delle metriche (peso, FC a riposo, HRV, sonno), capacità e migliori sforzi.
list_workout_templateslist_athletesLa tua libreria di allenamenti; per gli allenatori, gli atleti che seguono.
Accesso in scrittura, in aggiunta
write · 11plan_sessionsAggiunge in una volta fino a 60 allenamenti con allenamenti strutturati, gare e note. Vengono salvati tutti, o nessuno.
update_sessionModifica una seduta, una gara o una nota; per una seduta ripetuta, questa e le successive.
move_sessionscopy_sessionsrepeat_sessionSposta o copia sedute di qualche giorno, ripete una seduta ogni tot settimane.
delete_sessionsElimina sedute pianificate. Le sedute svolte e le attività registrate non vengono mai eliminate.
create_periodupdate_perioddelete_periodBlocchi di allenamento e periodi senza allenamento: viaggi, malattia, infortunio.
log_metricsupdate_training_zoneRegistra misurazioni, modifica una zona dopo un test.
Configurazione
Connesso in due minuti
L'indirizzo è lo stesso ovunque. Su un'istanza self-hosted è https://<your domain>/api/mcp.
https://api.openathlete.org/mcpClaude
claude.ai e l'app desktop, poi anche su mobile. Un connettore personalizzato nel piano gratuito
- 1Customize › Connectors › Add custom connector
- 2Incolla l'indirizzo, poi Connetti
- 3Accedi a OpenAthlete e scegli Consenti
ChatGPT
Piani Business, Enterprise ed Edu quando abbiamo verificato; Pro solo in lettura
- 1Plugins › + › Add custom MCP server
- 2Incolla l'indirizzo, scegli OAuth e crealo come plugin
- 3Autorizzalo in OpenAthlete
Claude Code
In un terminale, poi /mcp per accedere
claude mcp add --transport http openathlete https://api.openathlete.org/mcpCursor, VS Code, il tuo agente
OAuth se il client lo supporta, altrimenti un token personale da Impostazioni › Agenti IA, mostrato una sola volta
{
"mcpServers": {
"openathlete": {
"url": "https://api.openathlete.org/mcp",
"headers": { "Authorization": "Bearer oa_pat_..." }
}
}
}Per gli allenatori
Lavora su tutti i tuoi atleti
L'assistente di un allenatore raggiunge gli atleti che segue, con le stesse regole dell'app. Li elenca, poi indica l'atleta a ogni richiesta. Chiedi un resoconto della settimana di tutti, o rielabora il blocco di un atleta dopo un brutto raffreddore.
OpenAthlete per gli allenatoriPer ciascuno dei miei atleti, com'è andata la settimana scorsa rispetto al piano?
- list_athletes6 atleti
- get_calendar× 6, settimana scorsa
Quattro su sei hanno svolto il 90% o più del tempo pianificato. Léa ha saltato entrambe le sedute di qualità e giovedì ha scritto «polpaccio contratto». Marc ha fatto il 30% in più del previsto.
Sicurezza
Sicurezza e permessi
Quello che un assistente fa con i tuoi dati dipende da lui e dal suo fornitore. Collega quelli di cui ti fidi.
OAuth 2.1 con PKCE: approvi ogni assistente su una pagina di OpenAthlete. Non vede mai la tua password.
Lettura e scrittura sono separate. A un assistente con accesso in lettura non vengono nemmeno proposti gli strumenti di scrittura.
I token sono salvati come hash. I token di accesso durano un'ora; i token di aggiornamento sono monouso, e uno rubato usato due volte revoca l'accesso.
I token personali durano 30, 90 o 365 giorni, oppure non scadono mai. Revoca qualsiasi connessione in Impostazioni › Agenti IA; si interrompe alla richiesta successiva.
Gli assistenti accedono al tuo allenamento, non al tuo account: niente cambio password, niente modifiche a dispositivi o abbonamento, niente cancellazione dello storico.
Le domande più frequenti
Sì, su tutti i piani, Free compreso, e sulle istanze self-hosted. Il modello gira dal lato del tuo assistente, con il tuo account Claude o ChatGPT.
Claude (claude.ai, desktop, mobile e Claude Code), ChatGPT in modalità sviluppatore, Cursor, VS Code e qualsiasi client MCP che supporti OAuth o un bearer token.
No. Le sedute svolte e le attività registrate sono il tuo storico e via MCP sono in sola lettura. Può modificare o eliminare solo le sedute ancora da fare.
Sì, esattamente come quelle che pianifichi tu: verso Garmin, Suunto o COROS se l'esportazione degli allenamenti è attiva.
Sì. Approva solo l'ambito di lettura, oppure crea un token personale con accesso in lettura. L'assistente non potrà modificare nulla.
Sì. L'indirizzo è https://<your domain>/api/mcp, con lo stesso flusso OAuth e gli stessi strumenti.
Il resto del ciclo settimanale
Tutte le funzionalitàDai al tuo assistente qualcosa di concreto su cui lavorare
Crea un account, collega il tuo orologio per far arrivare le attività, poi aggiungi OpenAthlete come connettore.
Gratis per sempre. Nessuna carta di credito.