Garmin mit Gemini verbinden
Gemini erreicht garmlink über das Model Context Protocol (MCP) auf drei Wegen: als benutzerdefinierte App in der Gemini-App im Web, über die Gemini CLI für Einzelpersonen oder in Gemini Enterprise für Organisationen. Diese Anleitung deckt alle drei ab.
Garmin-Konto verbinden
Auf dem Bildschirm „Verbindung“, melde dich mit deiner E-Mail-Adresse und deinem Passwort bei Garmin Connect an (einmal verwendet, nie gespeichert), gib den Bestätigungscode ein, falls Garmin einen verlangt, und warte auf den Status Verbunden. garmlink beginnt sofort, deine Aktivitäten, deinen Schlaf, deine HRV und deine Trainingskennzahlen zu synchronisieren.
Weg A – Gemini-App (Web)
Google führt benutzerdefinierte Apps schrittweise ein: Vorerst erscheinen sie bei persönlichen Google-Konten in den USA, ab 18 Jahren, mit Gemini auf Englisch und eingeschalteter Keep Activity. Siehst du sie noch nicht? Weg B funktioniert überall.
- 2.
garmlink als benutzerdefinierte App hinzufügen
Öffne auf gemini.google.com Einstellungen, dann Verbundene Apps und Benutzerdefinierte Apps. Füge die garmlink-Adresse ein und klick auf Weiter:https://api.garmlink.ai/mcpGemini öffnet die garmlink-Anmeldeseite: Melde dich an und drück auf Autorisieren.
- 3.
garmlink in einem Chat aufrufen
Tippe in einer Unterhaltung @, wähle garmlink und frag dann:- „Wie habe ich diese Woche geschlafen?“
- „Fasse meine letzten fünf Läufe zusammen.“
- „Steigt oder sinkt meine Trainingsbelastung in diesem Monat?“
Weg B – Gemini CLI (einzeln)
- 4.
Gemini CLI installieren
Installiere die CLI global und führe sie einmal aus, damit sie ihr Konfigurationsverzeichnis anlegt:npm install -g @google/gemini-cligemini
Melde dich mit deinem Google-Konto an, wenn danach gefragt wird.
- 5.
garmlink in den CLI-Einstellungen eintragen
Öffne~/.gemini/settings.json(leg sie an, falls sie nicht existiert) und trage garmlink als MCP-Server ein:{ "mcpServers": { "garmlink": { "httpUrl": "https://api.garmlink.ai/mcp", "oauth": { "enabled": true } } } }Mehr kommt nicht in diese Datei – keine Header, kein API-Schlüssel, kein Client-Secret. Bei aktiviertem OAuth führt die Gemini CLI den gesamten OAuth-2.0-Ablauf selbst durch.
- 6.
CLI starten und Zugriff freigeben
Startegeminiin einem Terminal. Beim ersten Zugriff auf garmlink öffnet sich ein Browserfenster: Melde dich an, gib den Lesezugriff frei, und die CLI speichert die Tokens lokal für das nächste Mal.Frag dann einfach in normaler Sprache:
- „Wie habe ich diese Woche geschlafen?“
- „Fasse meine letzten fünf Läufe zusammen.“
- „Steigt oder sinkt meine Trainingsbelastung in diesem Monat?“
Weg C – Gemini Enterprise (Organisation)
- 7.
MCP-Server in Gemini Enterprise hinzufügen
Öffne in Gemini Enterprise Connected apps → Add MCP Server. Trag die Angaben zum MCP-Server ein – einen Namen, eine Beschreibung und die garmlink-URL:https://api.garmlink.ai/mcpNur der Transport StreamableHTTP wird unterstützt – ältere SSE-MCP-Server werden abgelehnt. garmlink nutzt StreamableHTTP und erfüllt die Voraussetzung also.
Symbol (optional)
PNG, 256×256, ≤ 10 KB. Das garmlink-Symbol bringt seinen eigenen Hintergrund mit und bleibt deshalb lesbar, egal ob die Oberfläche des Assistenten hell oder dunkel ist.
- 8.
Authentifizieren und Geltungsbereich festlegen
Wähle OAuth als Authentifizierungsmethode und schließe die garmlink-Anmeldung ab. Wähle dann den Geltungsbereich: die Verbindung für die ganze Organisation veröffentlichen oder jedes Mitglied mit seinem eigenen garmlink-Konto authentifizieren lassen.
- In der Gemini-App gibt es keine Option „Benutzerdefinierte Apps“. Dein Konto hat noch keine benutzerdefinierten Apps – Google öffnet sie zuerst für persönliche Konten in den USA, auf Englisch. Nutz in der Zwischenzeit die Gemini CLI oder Gemini Enterprise, falls deine Organisation es hat.
- Die CLI kann sich nicht authentifizieren. Stell sicher, dass
~/.gemini/settings.jsonkeinen Header und kein Token neben dem OAuth-Block enthält – ein veralteter Authorization-Header hat Vorrang vor dem OAuth-Ablauf, und der Server antwortet mit 401. - Der Server ist nicht erreichbar. Die MCP-URL muss von dem Rechner, auf dem die CLI läuft (oder von Gemini Enterprise), über HTTPS erreichbar sein – prüf, dass kein Proxy oder keine Firewall sie blockiert.
- Daten wirken leer oder veraltet. Prüf auf dem Bildschirm „Verbindung“.
Du nutzt einen anderen Assistenten? Sieh dir an: alle Anleitungen. Neugierig, was garmlink lesen kann? Stöbere in der Tool-Referenz. Du willst zuerst echte Antworten sehen? Lies zwölf Beispiele aus einem echten Konto.
