TUTORIEL · 5 MINUTES

Connecter ton assistant IA à ta montre Garmin

Running Workout expose un serveur MCP : un pont standard qui permet à un assistant IA de lire ton entraînement et d’écrire des séances sur ta Garmin. Ce guide te montre comment le brancher, quel que soit l’assistant que tu utilises.

C’est quoi, un serveur MCP ?

MCP (Model Context Protocol) est un standard ouvert qui permet à un assistant IA de se connecter à un service extérieur. Une fois le connecteur ajouté, ton assistant dispose d’outils : il peut consulter tes activités et créer des séances sur ton compte Garmin. Tu n’installes rien sur ton ordinateur — le serveur est hébergé par nous.

Avant de commencer

Une étape commune aux trois assistants, et une adresse à garder sous la main.

Crée ton compte et connecte Garmin

Sur runningworkout.fr, clique sur « Connecter Garmin ». Tu autorises Running Workout depuis Garmin Connect : ton mot de passe ne nous est jamais transmis, et tu peux révoquer l’accès à tout moment. À la fin de l’inscription, l’étape « Assistant IA » te propose les boutons « Ajouter à Claude » et « Ajouter à ChatGPT ».

Garde l’adresse du serveur sous la main

Avec Claude et ChatGPT, un bouton suffit : rien à copier. L’adresse sert pour Gemini, Claude Code ou un connecteur personnalisé. Elle est identique pour tout le monde et ne contient aucun secret : ton identification se fait ensuite dans ton navigateur.

Adresse du serveur MCP

https://www.runningworkout.fr/mcp

Choisis ton assistant

Connecter avec Claude

Running Workout est dans l’annuaire des connecteurs de Claude, ouvert à toutes les offres, gratuite comprise : le bouton ci-dessous suffit. Ajouté sur claude.ai ou dans l’application de bureau, il sert aussi sur mobile et dans Cowork.

Ajouter à Claude

Ouvre la fiche officielle de Running Workout dans Claude : clique sur « Connecter », puis autorise ton compte. Les étapes ci-dessous détaillent le parcours et la voie de secours, qui vaut aussi pour un autre client MCP.

1

Ouvre la fiche Running Workout

Clique sur « Ajouter à Claude » ci-dessus : la fiche officielle s’ouvre dans l’annuaire des connecteurs de Claude. Ou, dans Claude : « Personnaliser » > « Connecteurs », bouton « + », puis cherche Running Workout.
2

Connecte-toi

Clique sur « Connecter » (connecte-toi d’abord à Claude si la fiche te le demande). Claude t’envoie sur runningworkout.fr : identifie-toi, puis valide l’écran d’autorisation qui liste ce que l’assistant pourra faire.
3

Demande ta première séance

Ouvre une nouvelle conversation et pose ta question : Claude peut faire appel de lui-même à Running Workout. S’il répond sans tes données, ouvre le menu « + », survole « Connecteurs » et active Running Workout pour cette conversation.
4

Voie de secours : connecteur personnalisé

Si la fiche ne t’est pas proposée : « Personnaliser » > « Connecteurs », bouton « + », puis ajout d’un connecteur personnalisé (« Personnalisé », puis « Web », dans la dernière version). Colle l’adresse du serveur, clique sur « Continuer » jusqu’au bouton « Ajouter », puis valide l’autorisation. L’offre gratuite de Claude en autorise un seul.

Dans le terminal, avec Claude Code

Une commande suffit, puis lance l’authentification avec la commande /mcp.

claude mcp add --transport http running-workout \
  https://www.runningworkout.fr/mcp

Comptes Team et Enterprise

Le propriétaire de l’organisation ajoute d’abord Running Workout depuis « Paramètres de l’organisation » > « Connecteurs » (« Parcourir les connecteurs », puis « Ajouter à votre équipe »). Chaque membre clique ensuite sur « Connecter » depuis « Personnaliser » > « Connecteurs », avec son propre compte Garmin.

Connecter avec ChatGPT

Running Workout est un plugin public du catalogue de ChatGPT. D’après OpenAI, le catalogue est ouvert à toutes les offres ; l’installation peut dépendre de l’offre, du pays et de l’espace de travail.

Ajouter à ChatGPT

Ouvre la fiche officielle de Running Workout dans ChatGPT : clique sur « Installer le plugin », puis autorise ton compte.

1

Ouvre la fiche Running Workout

Dans ChatGPT, ouvre Plugins dans la barre latérale (web, ordinateur ou mobile) et cherche Running Workout. Plus direct : le bouton « Ajouter à ChatGPT », à la fin de l’inscription ou dans tes Paramètres Running Workout, ouvre la fiche.
2

Installe le plugin

Clique sur « Installer le plugin ». S’il n’apparaît pas, l’installation n’est pas ouverte à ton offre, ton pays ou ton espace de travail : vois l’ajout manuel plus bas, ou passe par Claude.
3

Autorise l’accès

Si ChatGPT te le demande, clique sur « Connecter » : tu es redirigé vers runningworkout.fr pour valider l’autorisation. Rien d’autre à saisir.
4

Demande ta première séance

ChatGPT se sert de lui-même des plugins installés quand la demande s’y prête. Pour l’y inviter, tape @ puis choisis Running Workout.

Ajout manuel : Business, Enterprise et Edu

Sur le web, Plugins → bouton « + » → « Ajouter un serveur MCP personnalisé » : colle l’adresse du serveur sous Connexion, choisis OAuth, coche « Je comprends et souhaite continuer », puis « Créer en tant que plugin », et installe-le. Le mode développeur n’est plus nécessaire. Sur Business, seuls les administrateurs et propriétaires peuvent le faire ; sur Enterprise et Edu, aussi les membres autorisés par un administrateur. Sur ChatGPT Pro, un serveur ajouté ainsi reste en lecture seule.

Connecter avec Gemini

Aux États-Unis et en anglais, l’application Gemini accepte l’adresse du serveur (gemini.google.com, Settings, Connected Apps, Custom apps). Dans le terminal, Gemini CLI demande désormais une clé d’API Gemini payante ou une licence d’entreprise ; avec un compte Google gratuit, Google renvoie vers Antigravity CLI. Notre équipe n’a pas encore essayé l’application Gemini ni Antigravity CLI avec Running Workout. Les étapes ci-dessous valent pour Gemini CLI.

1

Ajoute le serveur

Dans ton terminal, avec Gemini CLI configuré sur ta clé d’API, lance la commande ci-dessous. Elle enregistre le serveur sous le nom running-workout.
2

Ou édite la configuration à la main

Dans ~/.gemini/settings.json, ajoute cette entrée sous mcpServers. L’option oauth activée suffit : Gemini découvre le reste tout seul. Avec Antigravity CLI, l’entrée va dans ~/.gemini/config/mcp_config.json, avec serverUrl à la place de httpUrl et sans ligne oauth.
3

Authentifie-toi

Tape /mcp auth running-workout dans Gemini CLI. L’autorisation s’ouvre dans ton navigateur, tu valides, et c’est terminé. Dans Antigravity CLI, /mcp ouvre le gestionnaire des serveurs, qui indique si running-workout est connecté.

gemini mcp add --transport http running-workout \
  https://www.runningworkout.fr/mcp

{
  "mcpServers": {
    "running-workout": {
      "httpUrl": "https://www.runningworkout.fr/mcp",
      "oauth": { "enabled": true }
    }
  }
}

Ce que ton assistant peut envoyer sur ta montre

Course, vélo ou natation en bassin : voici les cibles que tu peux demander, sport par sport, et comment les formuler en langage courant. Certaines viennent d’être ouvertes à de nouveaux sports ; d’autres restent propres à un seul.

infoÀ savoir

Ton assistant écrit directement dans ton compte Garmin Connect. Il ne devine rien : il utilise les valeurs de ton profil (FC max, VMA, FTP, CSS) pour traduire un pourcentage en valeur réelle. Si une de ces valeurs manque, il te le dit et n’envoie rien sur ta montre plutôt que d’inventer une cible — voir Tes données d’athlète.

Ce que tu peux demander	Natation	Comment le dire
Aucune cible (allure libre)		« 20 min en endurance libre »
Allure		« 3 km à 4:30/km »
Pourcentage de VMA		« 6 × 800 m à 95 % VMA »
Pourcentage de FC max	à vérifier	« 45 min entre 70 et 75 % de FC max »
Fréquence cardiaque en bpm	à vérifier	« 40 min entre 140 et 150 bpm »
Zone de fréquence cardiaque	à vérifier	« 1 h en zone 2 »
Puissance en watts		« 3 × 10 min à 220-230 W »
Zone de puissance		« 20 min en zone de puissance 4 »
Cadence	à vérifier	« en maintenant 90 rpm » · « à 180 pas/min »
Allure de nage (/100 m)		« 8 × 100 m à 1:45/100 m »
Décalage par rapport à ta CSS		« 6 × 200 m à CSS + 3 s »
Consigne d’intensité de nage (1-10)		« 4 × 50 m en descendant »
Deux cibles à la fois Vélo seulement. Garmin la refuse en course à pied (la cadence peut aller dans la description de l'étape). Impossible en natation, pour une raison de format : la montre ne réserve que deux emplacements de cible par étape, et le second est déjà occupé par la cible principale de la longueur (allure, CSS ou consigne).		« 3 × 8 min à 250 W en gardant 90 rpm »

Structure d’une séance

Cinq intensités possibles pour une étape : échauffement, actif, récupération, repos, retour au calme.
Des blocs de répétition, imbriqués jusqu’à 5 niveaux — par exemple « 3 × (5 × 200 m + 200 m de récup) avec 3 min entre les blocs ».
La durée d’une étape se donne en temps, en distance, ou reste libre (touche « lap » sur la montre).
Une séance peut être posée directement à une date de ton calendrier Garmin.

Ce que ton assistant peut lire

Symétrique de l’écriture, et souvent ignoré :

la liste de tes activités terminées, avec durée, distance, FC moyenne et maximale, allure, cadence, longueurs, dénivelé, calories ;
le détail d’une séance réalisée : résumé complet, puissance normalisée, cadence effective (zéros exclus), temps de mouvement, tours (jusqu’à 50), et en natation le détail longueur par longueur (temps, nage, nombre de coups, SWOLF) quand le fichier est disponible ;
ton profil d’athlète et ses métriques, avec l’origine de chaque valeur ;
tes notes ;
ton calendrier des séances planifiées.

Une asymétrie utile à connaître : les activités et les notes sont lues en local, sans appel à Garmin, donc instantanément. Le calendrier et l’écriture de séances, eux, passent par Garmin.

Course à pied

Toutes les cibles du tableau ci-dessus sont disponibles. Le pourcentage de VMA est traduit en allure réelle à partir de TA VMA au moment de l’envoi ; si tu la changes ensuite, les séances déjà envoyées ne bougent pas.

Vélo

La puissance s’exprime en watts absolus, jamais en pourcentage de FTP.

Une étape peut porter deux cibles à la fois — puissance et cadence, par exemple.

Export .zwo pour Zwift

Tes séances de vélo peuvent être exportées au format .zwo depuis le calendrier, pour Zwift et les applications compatibles. Point à connaître, car il produit des séances fausses sans qu’on s’en aperçoive : le .zwo n’accepte pas de watts, seulement un pourcentage d’une FTP de référence. Running Workout utilise une FTP de référence fixe de 160 W, inscrite dans la description de la séance. Cette valeur doit être identique au réglage de l’application qui lit le fichier, sinon toutes les cibles sont décalées du même pourcentage, silencieusement.

Natation en bassin

La longueur du bassin est obligatoire (25 m, 50 m, 25 yd…).

Les étapes se comptent en distance, jamais en temps — sauf les repos, qui sont en secondes.

Nage, éducatif et matériel peuvent être précisés à chaque étape :

Crawl · Dos · Brasse · Papillon · 4 nages · Nage au choix — Jambes · Bras — Plaquettes · Pull-buoy · Palmes · Planche · Tuba

Particularité de la montre, à connaître

Quand un bloc de répétition se termine par un repos, la montre saute ce dernier repos. Si tu veux une pause avant la série suivante, demande un repos explicite après le bloc.

Limites — dites clairement

Limite	Formulation
Calendrier	Une consultation du calendrier porte sur 62 jours au maximum.
Activités	100 activités par demande, au maximum.
Séances lisibles	Seules les séances créées via Running Workout peuvent être relues en détail ; celles construites directement dans Garmin Connect sont invisibles pour ton assistant.
Modification	On ne modifie pas une séance : on la supprime et on la recrée. Il n’existe pas de commande « modifier » — c’est un choix assumé, pas une limite provisoire.
Historique	Les activités antérieures à ta connexion n’existent que si tu as lancé un import.
Sports	Course, vélo et natation en bassin. Pas encore de musculation, de trail balisé ni de triathlon enchaîné.
Résolution des cibles	Un pourcentage (VMA, FC max) exige la valeur correspondante dans ton profil. Si elle manque, la séance n’est pas créée, et ton assistant t’explique quoi faire.

Mon assistant me dit qu’il ne connaît pas ma FC max.

C’est le comportement voulu : sans FC max déclarée, aucune cible en pourcentage de FC ne peut être traduite en valeur réelle, et ton assistant préfère te le dire plutôt que d’envoyer une séance fausse. Déclare-la en lui donnant le chiffre en conversation, ou demande directement une cible en bpm, qui ne dépend d’aucune donnée de profil.

Mon assistant ne voit pas mes activités récentes.

Les activités arrivent par notification Garmin, parfois avec quelques minutes de décalage. L’historique antérieur à ta connexion, lui, exige un import explicite depuis ton tableau de bord.

La séance est bien sur Garmin Connect mais pas sur ma montre.

C’est la synchronisation entre Garmin Connect et ta montre qui est en cause, indépendante de Running Workout — vérifie que ta montre s’est synchronisée récemment (Bluetooth ou Wi-Fi).

Mon assistant ne trouve pas une séance que j’ai créée dans Garmin Connect.

Seules les séances créées via Running Workout peuvent être relues en détail. Une séance construite à la main dans Garmin Connect n’a pas de copie locale à consulter.

Comment supprimer une séance de mon calendrier sans la perdre ?

Deux gestes différents : déplanifier retire la date sans toucher à la séance, qui reste dans ta bibliothèque Garmin ; supprimer efface la séance elle-même (et, avec elle, toutes ses dates planifiées).

Tes données d’athlète : d’où viennent tes chiffres

VMA, FTP, CSS, FC max : d’où viennent ces chiffres, qui peut les changer, comment corriger une valeur fausse, et comment lire leur historique.

Les origines d’une valeur

Origine	Ce que ça veut dire	Qui l’écrit
historycalculé	Estimée automatiquement, chaque semaine, à partir de tes activités.	Le système
verifiedtest	Valeur calculée depuis un test choisi explicitement	Toi, depuis le tableau de bord
auto_awesomeIA	Valeur déclarée via assistant IA	Ton assistant, avec ton accord
watchGarmin	Valeur héritée de votre montre Garmin	Ta montre, automatiquement

Règle de priorité

Dans cet ordre : une valeur vérifiée par test l’emporte toujours ; à défaut, une valeur que tu as déclarée à ton assistant ; à défaut, une valeur calculée automatiquement ; à défaut seulement, la valeur héritée de ta montre ou saisie dans les Paramètres. Une conséquence à connaître : une valeur déclarée un jour à ton assistant continue de l’emporter sur un import Garmin plus récent, tant que tu ne la corriges pas toi-même.

Poids, taille et quelques autres champs peuvent aussi être tapés directement dans Paramètres → Mon profil : ils portent alors le même badge « déclaré » que lorsque ton assistant les enregistre pour toi, par une porte différente.

Pourquoi ce mécanisme existe

Un calcul automatique balayait autrefois toutes les séances sans savoir laquelle était un test. Il a produit une FTP de 167 W sur un test en rampe, là où la bonne formule donnait 194 W : la moyenne sur 20 minutes lissait les premières minutes faciles de la rampe. Depuis, VMA, FTP et CSS ne sont plus estimées en tâche de fond : c’est toi qui désignes la séance de test, et le système applique la formule du bon protocole.

Déclarer un test — les trois protocoles

VMA (course)

Protocole	Quand l’utiliser	Formule
Effort continu	Test type demi-Cooper ou VAMEVAL, sur une séance à effort soutenu régulier.	Meilleure moyenne de vitesse sur 6 minutes glissantes.
Test progressif	Test par paliers croissants, jusqu’à l’épuisement.	Meilleure moyenne sur 60 secondes, dernière minute exclue.

Bornes de sécurité : 8 à 25 km/h. Hors bornes, le calcul est refusé et rien n’est enregistré.

Prérequis : l’activité doit avoir ses données détaillées (« GPS disponible » dans la liste).

FTP (vélo)

Protocole	Quand l’utiliser	Formule
Effort stable	Test classique de 20 minutes à intensité constante.	Meilleure moyenne de puissance sur 20 minutes × 95 %.
Rampe	Test en rampe (+20 W/min jusqu’à l’échec).	Meilleure moyenne sur 60 secondes × 75 %.

Bornes : 50 à 600 W.

Prérequis : capteur de puissance. Le système repère les tests en rampe à la forme en escalier de la puissance et pré-sélectionne le bon protocole — à toi de confirmer.

CSS (natation)

La vitesse critique de nage se déduit de deux efforts de distances différentes.

Protocole	Ce qu’il faut
Deux distances dans la même séance (privilégié)	Une séance en bassin contenant deux efforts (par exemple 200 m puis 400 m). Le système propose les tours ; tu en coches exactement deux.
Deux séances séparées (repli)	Deux séances complètes de distances différentes.

Formule : CSS = (distance₂ − distance₁) ÷ (durée₂ − durée₁), convertie en secondes/100 m. Contraintes : distances entre 150 et 800 m, écart d’au moins 100 m, l’effort le plus long doit prendre plus de temps. Bornes du résultat : 50 à 180 s/100 m.

La cohérence longueurs × longueur de bassin est aussi vérifiée, avec une tolérance de 15 %.

Depuis le tableau de bord

Clique sur l’icône « éprouvette » d’une tuile, choisis l’activité de test, lance le calcul. C’est le chemin recommandé : le résultat est déterministe et traçable jusqu’à l’activité source.

En parlant à ton assistant

« J’ai fait un test FTP hier, 210 W. » Il l’enregistre avec la mention « résultat de test annoncé par toi ».

En corrigeant un capteur

« Ma montre a compté 1 100 m mais j’ai nagé 1 000. » Enregistré avec la mention « correction capteur confirmée par toi ».

Ce que ton assistant n’a pas le droit de faire

Ton assistant ne peut jamais enregistrer une valeur qu’il aurait simplement déduite de ton profil. Il doit s’appuyer sur l’un de ces événements réels : tu lui as annoncé un résultat de test, il a repéré une incohérence de capteur que tu as confirmée, ou il t’a proposé une mise à jour et tu as dit oui. Chaque valeur enregistrée porte laquelle de ces trois raisons s’applique, et tu peux la relire.

FC max, FC repos et VO2max suivent un chemin différent : ta montre les transmet automatiquement (quand elle les mesure), sans que tu aies rien à demander. Tu peux aussi les taper toi-même dans Paramètres si ta montre ne les remonte pas.

Lire et nettoyer son historique

Un clic sur une tuile ouvre l’historique complet de la statistique : chaque valeur, sa date, son écart avec la précédente, son origine, sa méthode et sa note éventuelle.

Les valeurs déclarées et issues d’un test sont supprimables. Les valeurs calculées ne le sont pas : elles se régénèrent au recalcul suivant.

Recalculer

Met à jour les valeurs calculées à partir de tes activités actuelles.

Recalculer tout l’historique

Reconstruit toutes les valeurs calculées, semaine par semaine, jusqu’à 2 ans en arrière. À utiliser après un import massif ou une correction de formule. Tes tests et tes déclarations ne sont jamais touchés.

Les autres données

Donnée	Où la renseigner	À quoi elle sert
Prénom	Paramètres → Mon profil	Personnalisation
Email (facultatif)	Paramètres → Mon profil	Sert uniquement à te recontacter si besoin (par exemple un incident sur ton compte) ; jamais transmis à un tiers ni utilisé pour du démarchage.
Sexe, âge	Paramètres → Mon profil	Estimations physiologiques
Poids	Paramètres → Mon profil	Indispensable au calcul des watts/kg
Sports suivis	Paramètres → Mes sports	Filtre l’affichage du tableau de bord. Les données des sports décochés continuent d’être calculées, elles sont seulement masquées.
FC max, FC repos, VO2max	Héritées automatiquement de ta montre Garmin (si elle les mesure), ou déclarées dans Paramètres à défaut	Traduisent les pourcentages de FC en bpm et affinent le calcul de charge. Limite honnête à connaître : le VO2max n’a pas d’historique récupérable — seules les valeurs mesurées après ta connexion apparaissent, jamais celles d’avant.
Langue	Sélecteur d’en-tête	Ton assistant écrit le nom et la description de tes séances dans cette langue

Volume, charge et ACWR

Volume : durée totale d’entraînement sur 30 jours, tous sports confondus.
Charge (TRIMP) : durée pondérée par l’intensité cardiaque.
ACWR : rapport entre ta charge des 7 derniers jours et ta charge moyenne des 42 derniers.

Valeur	Couleur	Lecture
< 0.8		Charge en baisse — affûtage, ou coupure
0.8 – 1.3		Zone de progression
1.3 – 1.5		Montée rapide, vigilance
> 1.5		Montée trop rapide, risque de blessure accru

⚠ Ce sont des indicateurs d’entraînement, pas un avis médical.

Pourquoi le calcul automatique ne recalcule-t-il plus ma VMA, ma FTP ou ma CSS ?

Parce qu’un scan automatique s’est déjà trompé (voir « Pourquoi ce mécanisme existe » ci-dessus). Ces trois valeurs ne sont désormais calculées que sur une activité que tu désignes toi-même comme un test, avec la formule du bon protocole — jamais en tâche de fond.

Vérifier que ça marche

Pose ces deux questions à ton assistant. La première lit tes données, la seconde écrit sur ta montre.

« Liste mes 3 dernières activités »

Tu dois voir tes vraies séances, avec durée, distance et fréquence cardiaque.

« Crée-moi 8×400 m à 95 % VMA pour jeudi »

La séance apparaît dans Garmin Connect et sur ta montre, planifiée au bon jour.

check_circle Si ces deux demandes fonctionnent, tout est en place.

Si ça ne marche pas

Mon assistant ne voit aucun outil, que faire ?

Le connecteur ou le plugin est peut-être désactivé dans la conversation en cours. Chez Claude, ouvre le menu « + », survole « Connecteurs » et active Running Workout ; chez ChatGPT, tape @ et choisis Running Workout. Pense aussi à démarrer une nouvelle conversation après l’ajout.

Le bouton « Installer le plugin » n’apparaît pas dans ChatGPT

D’après OpenAI, l’installation d’un plugin dépend de l’offre, du pays et de l’espace de travail. Dans un espace de travail, demande à un administrateur de vérifier que le plugin est autorisé. Sur Business, Enterprise ou Edu, l’ajout manuel du serveur reste possible (voir plus haut) ; sinon, Claude accepte Running Workout sur toutes ses offres.

L’autorisation échoue ou tourne en boucle

Connecte-toi d’abord sur runningworkout.fr et vérifie que ton compte Garmin est bien relié. L’écran d’autorisation a besoin d’une session active pour savoir à quel athlète rattacher l’assistant.

Comment retirer l’accès à un assistant ?

Dans les Paramètres de Running Workout, section « Assistants connectés » : chaque autorisation se révoque séparément avec « Révoquer », et l’accès est coupé immédiatement.

Prêt à essayer ?

Connecte ta montre, branche ton assistant, et demande-lui ta première séance.

watch Connecter Garmin — gratuit pour commencer

Ressources

Ce qu'il faut savoir pour faire écrire vos séances par une IA : ce que permet l'API Garmin, ce que valent les serveurs MCP existants, et les cibles propres à chaque sport.

Connecter ton assistant IA à ta montre Garmin

C’est quoi, un serveur MCP ?

Avant de commencer

Crée ton compte et connecte Garmin

Garde l’adresse du serveur sous la main

Choisis ton assistant

Connecter avec Claude

Ouvre la fiche Running Workout

Connecte-toi

Demande ta première séance

Voie de secours : connecteur personnalisé

Dans le terminal, avec Claude Code

Connecter avec ChatGPT

Ouvre la fiche Running Workout

Installe le plugin

Autorise l’accès