MoveMentors expose un serveur Model Context Protocol (MCP). Si tu utilises Claude, ChatGPT (avec les intégrations Claude API), Cursor ou tout autre assistant IA compatible MCP, tu peux les connecter à ton compte pour demander des choses comme :
- "Quelles sont mes réservations pour la semaine prochaine ?"
- "Annule mon cours de samedi et envoie un e-mail à toutes les personnes qui l'ont réservé."
- "Ajoute un cours de yoga le mardi matin au même prix que celui du jeudi."
- "Envoie un mot de remerciement aux clients qui ont assisté au cours dans les 30 derniers jours."
Le serveur MCP est disponible pour les comptes Pro et Premium.
Qu'est-ce que MCP
Le Model Context Protocol est un standard ouvert qui permet aux assistants IA de communiquer avec des outils externes. Créé à l'origine par Anthropic (les créateurs de Claude) ; désormais adopté par ChatGPT, Cursor et d'autres.
Pour MoveMentors, MCP signifie que ton assistant IA peut :
- Voir tes réservations, tes cours, tes clients (accès en lecture).
- Créer de nouvelles réservations, modifier des cours, envoyer des messages (accès en écriture).
- Le tout encadré par les permissions OAuth que tu accordes.
Comment ça marche
- Tu te rends dans les paramètres de ton assistant IA (Claude Desktop, ChatGPT, etc.) et tu ajoutes MoveMentors comme serveur MCP.
- L'assistant ouvre un flux OAuth dans ton navigateur.
- Tu te connectes à MoveMentors et tu accordes des permissions précises (lire les réservations, écrire les cours, etc.).
- L'assistant reçoit un jeton qu'il inclut dans ses requêtes.
- Tu peux désormais demander à l'assistant de faire des choses sur ton compte.
Pas de clés API, pas d'identifiants en clair. OAuth gère l'authentification.
Connecter Claude Desktop
Ouvrir Claude Desktop
L'application bureau pour Claude.
Aller dans Paramètres → Développeur
Cherche la section "MCP servers".
Ajouter un nouveau serveur MCP
Clique sur "Add server" et choisis "Connect via OAuth".
Saisir l'URL MCP MoveMentors
https://movementors.com/api/mcpAutoriser
Claude ouvre une fenêtre de navigateur. Tu te connectes à MoveMentors et tu vois un écran de consentement listant les permissions demandées.
Choisir quelles permissions accorder
Tu peux refuser certaines portées si tu souhaites limiter ce que Claude peut faire. Par exemple, tu peux accorder "lire les réservations" mais refuser "écrire les cours" si tu veux que Claude consulte sans modifier.
Clique sur 'Approuver'
Tu reviens à Claude. Le serveur est maintenant connecté.
Commencer à utiliser
Parle à Claude normalement. Il dispose désormais des outils pour consulter et modifier ton compte MoveMentors.
Connecter ChatGPT
ChatGPT prend en charge les serveurs MCP via l'API Anthropic avec Claude comme modèle. L'interface est différente de celle de Claude Desktop mais le flux OAuth est le même.
Si ton assistant IA prend en charge MCP, il aura une option analogue "Add MCP server" quelque part. L'URL est toujours https://movementors.com/api/mcp.
Outils disponibles (ce que l'IA peut faire)
Le serveur MCP expose une vingtaine d'outils. Quelques-uns à souligner :
whoami: qui est l'utilisateur actuel (renvoie les infos de ton compte).search_mentors,search_studios,search_classes: interroger le répertoire public.get_mentor: obtenir le profil complet d'un mentor spécifique.list_my_bookings: tes réservations (en tant qu'élève ou hôte).book_class: créer une réservation.cancel_booking: annuler une réservation.list_my_classes: tes cours hébergés.update_class,delete_class: modifier les cours hébergés.add_class_schedule: ajouter une séance à un cours existant.list_class_bookings: qui est inscrit à une séance spécifique.financials_summary: ton résumé de revenus.list_expenses,create_expense,update_expense,delete_expense: suivi des dépenses.send_mentor_inquiry: envoyer un message direct.list_received_mentor_inquiries: voir les messages entrants.
L'assistant choisira le bon outil pour ta demande. Tu n'as pas besoin de connaître les noms des outils.
Permissions et portées
Les permissions sont granulaires. Tu peux accorder ou refuser chaque portée individuellement pendant le flux OAuth. Voir Portées OAuth pour la liste complète et ce que chacune autorise.
Regroupements de portées courants :
- Lecture seule : tout voir, ne rien changer. Utile pour tester.
- Gestion des réservations : voir et modifier les réservations, mais pas les cours.
- Contrôle total : tout.
Tu peux révoquer les permissions à tout moment sur /settings/connected-apps.
Cas d'usage
"Montre-moi ma semaine prochaine"
L'assistant utilise list_my_bookings et list_my_classes pour récupérer une semaine d'événements, organisés par jour. Tu poses des questions de suivi comme "lesquels sont encore en attente de paiement ?".
"Annule samedi et rembourse tout le monde"
L'assistant utilise list_class_bookings pour obtenir les réservations concernées, puis cancel_booking sur chacune. Les remboursements pour les paiements Stripe se traitent automatiquement.
"Ajoute un nouveau cours similaire à celui du mardi mais le jeudi"
L'assistant utilise get_class pour récupérer les détails du cours du mardi, puis create_class avec les mêmes champs mais un planning différent.
"Quel a été mon meilleur mois en revenu ?"
L'assistant utilise financials_summary pour récupérer les totaux mois par mois et te rend compte.
"Envoie un mot de remerciement à tous ceux qui ont assisté le week-end dernier"
L'assistant utilise list_my_bookings filtré sur le week-end dernier avec le statut COMPLETED, puis send_mentor_inquiry ou similaire pour envoyer des messages personnalisés à chacun.
Sécurité
Quelques points à savoir :
Les portées OAuth sont la limite
L'assistant ne peut rien faire en dehors des portées que tu as accordées. Si tu n'as accordé qu'un accès en lecture, les tentatives d'écriture renvoient des erreurs de permission.
Chaque requête est journalisée
Nous enregistrons chaque requête MCP : quel outil, quels arguments, le résultat. Visible dans /settings/audit-log. Utile si tu veux savoir ce que l'assistant a fait.
Les jetons peuvent être révoqués
/settings/connected-apps affiche chaque client OAuth connecté. Révoque à tout moment ; l'assistant perd immédiatement l'accès.
Limites de débit
Nous limitons le débit par jeton. Un assistant normal qui fait des requêtes conversationnelles reste bien en dessous. Un assistant essayant de récupérer tout ton historique de réservations d'un coup pourrait atteindre les limites ; il réessaie avec un backoff.
Sandboxing
La plupart des clients MCP (Claude Desktop, etc.) tournent dans des processus séparés. Ils ne peuvent pas lire tes autres fichiers ni détourner ton navigateur. La connexion avec nous se fait via HTTPS avec authentification par jeton.
Limites
Certains outils sont restreints :
book_class: nécessite le palier Pro. Le palier gratuit n'expose que la lecture seule.update_class,delete_class,add_class_schedule: palier Pro.financials_summaryet les outils de dépenses : palier Pro.
Si tu es en gratuit et essaies d'utiliser un outil restreint, tu obtiens une erreur claire de l'assistant.
Questions fréquentes
L'assistant partagera-t-il mes données avec qui que ce soit d'autre ? L'assistant tourne localement (Claude Desktop) ou dans l'environnement de ton fournisseur (Claude.ai sur le web). Les données qu'il lit depuis MoveMentors restent dans ta conversation ; elles ne sont pas partagées avec d'autres utilisateurs.
La politique de confidentialité d'Anthropic s'applique à ce qu'ils font des données de tes conversations. Nous ne contrôlons pas cela.
L'assistant peut-il voir mon mot de passe ? Non. OAuth signifie que l'assistant ne voit jamais ton mot de passe. Il dispose d'un jeton qui peut être révoqué.
L'assistant peut-il agir dans mon dos ? L'assistant n'agit que lorsque tu le lui demandes (en conversation). Il ne tourne pas en arrière-plan sauf si tu mets en place une automatisation. Chaque action est journalisée.
Et si l'assistant fait une erreur ? Tu peux consulter le journal d'audit et annuler la plupart des actions :
- Les réservations annulées peuvent être re-réservées (si des places sont encore disponibles).
- Les cours supprimés peuvent être recréés (l'assistant a les données).
- Les messages envoyés ne peuvent pas être annulés.
Traite l'assistant comme un employé junior avec un accès. Fais confiance, mais vérifie.
Le support MCP s'améliorera-t-il avec le temps ? Oui. Nous ajoutons de nouveaux outils au fur et à mesure que MCP lui-même évolue. Abonne-toi à notre newsletter ou consulte le changelog pour les mises à jour.
Prochaines étapes
- Portées OAuth : le modèle de permissions.
- Essaie : connecte Claude Desktop et demande "montre-moi ma semaine prochaine".