Integrationen
Gravl MCP
Der Gravl-MCP-Server lässt KI-Assistenten über das Model Context Protocol auf deinem Account arbeiten: logge ein Workout, indem du es beschreibst, passe deinen Split mitten in der Unterhaltung an, frag, was du letzten Monat gedrückt hast. Scopes werden bei jedem Aufruf durchgesetzt, und die Verbindung ist jederzeit widerrufbar.
Verbinden
Füge Gravl in jedem MCP-fähigen Client als Custom Connector hinzu:
https://mcp.gravl.ai/mcp- Claude: Einstellungen → Connectors → „Add custom connector“, URL einfügen und die Anmeldung abschließen, wenn du dazu aufgefordert wirst.
- Andere Clients: jeder Client, der Remote-MCP-Server mit OAuth unterstützt, funktioniert auf demselben Weg.
Melde dich mit der gleichen E-Mail wie in deinem Gravl-Account an. Die Verbindung verknüpft sich mit deinem bestehenden Account, sie erstellt niemals einen neuen, und deine E-Mail muss verifiziert sein. Der Assistent sieht ausschließlich deine eigenen Daten.
Was er kann
Workouts loggen & verwalten
Workouts erstellen, lesen und löschen. Geloggte Workouts bekommen Volumen, Kalorien, PRs und Trophäen, genau wie in der App.
Vorlagen & Splits
Workout-Vorlagen und eigene Trainingssplits direkt aus einer Unterhaltung heraus erstellen und bearbeiten.
Einstellungen & Account
Workout-, Warmup-, Pausenzeit- und Darstellungseinstellungen deines Accounts lesen und ändern.
Katalog durchsuchen
Übungen und Equipment suchen, persönliche Rekorde und Körpermessungen abrufen.
Über MCP geloggte Workouts sind vollwertig: sie bekommen Volumen- und Kalorienberechnung, persönliche Rekorde, Trophäen und Feed-Einträge, genau als wären sie in der App geloggt, und die App übernimmt sie beim nächsten Sync.
Sicherheitsmodell
| Ebene | Was sie tut |
|---|---|
| OAuth-Anmeldung | Der MCP-Server verifiziert deine Identität, bevor irgendein Tool läuft; deine Gravl-Zugangsdaten werden niemals mit dem KI-Client geteilt. |
| Scopes pro Verbindung | Jede Verbindung trägt einen expliziten Scope-Satz; jeder Tool-Aufruf wird serverseitig dagegen geprüft. |
| Account-Verknüpfung | Verbindungen hängen sich ausschließlich per verifizierter E-Mail an bestehende Accounts. |
| Widerruf | Trenne die Verbindung in deinem MCP-Client oder widerrufe sie in deinem Gravl-Account; beides beendet den Zugriff sofort. |
MCP oder die REST-API?
| Du baust… | Nimm |
|---|---|
| Ein KI-Assistenten-Erlebnis (Chat, Agents) auf deinem eigenen Account | MCP |
| Ein Dashboard, Skript oder eine Integration, die deine Daten liest | Ein persönliches Token + REST-API |
| Eine App, in der sich andere Gravl-Nutzer anmelden | OAuth + REST-API |