Utiliser Compteam avec des agents IA
Connectez un client MCP compatible pour découvrir les cours publics de BJJ ou gérer en toute sécurité votre présence Compteam.
Fonctionnement du serveur MCP Compteam
Le Model Context Protocol (MCP) permet aux agents IA compatibles d’utiliser un ensemble réduit et contrôlé d’outils Compteam. La découverte publique fonctionne sans compte. Les informations personnelles ou celles d’un enfant lié nécessitent toujours une connexion Compteam.
Disponible sans connexion
- Trouver les clubs Compteam qui publient un planning de cours public.
- Afficher les cours publics d’un club pour une semaine donnée.
- Consulter les formules d’adhésion publiques d’un club, avec le prix récurrent et sa périodicité, ainsi que les frais d’inscription uniques éventuels.
- Consulter les informations publiques d’une antenne : adresse, liens de contact et réseaux sociaux, langue, devise, conditions et liens de réservation, d’inscription et de la page du club.
Disponible après connexion de votre compte Compteam
Ces fonctions connectées au compte sont disponibles uniquement via le plugin Compteam pour ChatGPT/OpenAI ou un client MCP enregistré par Compteam. L’athlète doit terminer l’authentification Compteam dans le chat avant que le client puisse accéder aux données personnelles ou effectuer des actions.
- Afficher votre profil membre et les enfants liés à votre compte.
- Consulter les prochains cours et un statut limité d’adhésion ou de paiement.
- Confirmer ou annuler une réservation pour vous-même ou un enfant lié.
- Ouvrir et envoyer une demande pour un cours d’essai gratuit éligible.
Enregistrer un client MCP
La découverte publique ne nécessite pas d’enregistrement. Si votre client a besoin d’outils connectés à un compte, envoyez-nous les informations ci-dessous. Chaque client est examiné manuellement et nous répondons avec la configuration OAuth et le périmètre approuvé.
- Ajoutez le point d’accès Compteam et testez d’abord la découverte publique.
- Envoyez les informations du client, les liens de sécurité et les URI OAuth exactes.
- Compteam confirme l’enregistrement et les capacités disponibles.
Bootstrap OAuth pour les opérateurs clients
Utilisez ce descripteur en lecture seule pour découvrir la ressource MCP, les métadonnées du serveur d’autorisation Supabase, la méthode PKCE requise et le chemin de demande d’enregistrement. Il ne crée jamais d’identifiants et n’accorde aucun accès : Compteam doit d’abord approuver et activer chaque ID client.
Ouvrir le descripteur bootstrap OAuth: https://api.compteam.io/api/v1/public/mcp-client-registration/bootstrapDemander l’enregistrement du client
N’incluez pas de mots de passe, secrets client, clés API ou données de membres.
Full MCP clients only · registration_full
Registration flows for full MCP clients
These account, branch, membership, billing, and consent flows are supported through an explicitly approved full MCP client (`registration_full`) after the athlete authenticates in the chat. They are not available to anonymous, OpenAI/ChatGPT marketplace, or `marketplace_safe` clients.
- Adult first registration: create an athlete account, select an existing gym, or start a new unmanaged gym.
- Imported and managed-profile claims: match an invited or imported profile after account verification without creating a duplicate athlete.
- Joining an additional branch: keep one personal profile while adding membership at another gym.
- Guardian-led registration for children under 16: a guardian creates the child profile and gives required training consent.
- Athlete-created unmanaged gyms: an athlete can create a branch that starts unmanaged and remains claimable by a branch administrator.
- New branch registration and unmanaged-branch claiming: create a new organization/branch or claim an eligible unmanaged branch during admin setup.
- Membership-plan eligibility and approval gates: age/tier eligibility, self-subscription approval, and branch activation rules are checked before access is granted.
- Exact terms versions and required consent: the current branch terms version, privacy/data-processing consent, and any membership signature are recorded.
- SEPA mandate validation: IBAN, account-holder details, mandate authorization, and branch billing requirements are validated before a plan is submitted.
- Signup-fee clearance status: registrations can remain pending until the one-time signup fee is reconciled or explicitly cleared by the branch.
- Optional authenticated adult profile photo: an adult may upload a profile photo after authentication; it can be skipped and added later.
Full MCP client access (`registration_full`) is granted per registered client ID. After OAuth, the athlete must authenticate in the chat and the client must refresh its tool list before these registration tools appear. OpenAI/ChatGPT and marketplace_safe clients cannot create athletes, branches, memberships, mandates, or consents. Sensitive billing and photo fields stay in the secure registration form.
Connecter un client compatible
Les clients compatibles avec le Registre peuvent trouver Compteam par son nom vérifié. Les autres clients MCP peuvent se connecter directement au point d’accès HTTPS.
- Nom dans le Registre
- io.compteam/compteam
- Point d’accès
- https://api.compteam.io/mcp
- Transport
- Streamable HTTP
Si le client accepte une entrée JSON de serveur MCP, utilisez cette configuration générique :
{
"mcpServers": {
"compteam": {
"type": "streamable-http",
"url": "https://api.compteam.io/mcp"
}
}
}Sécurité et limites du compte
- Les outils connectés accèdent uniquement à votre profil ou à un enfant déjà lié à votre compte.
- L’agent doit demander confirmation avant de modifier une réservation ou d’envoyer une demande de cours d’essai.
- Les formules d’adhésion sont fournies à titre informatif ; l’inscription à une formule, le paiement des cours et les paiements ne sont pas disponibles via ce serveur MCP.
- L’authentification utilise la connexion OAuth du client. Ne collez pas un jeton web Compteam normal dans un client MCP.
Exemples de demandes
Après avoir ajouté Compteam à votre agent, essayez :
- “Trouve des clubs Compteam avec des cours publics de BJJ.”
- “Affiche les cours publics de ce club la semaine prochaine.”
- “Affiche les formules d’adhésion et leurs prix dans ce club.”
- “Indique-moi l’adresse, Instagram, les conditions et les liens publics de réservation et d’inscription de cette antenne.”
- “Affiche mes prochains cours Compteam.”
- “Annule ma réservation pour le cours de demain.”
- “Demande à ce club un cours d’essai gratuit.”