Compteam mit KI-Agenten nutzen
Verbinden Sie einen kompatiblen MCP-Client, um öffentliche BJJ-Kurse zu finden oder Ihre eigene Compteam-Teilnahme sicher zu verwalten.
Was der Compteam-MCP-Server macht
Das Model Context Protocol (MCP) ermöglicht kompatiblen KI-Agenten den Zugriff auf eine kleine, kontrollierte Auswahl von Compteam-Werkzeugen. Die öffentliche Suche funktioniert ohne Konto. Persönliche Daten oder Informationen zu verknüpften Kindern erfordern immer eine Compteam-Anmeldung.
Ohne Anmeldung verfügbar
- Compteam-Vereine mit veröffentlichtem Kursplan finden.
- Die öffentlichen Kurse eines Vereins für eine ausgewählte Woche anzeigen.
- Öffentliche Mitgliedschaftspläne eines Vereins mit wiederkehrendem Preis und Abrechnungsintervall sowie einer möglichen einmaligen Anmeldegebühr anzeigen.
- Öffentliche Branchendetails wie Adresse, Kontakt- und Social-Media-Links, Sprache, Währung, Richtlinien sowie Links zu Buchung, Registrierung und Vereinsseite anzeigen.
Nach Verbindung mit dem Compteam-Konto verfügbar
Diese kontoverbundenen Funktionen sind nur über das Compteam-Plugin für ChatGPT/OpenAI oder einen von Compteam registrierten MCP-Client verfügbar. Der Athlet muss die Compteam-Authentifizierung im Chat abschließen, bevor der Client auf persönliche Daten zugreifen oder Aktionen ausführen kann.
- Das eigene Mitgliedsprofil und mit dem Konto verknüpfte Kinder anzeigen.
- Bevorstehende Kurse sowie einen begrenzten Mitgliedschafts- oder Zahlungsstatus anzeigen.
- Eine Teilnahme für sich selbst oder ein verknüpftes Kind bestätigen oder absagen.
- Eine Anfrage für eine geeignete kostenlose Probestunde öffnen und absenden.
Einen MCP-Client registrieren
Für die öffentliche Suche ist keine Registrierung erforderlich. Wenn Ihr Client kontoverbundene Werkzeuge benötigt, senden Sie uns die folgenden Angaben. Wir prüfen jeden Client manuell und antworten mit der genehmigten OAuth-Konfiguration und dem Zugriffsbereich.
- Fügen Sie den Compteam-Endpunkt hinzu und testen Sie zuerst die öffentliche Suche.
- Senden Sie Clientdaten, Sicherheitslinks und die genauen OAuth-Redirect-URIs.
- Compteam bestätigt die Clientregistrierung und die verfügbaren Funktionen.
OAuth-Bootstrap für Clientbetreiber
Verwenden Sie diesen schreibgeschützten Deskriptor, um MCP-Ressource, Supabase-Autorisierungsserver-Metadaten, die erforderliche PKCE-Methode und den Registrierungspfad zu entdecken. Er erstellt keine Zugangsdaten und gewährt keinen Zugriff; Compteam muss jede Client-ID zuerst genehmigen und aktivieren.
OAuth-Bootstrap-Deskriptor öffnen: https://api.compteam.io/api/v1/public/mcp-client-registration/bootstrapClientregistrierung anfragen
Geben Sie keine Passwörter, Client-Geheimnisse, API-Schlüssel oder Mitgliederdaten ein.
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.
Einen kompatiblen Client verbinden
Registry-fähige Clients finden Compteam über den verifizierten Registry-Namen. Andere MCP-Clients können sich direkt mit dem HTTPS-Endpunkt verbinden.
- Registry-Name
- io.compteam/compteam
- Endpunkt
- https://api.compteam.io/mcp
- Transport
- Streamable HTTP
Wenn der Client einen JSON-Eintrag für MCP-Server akzeptiert, verwenden Sie diese allgemeine Konfiguration:
{
"mcpServers": {
"compteam": {
"type": "streamable-http",
"url": "https://api.compteam.io/mcp"
}
}
}Sicherheit und Kontogrenzen
- Verbundene Werkzeuge greifen nur auf Ihr Profil oder ein bereits mit Ihrem Konto verknüpftes Kind zu.
- Der Agent muss vor einer RSVP-Änderung oder einer Probestundenanfrage eine Bestätigung einholen.
- Mitgliedschaftspläne dienen nur der Information; Mitgliedschaften können über diesen MCP-Server nicht abgeschlossen und Kurse oder andere Angebote nicht bezahlt werden.
- Die Authentifizierung nutzt die OAuth-Verbindung des Clients. Fügen Sie keinen normalen Compteam-Web-Token in einen MCP-Client ein.
Beispielanfragen
Probieren Sie nach dem Hinzufügen von Compteam:
- “Finde Compteam-Vereine mit öffentlichen BJJ-Kursen.”
- “Zeige die öffentlichen Kurse dieses Vereins für nächste Woche.”
- “Zeige die Mitgliedschaftspläne und Preise dieses Vereins.”
- “Zeige mir Adresse, Instagram, Richtlinien und öffentliche Buchungs- und Registrierungslinks dieses Standorts.”
- “Zeige meine nächsten Compteam-Kurse.”
- “Sage meine Teilnahme am morgigen Kurs ab.”
- “Frage diesen Verein nach einer kostenlosen Probestunde.”