Aller au contenu principal

Configurer et utiliser le Sport Alliance MCP

  • Mise à jour

Dans cet article, vous allez apprendre …

  • ce que le connecteur peut faire et quelles applications d'IA le prennent en charge
  • comment le configurer étape par étape dans un environnement sandbox
  • quels niveaux de permissions existent et comment les contrôler
  • comment passer du test en sandbox à la production
  • ce que signifient les messages les plus courants

Sommaire

Guide rapide

  1. Inscrivez-vous sur developer.sportalliance.com et créez un compte partenaire.
  2. Choisissez votre marque, demandez les identifiants sandbox et attendez 2 à 3 minutes.
  3. Créez une application et attribuez-lui les scopes nécessaires.
  4. Activez l'intégration dans le studio sandbox et cochez toutes les cases de consentement.
  5. Installez uv dans le terminal.
  6. Ouvrez l'email d'activation, ouvrez le PDF avec le mot de passe du portail, gardez le nom du tenant et la clé à portée de main.
  7. Exécutez uvx sportalliance-mcp setup et suivez les questions de l'assistant.
  8. Redémarrez votre application d'IA et testez-la avec une question simple.

Ce que le connecteur peut faire

Le connecteur relie un assistant d'IA à Magicline ou PerfectGym Next. Vous formulez votre demande en langage courant, le connecteur la transforme en actions vérifiées et contrôlées par des permissions, puis vous renvoie la réponse. Vous n'avez pas besoin de coder.

Claude Desktop, Claude Code, Cursor, Windsurf, Gemini CLI et Antigravity sont pris en charge.

Voici à quoi ressemblent des demandes typiques :

  • « Réservez Jonas Weber au cours de Spin de ce soir. »
  • « Enregistrez l'arrivée d'Anna Schmidt. »
  • « Mettez en pause le contrat d'Anna pour août, vacances. »
  • « Quels cours ont lieu demain, et lesquels ont encore des places libres ? »
  • « Quelles offres d'adhésion vendons-nous, et combien coûterait Premium pour le client 10023 ? »

Une seule installation peut servir les deux plateformes à la fois. Différents studios et comptes fonctionnent côte à côte, chacun avec sa propre clé et ses propres permissions.

Le connecteur s'applique à Magicline et à PerfectGym Next. Il ne fonctionne pas avec le produit PerfectGym classique sur perfectgym.pl, qui est un système différent.

Prérequis

  • Une des applications d'IA mentionnées ci-dessus
  • Une fenêtre de terminal : l'application Terminal sur Mac, PowerShell sous Windows
  • Une boîte email que vous pouvez consulter, car la clé d'accès arrive par email
  • Environ 30 minutes, une seule fois

Toutes les étapes des parties A à C se déroulent dans un sandbox, un environnement de test dédié sans données réelles. Seule la partie D vous fait passer en production.

Permissions et mesures de sécurité

Le connecteur fonctionne avec trois niveaux d'accès. Il démarre toujours au niveau 1, et vous devez activer les niveaux supérieurs de façon délibérée.

  1. Lecture uniquement (par défaut, toujours actif) : horaires des cours, places libres, offres d'adhésion et informations sur le studio. Aucune donnée de membre, et rien ne peut être modifié.
  2. Données des membres (facultatif) : profils, contrats, soldes et historique de check-in. Ce sont de vraies données personnelles de vrais membres, alors n'activez ce niveau que lorsque vous êtes prêt à en assumer la responsabilité.
  3. Effectuer des modifications (facultatif) : réserver des cours, enregistrer l'arrivée des membres, créer des prospects, mettre des contrats en pause. Ce sont de vraies actions dans votre studio, et l'assistant vous montre toujours d'abord ce qu'il compte faire.

Quatre mesures de sécurité sont toujours actives, quel que soit le niveau choisi :

  • Les actions importantes, comme annuler un contrat, signer une adhésion ou exporter des données financières, ne sont jamais validées automatiquement. Une personne confirme chacune d'entre elles.
  • Chaque réponse indique le studio dont elle provient, avec une étiquette claire PRODUCTION ou Sandbox.
  • L'identité est vérifiée à nouveau à chaque démarrage. Si quelque chose ne correspond pas, le connecteur refuse de démarrer plutôt que de deviner.
  • Votre clé se trouve dans le coffre-fort de votre ordinateur, c'est-à-dire le Trousseau macOS ou le Gestionnaire d'identification Windows, jamais dans un fichier texte non chiffré.

Si une clé d'accès a été partagée par accident, par exemple dans un chat, une capture d'écran ou un ticket, réémettez-la dans le portail.

Partie A : Créer l'application dans le portail développeur

La partie A se déroule entièrement dans le portail développeur, sur developer.sportalliance.com.

  1. Inscrivez-vous sur developer.sportalliance.com, avec un email et un mot de passe ou avec Google. Si vous n'avez pas encore de compte, vous trouverez Register here sous le bouton de connexion.

Page de connexion du portail développeur avec le lien Register here sous le bouton de connexion

  1. Lors de votre première connexion, vous décidez à quelle organisation vous appartenez. Si votre entreprise a déjà un compte partenaire, demandez l'accès à son administrateur. Sinon, choisissez Create New Partner Account, saisissez le nom du partenaire et de l'entreprise, acceptez les conditions générales et enregistrez avec Save.

Écran de bienvenue lors de la première connexion avec l'option Create New Partner Account

Formulaire pour le nom du partenaire, le nom de l'entreprise et la case des conditions générales

  1. Choisissez la marque correspondante dans le menu déroulant en haut, Magicline ou PerfectGym. Ouvrez ensuite Sandbox / Details et cliquez sur Request Sandbox Credentials. Après 2 à 3 minutes, votre propre studio de test est prêt, entièrement séparé des données réelles.

Détails du sandbox avant le provisionnement, un clic le lance

  1. Ouvrez Sandbox / Applications et cliquez sur Add New Application.

Vue Sandbox Applications avec le bouton Add New Application

  1. Dans la boîte de dialogue, choisissez le type d'application Generic, saisissez un nom, par exemple « MCP », et indiquez l'adresse email d'activation. C'est à cette adresse qu'arrivera plus tard l'email d'activation contenant le nom du tenant et la clé d'accès. La clé se trouve dans un PDF protégé par mot de passe, et vous trouverez ce mot de passe dans le portail.

Boîte de dialogue de création d'une application avec le type Generic, un nom et l'adresse email d'activation

  1. Ouvrez la nouvelle application, allez dans l'onglet Scopes et cliquez sur Add Scopes. Les scopes viennent par paires _READ et _WRITE par domaine, par exemple pour les rendez-vous, le check-in, les cours et les données clients. Select All est pratique pour le sandbox, mais pour la production il est préférable de les attribuer de façon délibérée.

Une application nouvellement créée sans scopes attribués et donc sans accès

Sélection des scopes avec des paires READ et WRITE par domaine

Les scopes que vous choisissez ici constituent la limite absolue de ce que le connecteur pourra jamais atteindre, quelle que soit la demande faite à l'assistant. Attribuez-les avec parcimonie, vous pourrez toujours en ajouter plus tard.

Partie B : Activer l'intégration dans le studio

  1. Sur Sandbox / Details, vos identifiants sont maintenant prêts : l'adresse web (https://<tenant>.web.sandbox.magicline.com pour Magicline, https://<tenant>.web.sandbox.perfectgym.com pour PerfectGym Next), le nom d'utilisateur adminuser, le mot de passe, que vous révélez avec l'icône œil, et l'URL de base (https://<tenant>.open-api.sandbox.magicline.com ou https://<tenant>.open-api.sandbox.perfectgym.com respectivement). Connectez-vous avec ce nom d'utilisateur et ce mot de passe.

Détails du sandbox avec les identifiants une fois le provisionnement terminé

  1. Dans le studio, allez dans Settings / Integrations / Overview. Votre propre application apparaît là, aux côtés des partenaires intégrés. Cliquez sur Activate sur sa ligne.

Vue des intégrations dans le studio avec votre propre application et le bouton Activate

La boîte de dialogue d'activation demande quelles données clients le studio partage avec l'intégration, en deux groupes : clients existants (membres, prospects, anciens membres) et nouveaux clients (nouveaux membres, nouveaux prospects), cinq cases au total. Tout est désactivé par défaut. Cochez les cinq cases et cliquez seulement ensuite sur Activate, sinon le connecteur verra un studio vide. Vous recevrez ensuite l'email d'activation avec le nom du tenant et la clé.

Étape de consentement de l'activation avec les cases de partage de données

Partie C : Configurer le connecteur dans le terminal

  1. Installez uv. Il apporte son propre environnement Python, vous n'avez besoin de rien d'autre.
    • macOS et Linux : curl -LsSf https://astral.sh/uv/install.sh | sh
    • Windows PowerShell : powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  2. Ouvrez l'email d'activation et, à l'intérieur, le PDF avec le mot de passe du portail. Gardez le nom du tenant et la clé à portée de main.
  3. Exécutez uvx sportalliance-mcp setup. L'assistant demande d'abord la plateforme et propose Magicline et PerfectGym Next comme options.
  4. Saisissez le nom du tenant et choisissez l'environnement : Sandbox pour le studio de test de la partie B, Production pour l'utilisation réelle. Chaque option vous montre l'adresse API complètement résolue afin que vous puissiez la vérifier. Collez ensuite la clé du PDF, la saisie reste masquée. L'assistant valide la clé en direct auprès de l'API et vous montre quel studio elle ouvre réellement. Le serveur démarre par défaut en mode lecture seule sécurisé, et la clé est stockée dans le trousseau de votre système d'exploitation.
  5. Vient ensuite la question facultative sur la connexion à un entrepôt de données. C'est une fonctionnalité avancée pour les clients entreprise disposant de leur propre accès à un entrepôt de données, et la documentation technique en couvre les détails. Sans cet accès, passez la question avec Entrée, et rien d'autre ne change.
  6. Enfin, choisissez les applications d'IA que vous souhaitez configurer. Les applications déjà détectées sont présélectionnées, et vous confirmez avec Entrée. Pour Claude Code, il y a une question supplémentaire sur le niveau de pré-approbation. Le choix recommandé est : les outils de lecture non personnels s'exécutent sans demander, tandis que les données des membres et les modifications continuent de demander une confirmation.

La configuration est alors terminée. Redémarrez votre application d'IA et les outils seront disponibles.

Tester la configuration

Redémarrez votre application d'IA et posez une question simple, par exemple « Quels cours sont programmés demain ? ». Si vous recevez une réponse de votre studio, les outils fonctionnent comme prévu.

Partie D : Passer en production

Une fois que le sandbox fonctionne comme vous le souhaitez, répétez les mêmes étapes pour Application, Details et Scopes dans l'onglet Production du portail, puis soumettez l'application pour révision.

Soyez particulièrement attentif aux scopes ici : ce que vous accordez s'applique à chaque studio qui active l'intégration.

Après l'approbation de Sport Alliance, les studios réels peuvent activer l'intégration exactement comme à l'étape 8. L'activation délivre à nouveau une clé dans un PDF protégé par mot de passe. Exécutez ensuite à nouveau uvx sportalliance-mcp setup, cette fois avec le tenant et la clé de production, et choisissez Production comme environnement.

Le connecteur au quotidien

À l'accueil :

  • « Réservez Jonas Weber au cours de Spin de ce soir. »
  • « Enregistrez l'arrivée d'Anna Schmidt. »
  • « Quand Anna peut-elle annuler son contrat au plus tard ? »
  • « Quel est son solde, et que doit-elle payer ensuite ? »
  • « Prolongez sa pause d'un mois, combien cela coûterait-il ? »
  • « Créez un prospect pour Max Mustermann, max@example.com, et réservez-lui une séance d'essai gratuite pour demain matin. »

Au bureau :

  • « Le studio est-il très fréquenté en ce moment ? »
  • « Quels cours ont lieu demain, et lesquels ont encore des places libres ? »
  • « Montrez le solde du compte et les prochaines charges du client 10023. »
  • « Notez cet appel téléphonique sur sa fiche. »

Avant toute réservation ou modification de contrat, l'assistant vérifie automatiquement si l'action est réellement possible pour ce membre. Les cours restreints, les règles d'adhésion et les limites de pause sont respectés automatiquement.

Si un cours ou une offre « n'existe pas », c'est généralement qu'il n'a pas encore été créé au bureau. Le connecteur peut lire et réserver l'inventaire existant, mais créer de nouveaux cours et offres reste une tâche du bureau.

Modifier les permissions plus tard

La commande uvx sportalliance-mcp permissions suffit pour activer ou désactiver des niveaux d'accès, ou pour désactiver des fonctionnalités précises, par exemple conserver la réservation de cours mais exclure entièrement l'annulation de contrat. Vous n'avez pas besoin de refaire la configuration pour cela.

Redémarrez votre application d'IA après tout changement de paramètres.

Messages courants et leur signification

  • « The tenant does not exist on this host » : les studios sandbox et de production se trouvent à des adresses différentes. Votre studio existe, simplement dans l'autre environnement. L'assistant de configuration vous propose le changement en une seule touche.
  • « The key is valid, but the integration has no scope… » : la clé fonctionne, mais aucune permission n'a jamais été accordée à l'application dans le portail. Retournez à l'étape 6, ajoutez les scopes nécessaires et réessayez.
  • « The API rejected the key (401/403) » : le tenant et la clé ne correspondent pas. Les deux proviennent du même email d'activation, vérifiez-les à nouveau là-bas. Si vous utilisez les deux plateformes, assurez-vous que la clé ne vient pas de l'autre.
  • La connexion ne démarre pas du tout et affiche « STOPPING » : la clé ouvre un studio différent de celui pour lequel cette connexion a été configurée. C'est la vérification d'identité qui fait exactement ce qu'elle doit faire. Exécutez à nouveau l'assistant de configuration pour cette plateforme.
  • Des outils manquent dans l'application d'IA : les capacités liées aux données des membres et aux modifications n'apparaissent que lorsque leur niveau est activé. Vérifiez les permissions, puis redémarrez l'application d'IA.
  • Les données d'un membre reviennent avec « permission denied » : certains membres s'opposent au partage de leurs données avec des tiers. C'est leur droit, la plateforme le respecte, et le connecteur le signale plutôt que de réessayer.

Connecter d'autres studios ou plateformes

Si vous souhaitez connecter des studios supplémentaires ou l'autre plateforme, exécutez simplement à nouveau la configuration. Les deux fonctionneront alors côte à côte dans la même application d'IA, différenciés par couleur.

Remarque : Cet article a été créé à l'aide de l'intelligence artificielle et traduit automatiquement sans relecture. Nous vous prions de nous excuser pour d'éventuelles erreurs.