connecteur pour Claude

Guide d'utilisation du connecteur Claude de GeneTrainer

Projet — à valider par un DPO / juriste avant publication (les parties qui touchent aux données, au consentement et au rôle du club).

Version : 2026-10-01 (projet). Les passages entre crochets […] sont à compléter. Version anglaise : user-guide.en.md. Politique de confidentialité : privacy-policy.fr.md.

1. À quoi sert le connecteur

Le connecteur GeneTrainer relie Claude (claude.ai, Claude Desktop, application mobile Claude, Claude Code) à votre compte GeneTrainer. Vous posez une question en langage naturel (« Qui est dispo samedi ? »), Claude interroge GeneTrainer en votre nom et vous répond à partir des données de vos équipes.

2. Avant de commencer

  1. Vous êtes membre du staff d'une équipe GeneTrainer (profil staff, technique ou management).
  2. Vous vous êtes déjà connecté à GeneTrainer (web ou mobile) avec votre compte : c'est cette première connexion qui lie votre compte au connecteur.
  3. Le club a activé le partage pour l'équipe : un responsable (profil Management) doit avoir activé « Partage avec les assistants IA » (voir la section 9).
  4. Vous utilisez Claude avec un abonnement professionnel (Team ou Enterprise). C'est une condition d'usage, écrite dans les conditions du partage du club (« requis pour chaque membre du staff qui connecte Claude »). La page de confirmation ne vous demande pas de l'attester, et GeneTrainer ne peut pas vérifier votre abonnement : c'est votre engagement et celui de votre club. Les abonnements individuels (Free, Pro, Max) ne conviennent pas à des données de santé d'athlètes.
  5. Pour les données médicales seulement : une permission GeneTrainer sur l'équipe (« Médical » pour les blessures, « Notes médicales » pour les notes, niveau Lecture ou Complet), la case du club, et votre consentement médical sur la page d'attestation.

3. Se connecter

Les intitulés de l'interface de Claude sont ceux de la documentation d'Anthropic ; ils peuvent varier d'une version à l'autre. L'adresse du connecteur est https://mcp.genetrainer.com/mcp (en https, sans barre oblique à la fin).

3.1 Dans claude.ai, Claude Desktop et l'application mobile

Abonnement Team ou Enterprise (cas normal)

  1. Un Owner de votre organisation Claude ajoute le connecteur pour toute l'organisation : Organization settings > Connectors > Add > Custom (choisir Web si Claude demande le type), saisir l'adresse ci-dessus (nom : GeneTrainer), laisser les réglages d'authentification par défaut (Use Claude's published identity quand il est proposé), puis Add.
  2. Chaque membre se connecte avec son propre compte : Customize > Connectors, repérer GeneTrainer (étiquette Custom), cliquer sur Connect.
  3. Connectez-vous avec vos identifiants GeneTrainer (la page de connexion est celle de GeneTrainer).
  4. Lisez et validez la page « Utilisation des données GeneTrainer » (section 3.3).
  5. Lors de la première connexion, un écran d'autorisation vous demande d'accepter « Lire les données de vos équipes auxquelles vous avez accès dans GeneTrainer » (le seul droit demandé : la lecture). Acceptez.
  6. De retour dans Claude, le connecteur est Connected.

Quand le connecteur sera dans l'annuaire des connecteurs de Claude [à confirmer après la soumission] : Customize > Connectors > Discover, rechercher « GeneTrainer », puis Connect to Claude. Sur un abonnement Team ou Enterprise, un Owner doit d'abord l'ajouter pour l'organisation ; sinon vous pouvez le lui demander (Request).

3.2 Dans Claude Code

claude mcp add --transport http genetrainer https://mcp.genetrainer.com/mcp
claude mcp list

Dans une session Claude Code, tapez /mcp, choisissez genetrainer puis authentifiez-vous : le navigateur s'ouvre sur la connexion GeneTrainer, puis sur la page « Utilisation des données GeneTrainer ». Connectez Claude Code avec le compte de votre organisation (Team ou Enterprise), pas avec un compte personnel. Pour retirer le connecteur : claude mcp remove genetrainer.

3.3 La page « Utilisation des données GeneTrainer »

Cette page s'affiche à chaque connexion depuis Claude (première connexion et reconnexions), pas pendant le renouvellement silencieux de votre accès. Elle est en français, en anglais ou en italien (la langue de votre profil GeneTrainer, sinon celle de votre navigateur).

Elle dit : « Vous connectez Claude à votre compte GeneTrainer. Lisez et confirmez ce qui suit avant de continuer. » Puis, sous « En continuant, je confirme que : » :

Vous devez cocher « J'ai lu et je confirme ces engagements. » pour continuer. La page ne vous interroge pas sur votre abonnement Claude, qui reste pourtant requis (section 2, point 4).

Consentement médical. Si vous avez, dans au moins une de vos équipes, un droit médical (permission « Médical » ou « Notes médicales »), la page affiche en plus une case : « J'autorise Claude à lire les données médicales auxquelles j'ai accès », accompagnée de : « Facultatif. Laissez cette case décochée et Claude ne lira aucune donnée médicale en votre nom. »

Cliquez sur « Accepter et continuer ». Si vous n'attendiez pas cette demande, fermez la page : rien ne sera modifié. Le lien de la page est à usage unique et valable 15 minutes. Cette attestation ne transfère pas la responsabilité du traitement : le club en reste responsable.

3.4 Vérifier que ça marche

Dans une conversation, activez le connecteur (+ > Connectors, interrupteur de GeneTrainer), puis demandez : « Quelles équipes puis-je interroger avec GeneTrainer ? ». Claude utilise l'outil list_my_teams : il liste vos équipes et indique pour chacune si le club a activé le partage.

3.5 Utiliser le connecteur dans une conversation

4. Ce que vous pouvez demander

Claude choisit les outils lui-même : il suffit de poser votre question. Les noms d'outils ci-dessous sont ceux que vous voyez apparaître dans Claude.

4.1 Huit questions pour commencer

Question Outils généralement utilisés (Claude choisit lui-même) Catégories de données nécessaires
« Qui est dispo samedi ? » get_availability, get_calendar Disponibilité, Organisation
« Qui est en alerte wellness ce matin ? » get_wellness_alerts Questions
« Comment a évolué la charge des milieux sur 4 semaines ? » get_team_roster, query_metric Performance, Organisation
« Compare les distances à haute intensité sur le dernier match. » get_calendar, list_metrics, query_metric Performance, Organisation
« Qui a perdu plus de 2 kg ce mois-ci ? » query_metric Performance
« Résume la séance de mardi. » get_calendar, get_session_details Organisation (et Questions, Performance pour le RPE et le GPS de la séance)
« Fais-moi le point sur X avant le match. » get_team_roster, get_athlete_overview Plusieurs, filtrées champ par champ
« Qui a le plus joué sur les 5 derniers matchs, et qui a été titulaire ? » query_metric Performance

4.2 Exemples par outil

Outil Ce qu'il fait Exemples
list_my_teams Liste vos équipes (où vous êtes staff) et l'état du partage « Quelles équipes puis-je interroger ? »
get_team_roster Effectif actuel, postes, groupes de postes, groupes d'entraînement (et téléphone, e-mail si le club partage les Coordonnées) « Qui est dans l'effectif ? », « Quels sont les groupes d'entraînement ? »
list_metrics Catalogue des indicateurs de l'équipe (questions, GPS, charge, corps, tests, musculation, temps de jeu) « Quelles données peux-tu analyser pour mon équipe ? »
query_metric Interroge un indicateur : dernière valeur, résumé, évolution, variation, classement, répartition, pour l'équipe, un groupe de postes, un groupe d'entraînement ou jusqu'à 30 athlètes « Classe les athlètes par minutes jouées sur les 5 derniers matchs », « Qui a répondu le plus bas à la question sommeil cette semaine ? », « Évolution du tonnage de musculation du groupe sur 6 semaines »
get_wellness_alerts Alertes wellness d'un jour (ou jusqu'à 14 jours) : celles des règles dont vous êtes destinataire et les alertes de bandes de couleur « Alertes wellness de la semaine ? »
get_calendar Séances d'une période : type, horaire, titre, groupes, participants (sans notes privées du staff) « Que contient le calendrier de la semaine prochaine ? », « Quel est le prochain match ? »
get_session_details Une séance : contenu, participants, présence, RPE, GPS rattaché « Détaille la séance de mardi : qui était présent, quel RPE ? »
get_athlete_overview Point sur un athlète : disponibilité, dernières réponses wellness, charge sur 7 et 28 jours, poids, derniers tests « Fais-moi le point sur [nom] »
get_availability Statut de disponibilité par athlète pour un jour : disponible, en reprise, indisponible (sans diagnostic) ; pour un jour à venir, d'après les dates déjà saisies « Combien d'indisponibles vendredi ? »
get_injury_details Blessures et notes médicales d'un athlète ou de l'équipe (trois verrous, section 5) « Quelles blessures sont ouvertes et dans quelle phase ? », « Y a-t-il une note médicale récente sur [nom] ? »

Données médicales et décisions. Ce que renvoient get_injury_details et les autres outils est une aide à la décision, pas un avis médical. Le connecteur renvoie des données saisies dans GeneTrainer ; il ne pose pas de diagnostic et ne recommande aucun traitement. Claude, un assistant d'IA, résume ces données, et une réponse peut être incomplète ou erronée (voir la section 4.3). Les décisions concernant la santé d'un athlète, comme le diagnostic, le traitement ou la reprise, restent du ressort du personnel qualifié du club ; la référence est la donnée dans GeneTrainer, pas le résumé qu'en fait Claude.

4.3 Pour de bonnes réponses

4.4 Pourquoi un chiffre peut différer d'un écran de GeneTrainer

Ces écarts sont voulus : le connecteur reprend ce que l'écran affiche, avec le choix le plus strict pour la confidentialité.

5. Ce que Claude ne peut pas voir

Ce qui reste hors de portée Détail
Liste rouge : jamais, quel que soit le réglage Pièces d'identité (y compris carte de santé et carte européenne d'arme à feu), armes, numéro de sécurité sociale, adresse postale, contacts de l'athlète (y compris ses parents), question et suivi du cycle menstruel.
Non exporté dans cette version Date de naissance, sexe, nationalité, numéro de licence, type de contrat, fréquence cardiaque maximale.
Texte libre des athlètes Commentaires de questionnaire, questions « texte libre », signalement libre d'une blessure, notes de réalisation des séances.
Réservé au staff Questions remplies par le staff, entretiens, notes privées du staff dans le calendrier.
Personnes Anciens joueurs, staff, athlètes d'autres équipes ; équipes dont vous n'êtes pas membre du staff.
Groupes Groupes d'entraînement privés d'un autre utilisateur, archivés ou « intelligents ».
Catégories non cochées par le club Coordonnées, médical par défaut, ou tout ce que le club a décoché.
Médical sans les trois verrous Pas de permission GeneTrainer, case du club non cochée, ou consentement médical non donné.

Les libellés écrits par le staff (titres de séance, noms de groupe, intitulés de question) sont transmis tels quels : évitez d'y mettre des informations de santé.

6. Limites

60 appels par minute et 2 000 par jour et par utilisateur ; 10 secondes de calcul par requête ; 30 athlètes par liste ; 365 jours au plus (14 jours pour les alertes wellness, 62 jours pour le calendrier) ; 60 lignes et 50 Ko par réponse (une réponse trop grosse est refusée, jamais coupée en silence). Au plus 4 appels en même temps par personne : Claude en lance parfois plusieurs d'un coup, les suivants sont refusés quelques secondes (rate_limited) et Claude peut les relancer.

7. Dépannage

Les messages d'erreur sont rédigés en anglais pour Claude, qui vous les explique dans votre langue. Voici ce qu'ils veulent dire.

7.1 Par code d'erreur

Accès

Code Ce que cela veut dire Que faire
account_not_linked Aucun compte GeneTrainer n'est lié à cette connexion (ou aucun jeton n'est arrivé avec l'appel). Connectez-vous une fois à GeneTrainer (web ou mobile) avec le même identifiant que dans Claude, puis déconnectez et reconnectez le connecteur. Si cela persiste, contactez le support.
terms_not_accepted Les conditions d'utilisation des données n'ont pas été acceptées pour cette connexion, ou leur texte a changé. Déconnectez puis reconnectez le connecteur dans Claude et validez la page « Utilisation des données GeneTrainer ».
team_not_found « Équipe introuvable » : l'équipe n'existe pas, ou vous n'en êtes pas membre du staff. La réponse est la même dans tous les cas, volontairement. Demandez à Claude de lister vos équipes et vérifiez l'équipe demandée. Si vous devriez y avoir accès, demandez à un responsable de l'équipe de vérifier votre profil.
connector_disabled_by_club Le club n'a pas activé le partage avec les assistants IA pour cette équipe, ou n'a pas encore accepté les conditions de partage mises à jour. Demandez à un responsable de l'équipe (profil Management) de l'activer ou d'accepter les conditions mises à jour (section 9).
category_not_shared Le club ne partage pas avec Claude la catégorie de données dont cette réponse a besoin. Un responsable peut cocher la catégorie dans le même panneau (section 9).
medical_permission_required Votre compte GeneTrainer n'a pas, sur cette équipe, la permission requise pour ces données médicales. Demandez à un responsable de vous accorder « Médical » (blessures) ou « Notes médicales » (notes), niveau Lecture ou Complet.
medical_consent_required Vous n'avez pas donné le consentement médical à votre dernière connexion. Déconnectez et reconnectez le connecteur, puis cochez « J'autorise Claude à lire les données médicales auxquelles j'ai accès ».
athlete_not_in_roster Un ou plusieurs athlètes demandés ne sont pas dans l'effectif actuel de l'équipe (ancien joueur, autre équipe, identifiant erroné). Demandez à Claude de relire l'effectif, puis reposez la question.

Requête

Code Ce que cela veut dire Que faire
unknown_metric L'indicateur demandé n'existe pas pour cette équipe. Demandez la liste des indicateurs disponibles.
unsupported_analysis L'indicateur n'accepte pas ce type d'analyse (par exemple un classement sur une question à choix). Reformulez : dernière valeur, évolution, répartition…
invalid_params Un paramètre n'est pas valide (le message nomme le champ) : équipe à préciser quand plusieurs sont actives, liste de plus de 30 athlètes, date mal écrite, réponse trop volumineuse… Précisez ou réduisez la question (une période ou un groupe plus petit).
period_out_of_range La période dépasse 365 jours (14 jours pour les alertes wellness, 62 jours pour le calendrier). Choisissez une période plus courte.
query_timeout Le calcul a pris plus de 10 secondes et a été interrompu. Réduisez la période ou le groupe d'athlètes.

Service

Code Ce que cela veut dire Que faire
rate_limited Trop d'appels (60 par minute, 2 000 par jour), plus de 4 appels en même temps, service momentanément saturé, ou compteur indisponible. Attendez le délai indiqué dans le message, puis réessayez. Une question moins large évite les rafales d'appels.
internal_error Erreur inattendue chez GeneTrainer. Le message donne une référence. Réessayez. Si cela persiste, contactez le support avec la référence et l'heure.

7.2 Problèmes de connexion

Ce que vous voyez Cause probable Que faire
Claude affiche « Couldn't reach the MCP server » ou « Authorization with the MCP server failed » Mauvaise adresse, ou connexion interrompue Vérifiez que l'adresse est exactement https://mcp.genetrainer.com/mcp, déconnectez et reconnectez ; sinon contactez le support avec l'heure et la référence ofid_… visible dans l'adresse de la page d'erreur de Claude (elle expire vite).
« Unexpected error while invoking tool » La connexion est bonne mais un outil a échoué Réessayez ; sinon support, avec le nom de l'outil et l'heure.
Page « Lien déjà utilisé » ou « Lien invalide » Le lien de la page d'attestation est à usage unique et dure 15 minutes Relancez la connexion depuis Claude.
Page « Compte introuvable » Aucun compte GeneTrainer n'est lié à ce login Connectez-vous une fois à GeneTrainer, puis relancez la connexion depuis Claude.
Page « Erreur » Incident côté GeneTrainer Relancez la connexion ; sinon support.
Le connecteur est refusé avec un message « service désactivé » (HTTP 503) GeneTrainer a suspendu le connecteur (maintenance ou incident) Réessayez plus tard.
GeneTrainer n'apparaît pas dans votre liste de connecteurs (Team ou Enterprise) Un Owner ne l'a pas encore ajouté pour l'organisation Demandez à un Owner (section 3.1).
La page de connexion revient en boucle Connexion mal terminée Déconnectez le connecteur (section 10) et reconnectez-le.

8. Questions fréquentes

Claude peut-il modifier mes données GeneTrainer ? Non. Tous les outils sont en lecture seule.

GeneTrainer conserve-t-il mes questions et les réponses ? Non : GeneTrainer ne reçoit pas votre conversation et ne conserve pas les données renvoyées à Claude. Il enregistre un journal d'audit pendant 12 mois : qui, quand, quelle équipe, quels athlètes, quelles catégories, et les paramètres de l'appel choisis par Claude (équipe, indicateur, période…), sans les données elles-mêmes.

Qu'advient-il des données dans Claude ? Elles font partie de la conversation de votre compte Claude et dépendent de votre abonnement et des réglages de votre organisation (conservation, partage de conversations). Voir la politique de confidentialité, section 7.

Un athlète peut-il utiliser le connecteur ? Non : il est réservé au staff.

Un athlète peut-il demander à ne pas apparaître ? Dans cette version, le connecteur ne permet pas d'exclure un athlète en particulier. Le club traite cette demande autrement (voir la politique de confidentialité, section 11).

9. Pour le club : activer ou désactiver le partage

Le partage est désactivé par défaut pour chaque équipe. Il se règle équipe par équipe.

Où. Paramètres > Général > Partage avec les assistants IA. Tous les membres du staff de l'équipe peuvent lire ce panneau ; seuls le profil Management de l'équipe et les administrateurs GeneTrainer peuvent le modifier.

Activer.

  1. Activez « Autoriser le partage des données de l'équipe avec les assistants IA ».
  2. Sous « Données partagées », cochez les catégories que le club accepte de partager. Organisation est toujours incluse ; les autres sont Coordonnées, Performance, Questions, Disponibilité, Médical — blessures et Médical — notes. Par défaut : Performance, Questions et Disponibilité sont cochées ; Coordonnées et les deux catégories médicales sont décochées.
  3. Lisez « Conditions du partage » (la version est affichée) : le club reste responsable du traitement et GeneTrainer sous-traitant, les données sont transmises à Anthropic par le compte Claude de chaque membre du staff (y compris des données de santé si les catégories médicales sont cochées), un abonnement Claude professionnel (Team ou Enterprise) est requis pour chaque membre du staff qui connecte Claude, chaque membre du staff confirme à chaque connexion les engagements d'usage des données, chaque consultation est enregistrée.
  4. Cochez « J'accepte ces conditions au nom du club » (demandé à la première activation, à la réactivation et quand les conditions changent), puis Enregistrer. Tant qu'un responsable n'a pas accepté les conditions mises à jour, le connecteur refuse les appels pour l'équipe (connector_disabled_by_club).

Désactiver, ou changer les catégories. Décochez ou désactivez, puis Enregistrer. L'effet est immédiat : les droits et les réglages sont relus à chaque appel, sans attendre l'expiration d'un jeton. Désactiver puis réactiver le partage redemande d'accepter les conditions au nom du club.

Données médicales. Les deux catégories médicales sont des données de santé et sont décochées par défaut. Pour qu'un membre du staff y accède, il faut en plus : la permission « Médical » ou « Notes médicales » (niveau Lecture ou Complet) dans l'éditeur de droits de GeneTrainer, et son consentement personnel à chaque connexion. Les notes marquées comme restreintes, ou dont la restriction n'est pas renseignée, exigent le niveau Complet de « Notes médicales ».

Suivi. Le panneau affiche la dernière modification (date et auteur). Chaque changement est conservé dans un historique : c'est l'instruction écrite du club.

Avant d'activer. Le kit juridique remis aux clubs (legal-kit) aide à informer les athlètes (et les parents des mineurs), à faire l'analyse d'impact et à cadrer l'usage de Claude. Les catégories médicales ne devraient être cochées qu'après cette analyse et après confirmation écrite d'Anthropic que les données de santé sont couvertes par son contrat.

10. Se déconnecter

Votre accès (jeton) expire de toute façon : une heure pour le jeton d'accès, 30 jours d'inactivité pour son renouvellement. Les enregistrements d'attestation et le journal d'audit sont conservés selon la politique de confidentialité, section 9.

11. Aide et contact