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

  1. Kies een geschikte AI-tool
  2. Maak een toegangstoken aan in Sessy
  3. Koppel je AI-tool
  4. 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

  1. Log in als Admin
  2. Open Configuratie → Sessy AIExterne toegang (MCP)
  3. Geef het token een naam, kies de medewerker voor wie het is, stel token-toegang in (Admin of Medewerker), en kies gegevenstoegang
  4. Kopieer het token direct — het wordt maar één keer getoond
  5. Geef het token aan die medewerker voor hun AI-tool
  6. 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.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
Connect me to Sessy (my gym admin platform).

- Server URL: https://mcp.sessy.app
- Transport: Streamable HTTP (JSON-RPC POST)
- Auth: Bearer token in the Authorization header
- My token: YOUR_TOKEN_HERE

Add this connection in my environment (Claude MCP settings, ChatGPT custom connector, Cursor mcp.json, Grok or Gemini MCP settings, OpenClaw/Hermes MCP config, or equivalent). Use the token only for this connection.

When you are done, confirm it works by listing the available Sessy tools.

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)

  1. Ga naar claude.ai en log in.
  2. Open InstellingenConnectors, Integraties of MCP.
  3. Voeg een custom connector of MCP-server toe.
  4. Plak URL https://mcp.sessy.app en je Sessy-token (Bearer token of API-sleutel).
  5. Sla op en start een nieuwe chat.

Claude desktop: Instellingen → Connectors / MCP → custom server.

ChatGPT

  1. Open chat.openai.com en log in.
  2. InstellingenConnectors of Apps.
  3. Voeg een custom connector of MCP-verbinding toe met URL en token.
  4. Sla op en test in een nieuwe chat.

Grok

  1. Open grok.com en log in.
  2. Zoek MCP, connectors of integraties in instellingen.
  3. Voeg een custom MCP-server toe met URL https://mcp.sessy.app en je Sessy-token.
  4. Sla op en test in een nieuwe chat.

Gemini

  1. Open gemini.google.com en log in.
  2. InstellingenExtensies, Apps of MCP.
  3. Voeg een custom verbinding toe met URL en token.
  4. Sla op en test in een nieuwe chat.

Cursor

  1. Installeer Cursor en log in.
  2. Cursor SettingsMCP.
  3. Voeg server sessy toe 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