FitnessSyncer AI e MCP Server

Il FitnessSyncer MCP Server collega il tuo account a un assistente AI, così puoi chiedere informazioni sui tuoi dati relativi alla salute e alla forma fisica usando un linguaggio semplice, invece di dover creare un report apposito. Chiedi come si è comportata la tua frequenza cardiaca a riposo da gennaio, se dormi meglio nei giorni in cui ti alleni o quale fonte ha smesso di sincronizzarsi la settimana scorsa, e l’assistente ti risponderà sulla base dei tuoi dati specifici anziché con generalizzazioni. Può anche registrare un dato per te, così potrai dettare il risultato di una pesata o una nota durante la stessa conversazione.

Funziona con Claude, ChatGPT, Perplexity, Mistral, l’Assistente di Home Assistant e qualsiasi assistente in grado di autenticarsi tramite un token Bearer o una chiave API. È incluso in ogni account, quindi non è necessario acquistare nulla in più; un account gratuito ha semplicemente accesso a una cronologia meno estesa, esattamente come avviene in ogni altra sezione del sito. Di seguito è riportata la guida alla configurazione.

Per alcune configurazioni avanzate è ancora necessario utilizzare il sito web o l'app FitnessSyncer.

Esempi di prompt

Dopo aver collegato FitnessSyncer, puoi incollare uno qualsiasi dei suggerimenti riportati di seguito in Claude, ChatGPT, Perplexity o Mistral. Si tratta solo di esempi; puoi combinare gli argomenti a tuo piacimento.

Controlli sanitari quotidiani

Questi ti aiutano a farti subito un’idea di “come sto andando?”.

• Forniscimi un riepilogo settimanale sul mio stato di salute basato su tutte le informazioni che FitnessSyncer ha su di me, tra cui attività fisica, sonno, peso, pressione sanguigna e glicemia, se disponibile. Segnalami qualsiasi dato che sembri fuori dai miei valori normali.
• Riassumi il mio stato di salute degli ultimi 30 giorni ed evidenzia le tre aree principali su cui dovrei concentrarmi per migliorare la mia salute generale.
• Dando un'occhiata ai miei dati recenti FitnessSyncer, cosa è cambiato di più nell'ultimo mese: attività fisica, sonno, peso, pressione sanguigna o glicemia?
• Dal 1° al 31 gennaio, forniscimi una panoramica sul mio stato di salute e indicami quali giorni sono risultati insolitamente positivi o insolitamente negativi.
• C'è stato effettivamente qualche cambiamento nei miei dati sanitari negli ultimi tempi? Indicami solo i cambiamenti effettivi, escludendo le normali variazioni da una settimana all'altra.
• Confronta le ultime quattro settimane con i tre mesi precedenti e dimmi quali dei miei indicatori hanno subito variazioni, in quale direzione e di quanto.

Attività e formazione

Concentrati sui passi, sulla distanza e sul carico di allenamento.

• Sono stato più attivo questa settimana rispetto alla scorsa? Utilizza il parametro (passi o distanza) che uso normalmente in FitnessSyncer e spiega la differenza.
• Fammi avere un riepilogo dei miei allenamenti degli ultimi 30 giorni, includendo la distanza totale, la durata, le calorie e i tipi di allenamento che pratico più spesso.
• Il numero dei miei passi giornalieri ha registrato un andamento al rialzo o al ribasso negli ultimi 90 giorni? Indica l'entità della variazione e se questa è statisticamente irrilevante o significativa.
• Confronta la mia attività di questo mese con quella del mese scorso e dimmi se, in base alle mie abitudini recenti, sto facendo abbastanza per la mia salute in generale.
• Qual è stato il mio miglio più veloce negli ultimi 30 giorni e durante quale corsa l'ho percorso?
• Mostrami i tempi parziali miglio per miglio della mia ultima corsa e dimmi se ho mantenuto un ritmo costante.
• Mostrami i miei tempi parziali sui 100 yard dell'ultima sessione in piscina.

Frequenza cardiaca, HRV e recupero

Frequenza cardiaca a riposo, zone di frequenza cardiaca, HRV, VO2 max e altri parametri di recupero.

• Fammi avere un riepilogo sulla salute cardiaca degli ultimi 30 giorni: frequenza cardiaca a riposo, HRV, frequenza cardiaca durante il sonno e tempo trascorso in ciascuna zona di frequenza cardiaca.
• Come si è comportata la mia frequenza cardiaca a riposo negli ultimi 30 giorni? Tende ad aumentare o a diminuire?
• Confronta la mia HRV notturna con quella diurna delle ultime due settimane e dimmi se sembra che io stia recuperando bene tra un allenamento e l'altro.
• Qual è il mio VO2 max attuale e come si è evoluto negli ultimi 90 giorni?
• Oggi la mia HRV è bassa rispetto al mio valore normale? C'è qualcos'altro di insolito per me in questo momento?

ECG registrazioni

Registrazione dei metadati, dei riepiloghi storici e del contesto trasversale tra fornitori per gli ECG sincronizzati da Apple Watch, Fitbit Sense, Withings e altri dispositivi compatibili con ECG. La classificazione viene sempre riportata dal dispositivo di registrazione, non a fini diagnostici, e la forma d'onda stessa non viene mai restituita.

• Quante registrazioni ECG ho quest'anno e cosa hanno evidenziato?
• Mostrami le mie ultime ECG registrazioni e segnalami quelle in cui non era presente il ritmo sinusale.
• Avevo assunto caffeina o dormito meno del solito prima del mio ultimo ECG?

Peso e composizione corporea

Suggerimenti orientati alle tendenze che combinano un’istantanea e una direzione.

• Come è variato il mio peso negli ultimi 3 mesi? Indica il mio peso medio, la variazione totale e se la tendenza è al rialzo, al ribasso o stabile.
• Qual è la mia percentuale media di grasso corporeo questo mese e come si colloca rispetto al mese scorso? Dimmi se la variazione è significativa.
• Sto cercando di perdere circa 0,5 kg (o 1 lb) alla settimana. Considerando l'andamento del mio peso negli ultimi tempi, direi che sono più o meno in linea con l'obiettivo?
• Utilizzando i miei dati recenti FitnessSyncer, calcola quanto tempo mi ci vorrebbe per raggiungere i 75 kg se l'andamento attuale del mio peso dovesse continuare.

Pressione arteriosa e salute cardiovascolare

Utile per chi tiene sotto controllo l'ipertensione con il proprio medico.

• Mostrami un riepilogo della pressione arteriosa degli ultimi 90 giorni, comprensivo di valori medi, minimi e massimi e della mia classificazione AHA. Spiegami in parole semplici cosa significa quella classificazione.
• La mia pressione arteriosa rientra per lo più nella norma questo mese, oppure ho registrato molti valori elevati o ipertensivi? Segnalami eventuali andamenti preoccupanti.
• La mia pressione arteriosa ha mostrato un andamento al rialzo o al ribasso negli ultimi 3 mesi, e qual è stato il mio ultimo valore misurato?
• Sulla base dei valori della pressione arteriosa registrati negli ultimi 30 giorni, quali domande concrete dovrei porre al mio medico?

Glucosio e diabete

Confronto tra i valori “Time-in-range” e tra quelli recenti e quelli precedenti.

• Negli ultimi 14 giorni, qual è la mia glicemia media, il tempo trascorso nei valori target e l'A1C stimata in base ai miei dati FitnessSyncer? Confronta questi dati con quelli dei 14 giorni precedenti.
• Nell'ultimo mese ho raggiunto l'obiettivo abituale relativo al tempo trascorso entro i valori target per le persone con diabete? Spiegami quanto mi sono avvicinato a tale obiettivo.
• Come si colloca il mio livello di glucosio di questa settimana rispetto a quello della settimana scorsa? Includi la media, la variabilità e il tempo trascorso entro i valori target.
• Analizzando i miei livelli di glucosio degli ultimi 90 giorni, ci sono particolari momenti della giornata o giorni della settimana in cui tendo ad avere valori alti o bassi?

Sonno e recupero

Poni l'accento sulla costanza, sulla durata e sulla qualità.

• Negli ultimi 30 giorni ho dormito in media almeno 7 ore? Indica la fase di sonno leggero, profondo e REM, se disponibili.
• Il mio ritmo di sonno è stato regolare nell'ultimo mese, oppure vado a letto e mi sveglio a orari molto diversi tra loro? Segnala eventuali cambiamenti significativi.
• Riassumi il mio sonno dell'ultima settimana ed evidenzia eventuali notti caratterizzate da una durata del sonno insolitamente breve o da una scarsa efficienza del sonno.
• Se considero gli ultimi 3 mesi, in che modo il mio sonno è correlato alla mia attività fisica? Le giornate in cui sono più attivo tendono a migliorare o a peggiorare il mio sonno?

Monitoraggio del ciclo mestruale

Chiedi informazioni sul giorno del ciclo, sulla fase e sulle previsioni senza dover calcolare tu stessa le date.

• A che giorno del ciclo sono e quando dovrei avere le prossime mestruazioni?
• Quando cade la mia finestra fertile in questo ciclo?
• Qual è stata la durata media dei miei ultimi cicli registrati in FitnessSyncer?

Obiettivi e responsabilità

Prompt che utilizzano obiettivi memorizzati o obiettivi definiti ad hoc.

• Ho fissato degli obiettivi di salute in FitnessSyncer e li sto raggiungendo questa settimana? Riassumi ogni obiettivo e il suo stato di avanzamento.
• Imposta un obiettivo in FitnessSyncer per percorrere almeno 8.000 passi al giorno, quindi verifica che sia stato creato.
• Vorrei raggiungere l'obiettivo di 10.000 passi al giorno e 7 ore di sonno a notte. Senza salvarli come obiettivi, verifica se i miei dati recenti indicano che sono sulla buona strada.
• In base alle mie tendenze attuali relative ai passi, al sonno e al peso, suggeriscimi degli obiettivi realistici per i prossimi 30 giorni e impostali per me.

Classifiche

Suggerimenti relativi al FitnessSyncer Leaderboards che organizzi o a cui partecipi. Il tuo assistente può leggerli; per partecipare, abbandonare o crearne uno, vai su FitnessSyncer.

• Come sto andando nel mio FitnessSyncer Leaderboards? Dimmi a che posto sono in ciascuna categoria, chi mi precede e di quanto.
• Dai un'occhiata al FitnessSyncer Leaderboard che ho preparato e dimmi quali partecipanti non hanno ancora dati e perché.

Appunti e modifiche sul taccuino

Racconta semplicemente al AI cosa è successo, in modo da lasciarne traccia nel tuo FitnessSyncer Notebook.

• Ho registrato una misurazione della pressione arteriosa nel mio FitnessSyncer Notebook: 118 su 76, polso 62, misurata stamattina alle 8:00, con una nota in cui ho indicato che mi sentivo rilassato.
• Annotare nel mio taccuino il valore della glicemia a digiuno di 95 mg/dL misurato questa mattina, contrassegnandolo con l’etichetta “Prima di colazione”.
• Aggiungi al mio taccuino il sonno di ieri notte, dalle 23:00 alle 7:00, calcola quante ore ho dormito e inserisci una nota in cui indichi che mi sono svegliato una volta verso le 3:00.
• Quali sono state le ultime tre voci che ho aggiunto oggi sul taccuino? Potresti riassumermele?
• La misurazione della pressione arteriosa che hai appena inserito riporta un valore errato per la frequenza cardiaca; dovrebbe essere 58. Individua quella voce e correggi il valore della frequenza cardiaca.
• Inserisco i valori del profilo lipidico nel mio FitnessSyncer Notebook in base ai risultati delle analisi di oggi: colesterolo totale 180 mg/dL, LDL 100 mg/dL, HDL 50 mg/dL, trigliceridi 120 mg/dL.
• Annotare i dati del ciclo di oggi nel mio FitnessSyncer Notebook: flusso medio, temperatura corporea basale 36,7 °C, muco cervicale simile all’albume.
• Aggiungi la penicillina come allergia nel mio FitnessSyncer Notebook, con una nota che indichi che provoca orticaria.
• Ho annotato che oggi ho iniziato a prendere Lisinopril 10 mg una volta al giorno nel mio FitnessSyncer Notebook.
• Aggiungi il diabete di tipo 2 come patologia nel mio FitnessSyncer Notebook, diagnosticato lo scorso anno.
• Quali allergie, patologie e farmaci sono attualmente registrati nel mio fascicolo in FitnessSyncer?
• Registrare manualmente su FitnessSyncer Notebook l'allenamento di forza di 30 minuti che ho fatto oggi, con circa 250 calorie bruciate.

Fonti, sincronizzazione e risoluzione dei problemi

Visualizza le origini e le destinazioni FitnessSyncer e risolvi alcuni problemi.

• Elenca tutte le app e i dispositivi a cui FitnessSyncer è attualmente connesso per il mio account e mostra quando è avvenuta l'ultima sincronizzazione.
• Elenca le mie destinazioni configurate, indicando se sono attive e quando sono state eseguite l'ultima volta.
• Aggiorna la mia fonte Coros e fammi sapere se la sincronizzazione è stata avviata correttamente.
• Esegui subito la mia destinazione Strava in modo che i miei ultimi allenamenti vengano trasferiti, e conferma quando la sincronizzazione è stata messa in coda.

Unità di misura, impostazioni e personalizzazione

Rendere chiaro che l'agente è in grado di gestire le preferenze in modo colloquiale.

• Quali unità di misura stai utilizzando in FitnessSyncer per il mio peso, la distanza, la glicemia e la temperatura?
• Per quali metriche è possibile monitorare le tendenze o effettuare confronti su base periodica in FitnessSyncer?
• Modifica le mie preferenze in modo che la distanza sia espressa in miglia, il peso in libbre e il glucosio in mg/dL, quindi conferma la modifica.
• Qual è il mio peso medio negli ultimi 30 giorni? Mostramelo nelle unità di misura che preferisco e indicami la variazione rispetto ai 30 giorni precedenti.
• Aggiorna il mio profilo FitnessSyncer con la mia altezza attuale, la data di nascita e le soglie di glucosio, quindi riassumi le mie impostazioni aggiornate.

Flussi di lavoro in più fasi per “utenti esperti”

Questi esempi illustrano il ragionamento multi-strumento del server MCP.

• Analizzando i dati degli ultimi 3 mesi del mio FitnessSyncer, quali sono le principali tendenze relative all'attività fisica, al peso, al sonno e alla pressione sanguigna? Per ciascuna di esse, indicami se la tendenza è in miglioramento, in peggioramento o stabile.
• Tenendo conto dell'andamento attuale del mio peso, del sonno e dei passi, proponi un semplice programma di 4 settimane con obiettivi per ciascuna area che risultino realistici, senza essere eccessivi.
• Negli ultimi 90 giorni, individua le settimane in cui ho dormito male e la mia frequenza cardiaca a riposo o la mia pressione sanguigna erano più alte del solito. Descrivi quelle settimane e cosa è cambiato.
• Usa FitnessSyncer per elencare tutte le mie registrazioni relative al peso del mio taccuino dell'ultimo anno, individuare i valori minimi e massimi e spiegare come sono passato da uno all'altro.

Introduzione

Iniziare è facile. Se non sei ancora un utente FitnessSyncer o non hai ancora configurato il tuo account, ti consigliamo di iniziare da qui per configurarlo. Gli assistenti AI non vedono mai la password del tuo account. Utilizzano un'app OAuth che crei con un ID cliente e un segreto cliente. Puoi revocare l'accesso in qualsiasi momento dal tuo profilo FitnessSyncer o dalla Configurazione sviluppatore.

Una volta configurato il tuo account, dovrai creare un profilo API per integrarlo con il tuo assistente AI. Può sembrare complicato, ma in realtà è molto semplice.

1. Vai alla pagina "Account sviluppatori".
2. In fondo alla pagina, seleziona il tuo assistente AI dall'elenco e clicca su “Crea”. Se non lo vedi, scegli “MCP: Chiave API”.
3. Se hai selezionato un assistente AI che supportiamo nativamente, nella pagina successiva prendi nota dell’ID cliente e del segreto cliente, poiché ti serviranno per configurare il tuo assistente.
   
   Se hai selezionato la chiave API, nella pagina successiva FitnessSyncer ti chiederà tutte le autorizzazioni che desideri concedere a questo assistente AI. Seleziona le opzioni che desideri rendere disponibili, quindi seleziona «Crea chiave API»; nella pagina successiva verrà visualizzata la tua chiave API, necessaria per configurare il tuo assistente.
   
   Nota: il segreto client e la chiave API vengono visualizzati solo la prima volta; se li perdi, puoi sempre rigenerarli, ma dovrai anche riconfigurare il tuo assistente.
4. Segui le istruzioni relative al tuo assistente personale, disponibili al link qui sotto.

Il tuo assistente AI potrebbe proporti di registrarsi automaticamente su FitnessSyncer, con un nome del tipo “Registrazione automatica”, “Registrazione dinamica del client” o “Usa l’identità pubblicata da Claude”. FitnessSyncer non supporta la registrazione automatica, quindi scegli sempre l’opzione che ti consente di inserire l’ID cliente e il segreto cliente che hai creato in precedenza.

Il tuo assistente potrebbe anche segnalarti che OpenID Connect, un documento contenente i metadati del client (CIMD) non è disponibile perché FitnessSyncer non lo ha reso pubblico. Si tratta di un comportamento previsto, che non impedisce il corretto funzionamento della connessione. FitnessSyncer esclude deliberatamente il profilo del tuo account dall’integrazione e al tuo assistente servono solo l’ID cliente e il segreto cliente.

Istruzioni per il tuo assistente

Ogni assistente richiede le stesse due cose: l'indirizzo del server e le chiavi che hai appena creato, e ognuno le salva in una posizione diversa. Scegli la tua:

• Claude, aggiunto come connettore personalizzato che effettua l'accesso tramite il proprio client OAuth.
• ChatGPT, aggiunto come server personalizzato MCP da ChatGPT sul web.
• Perplexity, aggiunto come connettore personalizzato sul trasporto HTTP di Streamable.
• Home Assistant, quindi la sua funzione di assistenza può rispondere sia a voce che tramite chat.
• Mistral Vibe e qualsiasi altro servizio che utilizzi un token al portatore, compresa un’istanza configurata tramite file.