AI-agent koppelen
Koppel Claude, ChatGPT, Grok, Gemini, Cursor of een andere MCP-compatibele AI-assistent — stap voor stap voor niet-technisch personeel.
Introductie
Koppel een externe AI-assistent aan je gym om je rooster te controleren, sessies te plannen, leden te berichten en meer — met dezelfde bedrijfsregels als in de Sessy-app.
Belangrijk: bij een externe AI-tool worden gym- en lidgegevens naar die AI-aanbieder gestuurd. Lees 4. Gegevensbescherming en veiligheid voordat je begint, en kies Beperkt — geen lidgegevens op het token als de assistent geen leden-workflows nodig heeft.
Eenmaal gekoppeld: zie AI-agentvaardigheden voor voorbeeldvragen — plannen, berichten, inschrijven, programming en meer.
De ingebouwde Sessy AI-assistent (in de Sessy-app) is iets anders. Die gebruikt geen token. Deze pagina gaat over externe tools zoals Claude of ChatGPT.
Op deze pagina
- Kies een geschikte AI-tool
- Maak een toegangstoken aan in Sessy
- Koppel je AI-tool
- Gegevensbescherming en veiligheid
1. Kies een geschikte AI-tool
Sessy koppelt via MCP (Model Context Protocol) — een standaard waarmee AI-apps aan andere diensten kunnen koppelen. Je hoeft MCP niet te begrijpen; je hebt alleen een app nodig met een instelling voor MCP, connector of integratie waar je een serveradres en token kunt plakken.
Geschikte AI-tools
Kies het type dat bij je team past, en daarna een tool die je al gebruikt:
| Type | Het beste voor | Voorbeelden |
|---|---|---|
| Chat-assistenten | De meeste gymmedewerkers — vragen stellen en taken uitvoeren in een eenvoudige browser- of desktop-chat | Claude, ChatGPT, Grok, Gemini |
| AI-editors | Eigenaren of coaches die in een desktop AI-app op hun computer werken | Cursor, VS Code + MCP-extensie, Windsurf, Zed, Raycast |
| Automatiseringsagents | Geavanceerde setups — geplande taken, workflows met meerdere stappen, of computergebruik (de agent bedient apps op je desktop) | OpenClaw, Hermes Agent, Grok bot — technische setup; zie de MCP-docs van elk product |
Staat een tool niet in de lijst? Alleen bruikbaar als de documentatie MCP of Model Context Protocol noemt en je een eigen server-URL mag toevoegen (https://mcp.sessy.app).
Wat werkt niet
- Gewone chat zonder koppeling — ChatGPT of Claude vragen om “in te loggen op mijn gym” zonder Sessy eerst te koppelen. Zonder koppeling zien ze je Sessy-gegevens niet.
- WhatsApp, sms, e-mail of social bots — Sessy koppelt niet op die manier.
- De Sessy AI-chat in de app — gebruik de app direct; geen token nodig.
2. Maak een toegangstoken aan in Sessy
- Log in als Admin
- Open Configuratie → Sessy AI → Externe toegang (MCP)
- Geef het token een naam, kies de medewerker voor wie het is, stel token-toegang in (Admin of Medewerker), en kies gegevenstoegang
- Kopieer het token direct — het wordt maar één keer getoond
- Geef het token aan die medewerker voor hun AI-tool
- Trek het token in via hetzelfde scherm als het verloren is of niet meer nodig
Elk token is voor jouw gym en één medewerker die je kiest.
Je hebt dit token nodig in stap 3. Serveradres voor elke tool: https://mcp.sessy.app
Gegevenstoegang
Bij het aanmaken van een token kies je gegevenstoegang naast token-toegang (Admin of Medewerker):
| Preset | Wanneer |
|---|---|
| Volledige toegang | De assistent moet leden zoeken, inschrijven, gerichte push sturen, aanwezigheid of omzet bekijken, of notities en tags bewerken |
| Beperkt — geen lidgegevens | Rooster, programming, shopcatalogus, gym-banner, nieuwsbrieven en gym-configuratie — zonder persoonsgegevens van leden naar de externe AI te sturen |
Beperkt is een privacy-instelling. Externe AI-tools ontvangen wat Sessy per actie teruggeeft. Met beperkt aan blokkeert Sessy tools die ledennamen, e-mails, boekingslijsten, aanwezigheid, medewerkersnotities, tags, gerichte push-doelgroepen of omzet tonen — en verwijdert leden-identifiers uit roosterreads.
Medewerker-toegang kan geen gym-brede configuratie wijzigen. Admin-toegang is alleen mogelijk als de gekozen medewerker Admin is in Sessy.
Wat beperkt nog wél kan
| Gebied | Voorbeelden |
|---|---|
| Rooster | Rooster bekijken (alleen boekingsaantallen), sessies aanmaken/wijzigen/verwijderen, week vullen vanuit terugkerende templates, coach toewijzen |
| Programming | Globale benchmarks (Fran, Murph, …) en eigen gym-workouts zoeken, workoutId op sessies koppelen voor resultaatlogging, custom workouts aanmaken |
| Gym-banner | setGeneralMessage — banner in de app voor iedereen |
| Nieuwsbrieven | Concepten maken, bijwerken, publiceren of verwijderen |
| Shopcatalogus | Producten en categorieën lezen |
| Gym-samenvatting | Alleen ledenaantal via getBoxStats (geen namen) |
| Configuratie | Alleen Admin-tokens: locaties, sessietypes, abonnementen, shop, tag-definities |
Wat beperkt níet kan
| Niet beschikbaar | Waarom |
|---|---|
| Leden zoeken op naam of e-mail | Persoonsgegevens |
| Lid in- of uitschrijven | Vereist lid-identiteit |
| Aanwezigheidshistorie of “samen getraind”-rapporten | Persoonlijke aanwezigheidsdata |
| Omzetrapporten | Financiële / lid-gerelateerde rapportage |
Gerichte push (notifyMembers) |
Gebruikt ledenlijsten of brede persoonlijke outreach |
| Medewerkersnotities en lid-tags per persoon | Persoonsgegevens |
Kies volledige toegang als medewerkers die workflows nodig hebben. Kies beperkt voor assistenten die alleen rooster, programming, banners, nieuwsbrieven of gym-setup beheren.
Vier combinaties (token-toegang × gegevenstoegang)
| Volledige gegevens | Beperkt — geen lidgegevens | |
|---|---|---|
| Medewerker-token | Rooster, programming, communicatie, leden zoeken/inschrijven/notities, rapporten | Rooster, programming, banner, nieuwsbrieven, shop lezen — geen leden zoeken, inschrijven, notities, gerichte push of omzet |
| Admin-token | Alles wat een Medewerker-token kan, plus gym-configuratie | Zelfde als Medewerker beperkt, plus gym-configuratie |
Bij verbinden levert Sessy de ingebouwde gids access-profile (sessy://skills/access-profile) met de exacte tools voor dit token.
Ingebouwde gidsen voor de assistent
| Gids | Wie | Doel |
|---|---|---|
| Toegangsprofiel | Iedereen | Start hier — exacte tools voor dit token |
| Overzicht | Iedereen | Gouden regels en leesvolgorde |
| Datamodel | Medewerker+ | Leden, sessies, abonnementen, shop |
| Tools-referentie | Medewerker+ | Alles wat de assistent kan doen |
| Limieten en veiligheid | Medewerker+ | Limieten, validatie, gevoelige acties |
| Week plannen | Medewerker+ | Een week plannen — terugkerend rooster of losse lessen |
| Sessies beheren | Medewerker+ | Wijzigen, verwijderen, terugkerend, week vullen vanuit template |
| Lid inschrijven | Medewerker+ · alleen volledige gegevens | In- of uitschrijven |
| Programming | Medewerker+ | Workouts koppelen via workoutId — benchmarks zoeken, custom via upsert |
| Leden berichten | Medewerker+ · alleen volledige gegevens | Gerichte push |
| Nieuwsbrieven | Medewerker+ | Concept en publiceren |
| Notities en tags | Medewerker+ · alleen volledige gegevens | Medewerkersnotities en tags |
| Rapportages | Medewerker+ · alleen volledige gegevens | Aanwezigheid, omzet, shop |
| Configuratie | Alleen Admin | Gym-instellingen |
3. Koppel je AI-tool
Makkelijkst: plak deze prompt
Nadat je je token hebt aangemaakt in stap 2, kopieer je onderstaande prompt naar Claude, ChatGPT, Grok, Gemini, Cursor of een andere MCP-assistent. Vervang YOUR_TOKEN_HERE door je Sessy-token. De AI kan je door de stappen op je computer leiden.
Plak je token alleen in een tool die je vertrouwt.
|
|
Vraag daarna bijvoorbeeld:
- “Welke Sessy-tools heb je?”
- “Laat de sessies van deze week zien.”
Werkt het niet? Controleer het token, of de verbinding aan staat, en of je een nieuwe chat bent gestart na het opslaan.
Handmatige setup
Liever zelf configureren, of werkte de prompt niet? Gebruik de stappen voor jouw tool. Overal hetzelfde principe: Sessy als custom verbinding toevoegen, serveradres https://mcp.sessy.app en je token plakken, opslaan.
Claude (aanbevolen voor niet-technische gebruikers)
- Ga naar claude.ai en log in.
- Open Instellingen → Connectors, Integraties of MCP.
- Voeg een custom connector of MCP-server toe.
- Plak URL
https://mcp.sessy.appen je Sessy-token (Bearer token of API-sleutel). - Sla op en start een nieuwe chat.
Claude desktop: Instellingen → Connectors / MCP → custom server.
ChatGPT
- Open chat.openai.com en log in.
- Instellingen → Connectors of Apps.
- Voeg een custom connector of MCP-verbinding toe met URL en token.
- Sla op en test in een nieuwe chat.
Grok
- Open grok.com en log in.
- Zoek MCP, connectors of integraties in instellingen.
- Voeg een custom MCP-server toe met URL
https://mcp.sessy.appen je Sessy-token. - Sla op en test in een nieuwe chat.
Gemini
- Open gemini.google.com en log in.
- Instellingen → Extensies, Apps of MCP.
- Voeg een custom verbinding toe met URL en token.
- Sla op en test in een nieuwe chat.
Cursor
- Installeer Cursor en log in.
- Cursor Settings → MCP.
- Voeg server
sessytoe met URL en token in de Authorization-header.
OpenClaw, Hermes Agent of Grok bot
Voor geavanceerde automatisering — geplande taken of het bedienen van apps op je computer. Voeg Sessy toe als MCP-server:
- URL:
https://mcp.sessy.app - Auth: Bearer token = je Sessy-token
Zie OpenClaw MCP-docs, Hermes Agent MCP-gids, of de documentatie van je Grok bot-provider. Verwacht een technischere setup dan Claude of ChatGPT.
Andere MCP-apps
Voor Windsurf, Zed, VS Code, Raycast, enz.: open MCP of Integraties en voeg URL en token toe.
4. Gegevensbescherming en veiligheid
Persoonsgegevens verlaten Sessy
Wanneer je AI-assistent Sessy namens jou gebruikt, worden gym- en lidgegevens naar de AI-dienst gestuurd die jij kiest — bijvoorbeeld Anthropic, OpenAI, xAI, Google of Cursor. Die gegevens kunnen onder meer zijn:
- Namen en e-mailadressen van leden
- Aanwezigheid en boekingsgeschiedenis
- Medewerkersnotities en lid-tags
- Titel en tekst van berichten die je verstuurt
- Omzet-samenvattingen en andere rapportages
Sessy heeft geen controle over hoe die externe aanbieder deze gegevens opslaat, verwerkt of gebruikt. Jij bent verantwoordelijk voor:
- Het kiezen van een AI-dienst die je vertrouwt
- Controleren of voorwaarden en gegevensverwerking voldoen aan de AVG en andere regels
- Tokens alleen afgeven aan medewerkers die ze nodig hebben
- Beperkt — geen lidgegevens gebruiken wanneer de assistent geen leden-workflows nodig heeft
De AI-assistent in de Sessy-app blijft binnen de infrastructuur van Sessy. Een externe AI-agent koppelen is een bewuste keuze om gegevens met een derde partij te delen.
Twijfel je of een aanbieder geschikt is? Koppel dan niet voordat je dit met je juridisch of privacy-adviseur hebt besproken.
Tokens en gebruikslimieten
- Behandel tokens als wachtwoorden — wie het token heeft, kan in je gym als die medewerker handelen
- Dezelfde validatieregels gelden als in de app (sessietypes, locaties, planningsvenster en meer)
- In-app assistent (per sportschool): 60 chatverzoeken per minuut; 30 bevestigde wijzigingen per minuut, 500 per dag (UTC) en 200 per kalendermaand
- MCP-schrijflimieten (per token): 30 mutaties per minuut en 500 per dag (UTC). Een volledige week plannen vanuit terugkerende templates telt als één schrijfactie; een oude week les voor les kopiëren kan de limiet direct raken
- Tokens kunnen de gym niet verwijderen, Admin-rollen toekennen of platformfacturatie wijzigen
- Massaberichten of nieuwsbrieven publiceren vereisen extra zorg