Für KI-Assistenten & Integrationen
GymStack per MCP verbinden
Claude, ChatGPT oder deine eigenen Agents bedienen dein Studio über das Model Context Protocol – durch dieselbe Sicherheitskette wie die eingebauten GymStack-Agents. Jede Änderung braucht deine Freigabe.
Endpunkt
POST https://intent-finch-948.eu-west-1.convex.site/mcp
Stateless Streamable-HTTP · Antworten als application/json · Discovery nach
RFC 9728
Zwei Wege zum Verbinden
Ohne Schlüssel per OAuth – oder mit API-Key für Entwickler-Tools und Automationen.
OAuth-Connector claude.ai · ChatGPT
- Endpunkt als Custom Connector hinzufügen.
- Anmelden und dein Studio bestätigen – kein Schlüssel nötig.
- Fertig: Der Assistent nutzt die Tools mit den Scopes read + propose.
API-Schlüssel Claude Code · Cursor · n8n · Messages-API
Als Admin unter Einstellungen → Integrationen (MCP) erstellen (max. 10 pro Studio, Klartext einmalig, jederzeit widerrufbar).
claude mcp add gymstack \
--transport http https://intent-finch-948.eu-west-1.convex.site/mcp \
--header "Authorization: Bearer gsk_…" Rund 50 Tools, neun Agents
Tools folgen dem Schema {agent}_{tool} –
jeder Agent bringt seinen Fachbereich mit.
Cleo — Studio-Überblick & KPIs
Kennzahlen-Zusammenfassung, Mitglieder-Suche, offene Freigaben, Risiko-Überblick und Berichte — nur lesend.
cleo_kpi_summary · cleo_run_report
Mia — Marketing
Kampagnen-, Budget- und Social-Überblick, Angebote & Aktionscodes; Vorschläge für Budget-Umschichtungen, Posts und Angebote.
mia_campaign_summary · mia_propose_budget_reallocation
Mehr über Mia →Leo — Leads
Funnel- und Lead-Überblick; Termin-Vorschläge für Probetrainings.
leo_lead_summary · leo_propose_appointment
Mehr über Leo →Emma — Retention
At-Risk-Mitglieder, Segmente und Buddy-Pass-Status; Winback-, Onboarding- und Angebots-Vorschläge.
emma_at_risk_members · emma_propose_winback
Mehr über Emma →Sofia — Support
Konversationen durchsuchen und lesen; Antwort-Entwürfe für den Posteingang.
sofia_search_conversations · sofia_draft_reply
Mehr über Sofia →Finn — Billing
Verträge, Zahlungen, SEPA-Läufe, Mahnwesen und Rechnungen; Vorschläge für Verträge, Zahlungserinnerungen und Rechnungsversand.
finn_search_members · finn_payment_summary
Mehr über Finn →Klara — Finance
Umsatzberichte, Forecast, Monats-KPIs und Umsatz nach Zahlungsart — nur lesend.
klara_revenue_report · klara_kpi_overview
Mehr über Klara →Otto — Operations
Anwesenheit, Kursplan, Auslastung und Dienstplan; Kurs-, Schicht- und Tageskarten-Vorschläge.
otto_schedule_overview · otto_propose_class
Mehr über Otto →Max — Facility
Offene Facility-Meldungen; Wartungs-Vorschläge.
max_open_facility_reports · max_propose_maintenance
Mehr über Max →Sicherheitsmodell: Vorschlag statt Durchgriff
Propose-only
Schreibzugriffe werden nie direkt ausgeführt: Jeder Schreibwunsch landet als Vorschlag in deiner Freigabe-Queue und wird erst nach deiner Freigabe umgesetzt.
Auditiert
Jeder Zugriff läuft über dein Studio-Konto bzw. deinen Schlüssel und steht im Audit-Log – inklusive Schlüssel-Kennung.
Rate-Limits
60 Anfragen pro Minute und 30 Vorschläge pro Stunde je Schlüssel – genug für den Alltag, zu wenig für Unsinn.
Häufige Fragen zum MCP-Server
Technische Details für Agents: auth.md · API-Katalog · Server Card
Sehen, wie Agents dein Studio bedienen
Buch dir eine kostenlose Beratung – wir zeigen dir live, wie interne und externe Agents zusammenspielen und du trotzdem die Kontrolle behältst.
30 Minuten · Unverbindlich · DSGVO-konform