Le MCP et l’API FITsociety permettent de connecter votre compte à un assistant IA comme Claude. Vous gérez ensuite votre travail en langage courant : vous saisissez ce dont vous avez besoin et l’assistant le fait pour vous dans FITsociety.
Cet article explique :
ce que sont une API et un MCP
ce que vous pouvez en faire
comment configurer la connexion
comment créer pas à pas un programme d’entraînement et un plan alimentaire
ce qui n’est pas encore possible et les réponses aux questions fréquentes
Cet article s’adresse aux coachs et propriétaires de salles utilisant FITsociety. Aucune connaissance technique n’est nécessaire.
Que sont une API et un MCP ?
L’API est la porte d’entrée de FITsociety et le MCP est le mode d’emploi permettant à un assistant IA de la franchir.
API
API signifie Application Programming Interface. C’est une méthode définie permettant à deux logiciels de communiquer. Comme au restaurant : vous n’entrez pas en cuisine, vous commandez au serveur. Il sait ce que la cuisine peut préparer et vous apporte le résultat.
L’API FITsociety fonctionne ainsi. D’autres logiciels peuvent demander des données ou effectuer des modifications, comme rechercher un membre ou ajouter un programme, selon des règles définies et uniquement avec les droits que vous accordez.
MCP
MCP signifie Model Context Protocol. Cette norme ouverte permet aux assistants IA comme Claude de travailler de manière sécurisée avec d’autres logiciels. Le MCP indique les actions possibles dans FITsociety, comme rechercher un membre, créer un plan alimentaire ou envoyer un message, et leur mode d’utilisation.
Sans MCP, un assistant IA peut seulement discuter et conseiller. Avec le MCP, il peut réellement agir pour vous dans votre compte FITsociety.
Comment fonctionnent-ils ensemble ?
Vous saisissez une question ou une instruction en langage courant dans votre assistant IA.
L’assistant détermine les actions nécessaires dans FITsociety.
Il les effectue via le MCP dans votre compte, dans les limites des droits accordés.
Il présente ce qu’il a trouvé ou réalisé. Vous vérifiez et corrigez si nécessaire.
Comment l’utiliser ?
Le MCP permet à votre assistant d’effectuer la majeure partie de votre travail quotidien de coach dans FITsociety. Les fonctions accessibles dépendent des modules de votre compte.
Module | Actions de l’assistant | Exemple de demande |
Membres | Rechercher et créer des membres, consulter profils, objectifs, mesures, questionnaires initiaux et bilans, tenir des notes | « Quels sont les objectifs de Sanne et comment ses mesures ont-elles évolué ? » |
Entraînement | Créer, modifier, dupliquer et attribuer des exercices, programmes et WOD ; consulter les séances et performances | « Crée un programme corps entier pour débutants de 3 jours par semaine. » |
Nutrition | Créer et modifier plans alimentaires, recettes et compléments, définir des objectifs nutritionnels, consulter la consommation et rechercher des produits | « Quelle quantité moyenne de protéines Mark a-t-il consommée cette semaine ? » |
Habitudes | Créer des modèles d’habitudes, les associer aux membres et suivre la progression | « Associe l’habitude “8.000 pas quotidiens” à Sanne. » |
Agenda et réservations | Consulter et planifier cours, rendez-vous et tâches, effectuer des réservations et mettre à jour les présences | « Qui est inscrit au bootcamp de jeudi ? » |
Messages | Lire les conversations des membres et envoyer des messages | « Envoie un message à Mark pour lui dire que son nouveau programme est prêt. » |
Aperçus | Résumer le respect des plans par les membres, les réservations, abonnements, factures et crédits | « Quels membres ont réalisé moins de la moitié de leurs entraînements ce mois-ci ? » |
Vous pouvez combiner plusieurs étapes : « Recherche Sanne, crée un programme à partir de son questionnaire initial, attribue-le-lui et préviens-la par message. »
Sécurité : vous gardez le contrôle
La connexion ne dispose jamais de plus de droits que vous dans FITsociety, et vous définissez ses autorisations.
Uniquement votre compte. L’assistant travaille uniquement dans votre compte et l’entreprise associée à la connexion. Les données des autres entreprises ne sont jamais visibles.
Uniquement vos modules. Si vous n’avez pas un module, comme Nutrition, l’assistant ne peut pas non plus l’utiliser.
Consentement des membres. Les données des membres sont accessibles uniquement dans le cadre de leur consentement. Sans celui-ci, l’assistant ne peut pas les consulter.
Lecture et modification séparées. Vous choisissez si une connexion peut seulement consulter ou aussi créer et modifier. Les modifications exigent les droits correspondants que vous accordez.
Vous restez le coach. Un assistant IA peut se tromper. Vérifiez toujours ses propositions ou créations avant de les partager avec un membre, particulièrement pour l’alimentation et l’entraînement en cas de blessure, grossesse ou problème médical.
Conseil : commencez avec la lecture seule pour découvrir ses possibilités sans modifier les données. Activez ensuite l’écriture lorsque vous maîtrisez son fonctionnement.
Configurer la connexion
La connexion prend quelques minutes. Vous avez besoin d’un assistant prenant en charge MCP, comme Claude.
Disponibilité : le MCP sera accessible à tous après le webinaire du 6 novembre. Pour l’utiliser dès maintenant, envoyez-nous un message afin que nous l’activions dans votre compte.
Étape 1 : ouvrir la page MCP dans FITsociety
Ouvrez la page MCP dans FITsociety. Sous Informations de connexion vous trouverez l’endpoint, l’adresse web de la connexion, et un exemple de configuration à copier. La page n’apparaît pas ? Le MCP n’est pas encore activé dans votre compte. Contactez-nous pour obtenir de l’aide.
Étape 2 : créer une clé et choisir les droits
Sur la même page, créez une clé ou jeton et choisissez ses autorisations :
Lecture seule : l’assistant peut consulter et résumer les données sans les modifier.
Lecture et écriture : il peut aussi créer et modifier programmes, plans, notes, messages et rendez-vous.
Copiez la clé et conservez-la en sécurité. Ne la partagez avec personne : son détenteur peut accéder à votre compte avec les droits choisis.
Étape 3 : ajouter la connexion à l’assistant IA
Ajoutez une nouvelle connexion MCP dans votre assistant :
Donnez-lui un nom reconnaissable, par exemple FITsociety.
Collez l’endpoint de l’étape 1 comme adresse. Choisissez le type de connexion Streamable HTTP si l’assistant le demande.
Ajoutez votre clé selon l’exemple de configuration FITsociety, en remplaçant le texte provisoire par votre clé.
Enregistrez et laissez l’assistant récupérer les actions disponibles.
Étape 4 : tester la connexion
Posez une question simple, comme « Quels sont mes membres dans FITsociety ? » ou « Que contient mon agenda aujourd’hui ? ». Si la réponse contient vos données, la connexion fonctionne.
Cela ne fonctionne pas ? Vérifiez que la clé est copiée intégralement, que la connexion est activée dans l’assistant et que le MCP est activé dans votre compte.
Révoquer une clé
Pour interrompre l’accès, par exemple après une fuite de clé ou un changement d’assistant, révoquez la clé sur la page MCP FITsociety. La connexion cesse immédiatement de fonctionner.
Exemple : créer un programme d’entraînement
Cet exemple crée et attribue un programme de musculation à une nouvelle membre, Sanne. Une connexion avec droits d’écriture est nécessaire.
Étape 1 : présenter le membre à l’assistant
Commencez par une question pour fournir les bonnes informations :
Recherche Sanne de Vries dans FITsociety. Résume son questionnaire initial, ses objectifs et ses éventuelles blessures.
L’assistant recherche Sanne et résume ses informations et objectifs. Corrigez ou complétez les éléments dans votre message suivant si nécessaire.
Étape 2 : demander une proposition
Décrivez précisément ce que vous souhaitez :
Propose un programme pour Sanne : 3 jours par semaine, objectif force, environ 60 minutes par séance. Elle s’entraîne en salle avec des poids libres et des machines. Tiens compte de ses douleurs au genou. Utilise les exercices de ma bibliothèque. Ne crée encore rien, montre d’abord la proposition.
L’assistant présente les exercices proposés par jour, avec séries, répétitions et repos.
Étape 3 : ajuster
Modifiez la proposition en langage courant, autant que nécessaire :
Remplace les fentes par des step-ups et ajoute un exercice de gainage au jour 2. Définis le repos des exercices polyarticulaires à 2 minutes.
Étape 4 : créer et attribuer le programme
La proposition vous convient ? Demandez son ajout dans FITsociety :
Cela me convient. Crée ce programme dans FITsociety et attribue-le à Sanne à partir de lundi.
L’assistant crée le programme, remplit les jours avec les exercices et l’attribue à Sanne. Il vous prévient une fois terminé.
Étape 5 : vérifier et prévenir
Ouvrez le programme dans FITsociety et vérifiez-le. Vous pouvez ensuite demander l’envoi d’un message :
Préviens Sanne que son nouveau programme est prêt dans l’application et qu’elle peut poser toutes ses questions.
Conseil : vous utilisez souvent le même type de programme ? Demandez de l’enregistrer comme modèle. Dites ensuite, par exemple : « Duplique mon modèle “Force débutants 3x” pour Mark et adapte-le pour une personne sans douleur au genou. »
Exemple : créer un plan alimentaire
Cet exemple crée un plan pour Mark, qui souhaite perdre du poids tout en préservant sa masse musculaire. Le module Nutrition et des droits d’écriture sont nécessaires.
Étape 1 : établir la situation de départ
Recherche Mark Jansen. Quels sont ses objectifs, son poids actuel et ses objectifs nutritionnels ? Et qu’a-t-il consommé en moyenne la semaine dernière ?
L’assistant récupère ses objectifs, mesures et cibles nutritionnelles, puis résume la consommation enregistrée. Vous repérez immédiatement les principales possibilités d’amélioration.
Étape 2 : définir les objectifs nutritionnels
Déterminez les objectifs ou faites vérifier une proposition de l’assistant :
Définis ces objectifs quotidiens pour Mark : 2.200 kcal, 170 grammes de protéines, 220 grammes de glucides et 70 grammes de lipides.
Étape 3 : demander une proposition de plan
Propose un plan alimentaire adapté aux objectifs de Mark : petit-déjeuner, déjeuner, dîner et deux collations. Il ne mange pas de poisson et a peu de temps pour cuisiner ; reste simple. Utilise si possible mes recettes. Ne crée encore rien.
L’assistant présente chaque repas avec les quantités et les totaux quotidiens de calories et macronutriments.
Étape 4 : ajuster
Remplace le fromage blanc du petit-déjeuner par des flocons d’avoine avec de la whey et prévois un déjeuner transportable les jours de travail. Les protéines restent-elles correctes ?
L’assistant adapte le plan et recalcule sa conformité aux objectifs.
Étape 5 : créer et vérifier le plan
Très bien. Crée ce plan alimentaire pour Mark dans FITsociety et vérifie sa conformité à ses objectifs.
L’assistant crée le plan et le compare aux objectifs. Il signale les jours présentant un écart trop important. Ouvrez ensuite vous-même le plan dans FITsociety pour le vérifier.
Étape 6 : suivre la progression
Après une ou deux semaines, vérifiez rapidement la situation :
Dans quelle mesure Mark a-t-il suivi son plan alimentaire ces deux dernières semaines ? Quels jours s’en est-il le plus écarté ?
Conseil : si vous créez une recette pour un membre, demandez aussi son enregistrement dans votre bibliothèque afin de la réutiliser pour d’autres membres.
Autres exemples de demandes et conseils
Exemples de demandes
Membres et progression
« Quels membres n’ont pas encore rempli leur bilan cette semaine ? »
« Résume les trois derniers bilans de Sanne et ajoute une note à son dossier. »
« Comment le poids de Mark a-t-il évolué ces trois derniers mois ? »
Entraînement et WOD
« Crée et publie un WOD pour samedi : AMRAP de 20 minutes avec kettlebells et rameur. »
« Quels entraînements Sanne a-t-elle terminés ce mois-ci et quelles étaient ses charges maximales au squat ? »
Agenda et réservations
« Planifie un entretien initial avec Lisa mardi prochain à 18:00. »
« Combien de participants en moyenne ont suivi mes cours collectifs ce mois-ci ? »
Administration
« Présente un aperçu des factures impayées. »
« Quels abonnements expirent le mois prochain ? »
« Combien de crédits reste-t-il à Mark ? »
Conseils pour de bonnes instructions
Soyez précis. Indiquez le nom complet du membre, les quantités, jours, heures et objectifs.
Donnez du contexte. Précisez les blessures, préférences, matériel disponible et temps dont dispose le membre.
Demandez d’abord une proposition. Dites « ne crée encore rien » pour voir d’abord ce que l’assistant prévoit.
Ajustez en langage courant. Inutile de recommencer : indiquez simplement les changements souhaités.
Vérifiez le résultat. Vérifiez dans FITsociety avant de partager avec le membre.
Procédez par étapes pour les tâches importantes. Occupez-vous correctement d’un membre avant de demander la même chose pour dix membres.
Ce qui n’est pas encore possible
Créer des factures et des paiements. Vous pouvez consulter et résumer les factures, abonnements et crédits. La création de factures et le traitement des paiements se font comme toujours directement dans FITsociety.
Importer des membres et abonnements d’un autre système. Vous migrez depuis un autre système ? Contactez-nous pour obtenir de l’aide.
Conseils médicaux. L’assistant est un outil de coach, pas un médecin ni un diététicien. En cas de problème médical, votre jugement et celui d’un spécialiste restent prioritaires.
Agir en dehors de vos modules ou droits. L’assistant ne peut pas faire ce que votre compte ou votre clé n’autorise pas.
Une fonction manque ? Ajoutez-la à la liste de souhaits
Si l’assistant ne peut pas encore faire quelque chose, demandez-lui simplement. Si une fonction manque réellement, il propose d’ajouter votre idée à notre liste de souhaits. Les autres coachs peuvent voter pour indiquer les demandes prioritaires. Une présence dans la liste ne garantit ni le développement ni un délai. Aucune donnée de membre ni information personnelle n’y figure.
Questions fréquentes
Quel assistant IA utiliser ?
Un assistant prenant en charge MCP, comme Claude. Certains assistants nécessitent un abonnement payant.
Le MCP entraîne-t-il un supplément ?
Contactez-nous pour connaître les possibilités de votre forfait.
L’assistant peut-il supprimer ou modifier quelque chose par erreur ?
Avec une clé en lecture seule, il ne peut rien modifier. Avec l’écriture, il peut créer et modifier uniquement dans votre compte et vos modules. Demandez donc d’abord une proposition et vérifiez le résultat.
Mes membres voient-ils que j’utilise un assistant IA ?
Non, pas automatiquement. Un programme, plan ou message créé par l’assistant figure simplement dans FITsociety comme si vous l’aviez créé vous-même.
Qu’advient-il des données de mes membres ?
L’assistant accède uniquement aux données autorisées par vos membres et dans votre compte. Consultez aussi les conditions de confidentialité de l’assistant utilisé.
Je reçois une erreur. Que faire ?
Vérifiez d’abord la clé, les droits et l’activation de la connexion dans l’assistant. Un message de droits manquants peut indiquer une clé en lecture seule. Si nécessaire, contactez notre assistance.
Où voir une démonstration ?
Notre webinaire du vendredi 6 novembre à 13:00 montrera l’utilisation du MCP sur un cas pratique. Pour participer, envoyez-nous un message et nous vous transmettrons une invitation.