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. Gli scope vengono applicati a ogni chiamata e la connessione è revocabile in qualsiasi momento.
Collegati
Aggiungi Gravl come connettore personalizzato in qualsiasi client compatibile con MCP:
https://mcp.gravl.ai/mcp- Claude: Impostazioni → Connettori → "Aggiungi connettore personalizzato", incolla l'URL e completa l'accesso quando richiesto.
- Altri client: qualsiasi client che supporta server MCP remoti con OAuth funziona allo stesso modo.
Accedi con la stessa email del tuo account Gravl. La connessione si aggancia al tuo account esistente, non ne crea mai uno nuovo, e la tua email deve essere verificata. L'assistente vede sempre e solo i tuoi dati.
Cosa può fare
Registra e gestisci gli allenamenti
Crea, leggi ed elimina allenamenti. Gli allenamenti registrati ottengono volume, calorie, record personali e trofei esattamente come nell'app.
Template e split
Crea e modifica template di allenamento e split personalizzati direttamente da una conversazione.
Impostazioni e account
Leggi e aggiorna le impostazioni di allenamento, riscaldamento, tempi di recupero e aspetto del tuo account.
Esplora il catalogo
Cerca esercizi e attrezzatura, consulta record personali e misurazioni corporee.
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.
Modello di sicurezza
| Livello | Cosa fa |
|---|---|
| Accesso OAuth | Il server MCP verifica la tua identità prima che qualsiasi tool venga eseguito; le tue credenziali Gravl non vengono mai condivise con il client AI. |
| Scope per connessione | Ogni connessione porta con sé un insieme esplicito di scope; ogni chiamata di tool viene verificata lato server. |
| Collegamento dell'account | Le connessioni si agganciano ad account esistenti solo tramite email verificata. |
| 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 |