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. Nutzt dein Account Gravl Macros, kann er auch Mahlzeiten, Gewicht und Wasser loggen und dir sagen, wie viele Kalorien und Makros du noch übrig hast. Scopes werden bei jedem Aufruf durchgesetzt, und die Verbindung ist jederzeit widerrufbar.
Verbinden
Füge Gravl in deiner KI-App mit dieser Server-URL als Custom Connector hinzu:
https://mcp.gravl.ai/mcpClaude
- Öffne Einstellungen → Connectors und wähle „Add custom connector“.
- Nenne ihn Gravl und füge die Server-URL ein.
- Wähle Connect und melde dich mit deinem Gravl-Account an.
ChatGPT
- Öffne Einstellungen → Apps & Connectors → Advanced settings und aktiviere den Developer mode.
- Wähle Create, nenne ihn Gravl, füge die Server-URL ein und wähle OAuth.
- Melde dich mit deinem Gravl-Account an, wenn ChatGPT danach fragt.
Grok Bot
- Bitte den Bot: „Füge einen Custom-MCP-Server namens Gravl unter
https://mcp.gravl.ai/mcphinzu“. - Prüfe die URL und wähle Add it.
- Wähle Authorize auf der Connect-Karte und melde dich mit deinem Gravl-Account an.
Muse
- Bitte Muse, einen Custom Connector für Gravl unter
https://mcp.gravl.ai/mcphinzuzufügen. - Öffne den Anmeldelink, den Muse schickt, und melde dich mit deinem Gravl-Account an.
Andere Apps, die Remote-MCP-Server mit OAuth unterstützen, verbindest du auf demselben Weg.
Du meldest dich auf Gravls eigener Seite mit deinem Gravl-Account an: dieselbe E-Mail und dasselbe Passwort oder dasselbe Google- oder Apple-Login wie in der App. Die Verbindung erstellt niemals einen Account, und der Assistent sieht ausschließlich deine eigenen Daten.
Der Assistent bekommt die Tools der Apps, die dein Gravl-Account nutzt: Workout-Tools für Gravl Workouts, Ernährungs-Tools für Gravl Macros und beide, wenn du beide nutzt.
Wenn du Gravl Macros nutzt, sieh dir den Gravl-Macros-Guidean, der nur die Ernährungs-Tools behandelt.
Frag zum Beispiel
- „Logge mein heutiges Workout: Bankdrücken 4×8 mit 80 kg, dann 3 Sätze Klimmzüge bis zum Versagen.“
- „Wie hat sich meine Kniebeuge in den letzten drei Monaten entwickelt?“
- „Ersetze Langhantel-Kniebeugen durch Beinpresse in meiner Vorlage Leg Day.“
- „Bau mir einen 4-Tage-Oberkörper/Unterkörper-Split für mein Home-Gym.“
- „Logge zwei Scheiben Vollkorntoast und einen Milchkaffee zum Frühstück.“
- „Wie viele Kalorien habe ich heute noch übrig?“
Was er kann
Workouts loggen & verwalten
Workouts loggen, lesen und löschen. Geloggte Workouts bekommen Volumen, Kalorien, PRs und Trophäen, genau wie in der App.
Vorlagen & Splits
Workout-Vorlagen und eigene Splits erstellen und bearbeiten oder zu einem Split von Gravl wechseln.
Fortschritt & Rekorde
Trainingszusammenfassungen, Übungsverlauf, persönliche Rekorde, Kraftwerte und Körpermessungen.
Trainingseinstellungen
Ziele, Muskelfokus, Warmup, Pausenzeiten und Workout-Vorlieben ändern, ein Feld nach dem anderen.
Gyms & Equipment
Deine Gym-Profile lesen und das Equipment ändern, mit dem Gravl deine Workouts plant.
Übungskatalog
Übungen suchen, Alternativen finden und eigene Übungen anlegen, wenn eine Bewegung fehlt.
Für Gravl-Macros-Accounts
Lebensmittel suchen
Durchsuche den Gravl-Macros-Katalog nach generischen und Marken-Lebensmitteln, mit Kalorien und Makros pro 100 g und ihren Portionen.
Essen loggen
Füge ein Lebensmittel zu deinem Tag hinzu, mit der Portion, die du genannt hast, etwa „2 Scheiben“ oder „eine Tasse“, oder in Gramm: aus dem Katalog, aus deinen eigenen Lebensmitteln oder als gespeicherte Mahlzeit. Passt nichts, logge eine schnelle Schätzung von Kalorien und Makros.
Einträge korrigieren oder kopieren
Ändere Menge, Uhrzeit oder Tag eines Eintrags, kopiere Mahlzeiten auf einen anderen Tag („dasselbe Frühstück wie gestern“) oder lösche einen Eintrag, nachdem du bestätigt hast, welchen.
Deinen Tag abrufen
Die Einträge eines Tages mit Uhrzeit, Portion, Kalorien und Makros, dazu Tagessummen, deine Kalorien- und Makroziele und was noch übrig ist.
Dein Fortschritt
Deine Kalorien- und Makroziele und dein Ziel, wie eine Woche oder ein Monat im Vergleich dazu gelaufen ist, und dein Gewichtsverlauf und deine Körpermaße.
Gewicht, Körpermaße und Wasser
Logge eine Wägung, Körpermaße oder Wasser in den Einheiten, die du nutzt, oder setze ein neues Zielgewicht. Eine Wägung pro Tag, wie in der App.
Routinen und Fastentage
Logge oder überspringe die Routine eines Tages und markiere einen Tag als Fastentag.
Lebensmittel vom Etikett hinzufügen
Füge ein verpacktes Lebensmittel, das der Katalog nicht hat, anhand seiner Nährwerttabelle hinzu und logge es direkt.
Ü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.
Alles, was du über MCP loggst, erscheint automatisch in Gravl Macros, und die Tagessummen werden neu berechnet. Streaks, Erfolge und die Schätzung deines Energieverbrauchs werden aktualisiert, wenn du die App das nächste Mal öffnest.
Sicherheitsmodell
| Ebene | Was sie tut |
|---|---|
| Gravl-Anmeldung | Du meldest dich auf Gravls eigener Seite an, nie in der KI-App. Die KI-App sieht dein Passwort nie. |
| Scopes pro Verbindung | Jede Verbindung trägt einen expliziten Scope-Satz; jeder Tool-Aufruf wird serverseitig dagegen geprüft. |
| Account-Verknüpfung | Jede Verbindung gehört zu dem Gravl-Account, mit dem du dich anmeldest. Sie erstellt niemals einen neuen Account. |
| 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 |