Configuration de garmlink dans Gemini

Configuration de garmlink dans

Gemini atteint garmlink via le Model Context Protocol (MCP) — par Gemini CLI pour un usage individuel, ou par Gemini Enterprise pour une organisation. L’application Gemini grand public ne sait pas encore ajouter de connecteur personnalisé : ce guide couvre donc les deux voies qui marchent aujourd’hui.

L’application Gemini ne gère pas les connecteurs MCP

L’application grand public Gemini — gemini.google.com — ne permet pas d’ajouter un connecteur MCP personnalisé : le réglage n’existe tout simplement pas. Ce guide couvre les deux chemins qui marchent : Gemini CLI pour les particuliers, Gemini Enterprise pour les organisations.

Avant de commencer

Il te faut un compte garmlink avec ta Garmin connectée (ça se fait sur l’écran Connecter ta Garmin), et soit Gemini CLI sur ta machine, soit un espace Gemini Enterprise.

Connecte ton compte Garmin

Sur l’écran Connecter ta Garmin, saisis tes identifiants Garmin Connect, entre le code de vérification si Garmin en demande un, et attends que le statut passe à Connecté. garmlink commence aussitôt à synchroniser tes activités, ton sommeil, ta VFC et tes métriques d’entraînement.

Chemin A — Gemini CLI (particulier)

Installe Gemini CLI

Installe la CLI en global, puis lance-la une fois pour qu’elle crée son dossier de configuration :

npm install -g @google/gemini-cli
gemini

Connecte-toi avec ton compte Google quand elle le demande.

Déclare garmlink dans les réglages de la CLI

Ouvre ~/.gemini/settings.json (crée-le s’il n’existe pas) et déclare garmlink comme serveur MCP :

{
  "mcpServers": {
    "garmlink": {
      "httpUrl": "https://api.garmlink.ai/mcp",
      "oauth": { "enabled": true }
    }
  }
}

Rien d’autre ne va dans ce fichier — ni en-tête, ni clé d’API, ni secret client. Avec OAuth activé, Gemini CLI mène tout le flux OAuth 2.0 lui-même.

Lance la CLI et autorise l’accès

Lance gemini dans un terminal. Au premier appel à garmlink, une fenêtre de navigateur s’ouvre : connecte-toi, autorise l’accès en lecture seule, et la CLI garde les jetons en local pour la suite.

Ensuite, pose tes questions en langage courant :

« Comment ai-je dormi cette semaine ? »
« Résume mes cinq dernières courses. »
« Ma charge d’entraînement monte ou descend ce mois-ci ? »

Chemin B — Gemini Enterprise (organisation)

Ajoute le serveur MCP dans Gemini Enterprise

Dans Gemini Enterprise, ouvre Connected apps → Add MCP Server. Renseigne les infos du serveur MCP — un nom, une description et l’URL garmlink :https://api.garmlink.ai/mcp

Seul le transport StreamableHTTP est accepté — les anciens serveurs MCP en SSE sont refusés. garmlink est en StreamableHTTP, il est donc compatible.

Authentifie-toi et choisis la portée

Choisis OAuth comme méthode d’authentification et termine la connexion garmlink. Définis ensuite la portée : publier la connexion pour toute l’organisation, ou demander à chaque membre de s’authentifier avec son propre compte garmlink.

Dépannage

Aucune option MCP dans l’application Gemini. C’est normal : l’application grand public ne gère pas du tout les connecteurs personnalisés. Passe par Gemini CLI, ou par Gemini Enterprise si ton organisation en dispose.
La CLI n’arrive pas à s’authentifier. Vérifie que ~/.gemini/settings.json ne contient ni en-tête ni jeton à côté du bloc OAuth — un en-tête Authorization périmé prend le pas sur le flux OAuth et le serveur répond 401.
Le serveur est injoignable. L’URL MCP doit être joignable en HTTPS depuis la machine qui exécute la CLI (ou depuis Gemini Enterprise) — vérifie qu’aucun proxy ni pare-feu ne la bloque.
Les données semblent vides ou anciennes. Regarde où en est la synchro sur l’écran Connecter ta Garmin.

Tu utilises un autre assistant ? Va voir les quatre guides de configuration. Envie de savoir ce que garmlink peut lire ? Parcours la référence des outils.