Integrazioni
Gravl MCP
Il server MCP di Gravl permette agli assistenti AI di agire sul tuo account tramite il Model Context Protocol: registra un allenamento descrivendolo, ritocca il tuo split a metà conversazione, chiedi quanto hai sollevato in panca il mese scorso. Se il tuo account usa Gravl Macros, può anche registrare pasti, peso e acqua e dirti quante calorie e macro ti restano. Gli scope vengono applicati a ogni chiamata e la connessione è revocabile in qualsiasi momento.
Collegati
Aggiungi Gravl come connettore personalizzato nella tua app AI con questo URL del server:
https://mcp.gravl.ai/mcpClaude
- Apri Impostazioni → Connettori e scegli “Aggiungi connettore personalizzato”.
- Chiamalo Gravl e incolla l’URL del server.
- Scegli Connetti e accedi con il tuo account Gravl.
ChatGPT
- Apri Impostazioni → App e connettori → Impostazioni avanzate e attiva la modalità sviluppatore.
- Scegli Crea, chiamalo Gravl, incolla l’URL del server e scegli OAuth.
- Accedi con il tuo account Gravl quando ChatGPT te lo chiede.
Grok Bot
- Chiedi al bot: “Aggiungi un server MCP personalizzato chiamato Gravl a
https://mcp.gravl.ai/mcp”. - Controlla l’URL e scegli Add it.
- Scegli Authorize nella scheda di connessione e accedi con il tuo account Gravl.
Muse
- Chiedi a Muse di aggiungere un connettore personalizzato per Gravl a
https://mcp.gravl.ai/mcp. - Apri il link di accesso che Muse ti invia e accedi con il tuo account Gravl.
Le altre app che supportano server MCP remoti con OAuth si collegano allo stesso modo.
Accedi dalla pagina di Gravl con il tuo account Gravl: la stessa email e password, o lo stesso accesso Google o Apple che usi nell’app. Il collegamento non crea mai un account, e l’assistente vede solo i tuoi dati.
L’assistente riceve gli strumenti delle app che il tuo account Gravl usa: quelli di allenamento per Gravl Workouts, quelli per l’alimentazione per Gravl Macros, ed entrambi se le usi tutte e due.
Se usi Gravl Macros, consulta la guida di Gravl Macros, che copre solo gli strumenti per l’alimentazione.
Prova a chiedere
- “Registra l’allenamento di oggi: panca piana 4×8 con 80 kg, poi 3 serie di trazioni a cedimento.”
- “Com’è cambiato il mio squat negli ultimi tre mesi?”
- “Sostituisci lo squat con bilanciere con la leg press nel mio template Leg Day.”
- “Creami uno split upper/lower di 4 giorni per la mia palestra di casa.”
- “Registra due fette di pane integrale tostato e un caffellatte a colazione.”
- “Quante calorie mi restano oggi?”
Cosa può fare
Registra e gestisci allenamenti
Registra, leggi ed elimina allenamenti: quelli registrati ottengono volume, calorie, record e trofei come nell’app.
Template e split
Crea e modifica template di allenamento e split personalizzati, o passa a uno degli split di Gravl.
Progressi e record
Riepiloghi di allenamento, storico degli esercizi, record personali, punteggi di forza e misure corporee.
Impostazioni di allenamento
Cambia obiettivi, focus muscolare, riscaldamento, tempi di recupero e preferenze di allenamento, un campo alla volta.
Palestre e attrezzatura
Leggi i profili delle tue palestre e aggiorna l’attrezzatura su cui Gravl pianifica i tuoi allenamenti.
Catalogo esercizi
Cerca esercizi, trova alternative e crea un esercizio personalizzato quando manca un movimento.
Per gli account Gravl Macros
Cerca alimenti
Cerca nel catalogo di Gravl Macros alimenti generici e di marca, con calorie e macro per 100 g e le relative porzioni.
Registra un pasto
Aggiungi un alimento alla tua giornata con la porzione che hai indicato, come “2 fette” o “una tazza”, o in grammi: dal catalogo, dai tuoi alimenti o da un pasto salvato. Se non c’è nulla che corrisponda, registra una stima rapida di calorie e macro.
Correggi o copia le voci
Cambia quantità, orario o giorno di una voce, copia i pasti in un altro giorno (“la stessa colazione di ieri”) o elimina una voce dopo aver confermato quale.
Consulta la tua giornata
Le voci di un giorno con orario, porzione, calorie e macro, più i totali giornalieri, i tuoi obiettivi di calorie e macro e quanto ti resta.
I tuoi progressi
I tuoi obiettivi di calorie e macro e il tuo obiettivo generale, com’è andata una settimana o un mese rispetto a questi, e l’andamento del peso e delle misure.
Peso, misure e acqua
Registra una pesata, le misure corporee o l’acqua nelle unità che usi, oppure imposta un nuovo peso obiettivo. Una pesata al giorno, come nell’app.
Routine e giorni di digiuno
Registra o salta la routine di un giorno e segna un giorno come giorno di digiuno.
Aggiungi un alimento dall’etichetta
Aggiungi un alimento confezionato che il catalogo non ha partendo dalla sua etichetta nutrizionale, poi registralo subito.
Gli allenamenti registrati tramite MCP sono di prima classe: ottengono calcoli di volume e calorie, record personali, trofei e voci nel feed esattamente come se fossero registrati nell'app, e l'app li recupera alla sincronizzazione successiva.
Tutto ciò che registri tramite MCP compare automaticamente in Gravl Macros, con i totali del giorno ricalcolati. Serie, traguardi e la stima del tuo dispendio energetico si aggiornano la prossima volta che apri l’app.
Modello di sicurezza
| Livello | Cosa fa |
|---|---|
| Accesso Gravl | Accedi dalla pagina di Gravl, mai dentro l’app AI. L’app AI non vede mai la tua password. |
| Scope per connessione | Ogni connessione porta con sé un insieme esplicito di scope; ogni chiamata di tool viene verificata lato server. |
| Collegamento dell'account | Ogni collegamento è legato all’account Gravl con cui accedi. Non crea mai un nuovo account. |
| Revoca | Disconnetti dal tuo client MCP, o revoca la connessione dal tuo account Gravl: entrambe interrompono l'accesso immediatamente. |
MCP o la REST API?
| Stai costruendo… | Usa |
|---|---|
| Un'esperienza con assistente AI (chat, agenti) sul tuo account | MCP |
| Una dashboard, uno script o un'integrazione che legge i tuoi dati | Un personal token + REST API |
| Un'app a cui altri utenti Gravl accedono | OAuth + REST API |