Met FITsociety kun je AI gebruiken in je dashboard, een externe AI-assistent koppelen of andere software automatiseren. Hieronder kies je welke route bij je past. Daarna vind je uitleg en voorbeelden voor MCP.
Welke route kies je?
Coach AI in FITsociety: werk met de ingebouwde assistent via Coach AI in je dashboard. Je hoeft hiervoor geen externe MCP-koppeling of Public API-client aan te maken. De beschikbaarheid en rechten van Coach AI staan los van je externe koppelingen.
Claude, ChatGPT of een andere AI-app: gebruik MCP om die assistent toegang te geven tot de FITsociety-onderdelen die jij kiest. Begin met Claude koppelen of ChatGPT koppelen.
Andere software of een automatisering: gebruik de Public API en webhooks, bijvoorbeeld met Make of een eigen integratie. Lees de uitleg over de Public API, hoe je een API-koppeling instelt of de Make-handleiding.
Een lid met een eigen AI-assistent: daarvoor gelden aparte Client AI-toegang en ledenrechten. Lees Claude of ChatGPT koppelen aan je FITsociety-app.
Voorlopig extra schrijfacties via MCP. Via de FITsociety MCP-koppeling zijn ook schrijfacties beschikbaar die Coach AI nog niet ondersteunt, bijvoorbeeld eigen oefeningen in je oefenbibliotheek aanmaken of aanpassen. Gebruik hiervoor een gekoppelde externe AI-assistent met de juiste modules, rechten en afzonderlijk toegestane schrijfacties. Lees hoe je MCP instelt en gebruikt. Vraag de assistent eerst welke acties jouw koppeling mag uitvoeren.
Een MCP-sleutel en een Public API-client zijn verschillende toegangsmiddelen. Gebruik steeds de handleiding voor de route die je kiest. Ontwikkelaars vinden de actuele technische documentatie op docs.fitsociety.io.
Wat is een API en wat is een MCP?
Kort gezegd: de API is de deur naar FITsociety, en de MCP is de handleiding waarmee een AI-assistent door die deur kan.
API
API staat voor Application Programming Interface. Het is een vaste manier waarop twee programma's met elkaar praten. Vergelijk het met de bediening in een restaurant: jij loopt de keuken niet in, maar geeft je bestelling door aan de ober. De ober weet precies wat de keuken kan maken en brengt het terug.
De FITsociety API doet hetzelfde. Andere software kan via de API gegevens uit FITsociety opvragen of iets aanpassen, zoals een klant opzoeken of een trainingsschema toevoegen. Dat gebeurt altijd volgens vaste regels en alleen met de rechten die jij geeft.
MCP
MCP staat voor Model Context Protocol. Het is een open standaard waarmee AI-assistenten zoals Claude veilig met andere software kunnen werken. Een MCP vertelt de assistent welke acties er in FITsociety mogelijk zijn, zoals "klant zoeken", "voedingsplan maken" of "bericht versturen", en hoe hij die gebruikt.
Met de FITsociety MCP kan je externe AI-assistent gegevens ophalen en toegestane acties uitvoeren in het gekoppelde FITsociety-bedrijf.
Hoe werkt dat samen?
Jij typt in je AI-assistent een vraag of opdracht in gewone taal.
De assistent bedenkt welke acties in FITsociety daarvoor nodig zijn.
Via de MCP voert hij die acties uit in jouw account, binnen de rechten die je hebt gegeven.
De assistent laat zien wat hij heeft gevonden of gedaan. Jij controleert het en stuurt bij waar nodig.
Wat kun je ermee?
Via de MCP kan je AI-assistent het grootste deel van je dagelijkse coachwerk in FITsociety voor je doen. Welke onderdelen je kunt gebruiken, hangt af van de modules, rechten en toestemming van je koppeling. Vraag je assistent naar de beschikbare tools; een voorbeeld is geen garantie dat die actie in jouw koppeling aan staat.
Onderdeel | Wat de assistent kan | Voorbeeldvraag |
Klanten | Klanten zoeken en aanmaken, profielen, doelen, metingen, intakeformulieren en check-ups bekijken, notities bijhouden | "Wat zijn de doelen van Sanne en hoe zijn haar metingen veranderd?" |
Training | Oefeningen, trainingsschema's en WOD's maken, aanpassen, dupliceren en aan klanten toewijzen; trainingssessies en prestaties inzien | "Maak een full body schema van 3 dagen per week voor beginners." |
Voeding | Voedingsplannen, recepten en supplementen maken en aanpassen, voedingsdoelen instellen, de inname van klanten bekijken, producten opzoeken | "Wat heeft Mark deze week gemiddeld aan eiwit gegeten?" |
Habits | Habit-sjablonen maken, aan klanten koppelen en de voortgang volgen | "Koppel de habit 'dagelijks 8.000 stappen' aan Sanne." |
Agenda en boekingen | Agenda en lessen bekijken, taken beheren, leden op bestaande lessen boeken en aanwezigheid bijwerken | "Wie heeft zich ingeschreven voor de bootcamp van donderdag?" |
Berichten | Gesprekken met klanten lezen en berichten versturen | "Stuur Mark een bericht dat zijn nieuwe schema klaarstaat." |
Overzichten | Samenvattingen van hoe trouw klanten zich aan hun plan houden, en van boekingen, abonnementen, facturen en credits | "Welke klanten hebben deze maand minder dan de helft van hun trainingen gedaan?" |
Je kunt verschillende stappen ook in één opdracht combineren. Bijvoorbeeld: "Zoek Sanne op, maak een trainingsschema op basis van haar intake, wijs het aan haar toe en stuur haar een bericht dat het klaarstaat."
Veiligheid: jij houdt de controle
De koppeling werkt binnen het gekozen bedrijf, de toegestane modules en de toegekende acties. Jij kiest die toegang bij het koppelen.
Alleen je eigen account. De assistent werkt alleen binnen jouw account en het bedrijf dat aan de koppeling is gekoppeld. Gegevens van andere bedrijven zijn nooit zichtbaar.
Alleen je eigen modules. Heb je een module niet, bijvoorbeeld voeding, dan kan de assistent daar ook niets mee.
Gevoelige gegevens. Voor gezondheidsgegevens en privécommunicatie geef je bij het koppelen afzonderlijk toestemming. Je bedrijf is verantwoordelijk voor het delen met de gekozen AI-aanbieder. Een koppeling van een lid vraagt het lid zelf goed te keuren.
Lezen en wijzigen zijn gescheiden. Je kiest of een koppeling alleen mag meekijken, of ook iets mag aanmaken en aanpassen. Wijzigingen kunnen alleen met de rechten die jij daarvoor geeft.
Jij blijft de coach. Een AI-assistent kan fouten maken. Controleer altijd wat hij voorstelt of heeft aangemaakt voordat je het met een klant deelt. Dat geldt zeker voor voeding en training bij blessures, zwangerschap of medische klachten.
Tip: begin met alleen leesrechten. Zo kun je rustig ontdekken wat de assistent kan zonder dat er iets verandert. Zet daarna schrijfrechten aan als je vertrouwd bent met de werking.
De MCP-koppeling instellen
MCP is beschikbaar voor alle FITsociety-bedrijven. Om namens je bedrijf een koppeling goed te keuren, heb je actieve toegang als Manager of Admin nodig. Voor leden blijven aparte Client AI-toegang en de ledeninstellingen van je bedrijf nodig.
Voeg FITsociety toe aan je AI-app. Gebruik de connector-URL
https://mcp.fitsociety.io/mcp/v1. Volg de stappen voor Claude of ChatGPT.Log in bij FITsociety. Kies Doorgaan als coach en selecteer het juiste bedrijf.
Kies wat de assistent mag. Een nieuwe koppeling begint met leesrechten. Kies de onderdelen en, alleen als dat nodig is, de afzonderlijke schrijfacties. Lees hoe je onderdelen, toestemming en schrijfrechten kiest.
Test eerst een leesvraag. Vraag bijvoorbeeld: "Welke FITsociety-tools kun je gebruiken?" en daarna "Welke lessen staan er deze week in mijn agenda?" Selecteer de FITsociety-koppeling in je AI-app als dat nodig is.
Bij deze inlogroute maakt FITsociety de toegang aan nadat je toestemming hebt gegeven. Je hoeft niet vooraf een losse API-sleutel te maken of in de chat te plakken.
Gebruik je een tool die een vaste sleutel nodig heeft? Een Admin kan in Instellingen → AI-koppelingen (MCP) een Nieuwe API-sleutel maken. Volg de uitleg over sleutels en rechten; bewaar de sleutel veilig en zet hem alleen in het beveiligde configuratieveld van je tool.
Je controleert of beëindigt toegang in de lijst met koppelingen bij Instellingen → AI-koppelingen (MCP). Lees hoe je recente tool-aanroepen bekijkt en wat je bij een foutmelding doet.
Voorbeeld: een trainingsschema maken
In dit voorbeeld maak je een krachtschema voor een nieuwe klant, Sanne, en wijs je het aan haar toe. Hiervoor heb je een koppeling met schrijfrechten nodig.
Stap 1: Laat de assistent je klant leren kennen
Begin met een vraag, zodat de assistent de juiste informatie heeft:
Zoek Sanne de Vries op in FITsociety. Vat haar intake, doelen en eventuele blessures samen.
De assistent zoekt Sanne op en zet haar intake en doelen voor je op een rij. Klopt er iets niet of mist er iets? Vul het aan in je volgende bericht.
Stap 2: Vraag om een voorstel
Beschrijf zo concreet mogelijk wat je wilt:
Maak een voorstel voor een trainingsschema voor Sanne: 3 dagen per week, gericht op kracht, ongeveer 60 minuten per training. Ze traint in de sportschool met vrije gewichten en machines. Houd rekening met haar knieklachten. Gebruik oefeningen uit mijn oefeningenbibliotheek. Maak nog niets aan, laat eerst het voorstel zien.
De assistent laat per trainingsdag zien welke oefeningen hij voorstelt, met sets, herhalingen en rust.
Stap 3: Stuur bij
Pas het voorstel aan in gewone taal, net zo vaak als je wilt:
Vervang de lunges door step-ups en voeg op dag 2 een core-oefening toe. Zet de rust bij de compound-oefeningen op 2 minuten.
Stap 4: Laat het schema aanmaken en toewijzen
Tevreden? Geef dan opdracht om het echt in FITsociety te zetten:
Ziet er goed uit. Maak dit schema aan in FITsociety en wijs het vanaf maandag toe aan Sanne.
De assistent maakt het schema aan, vult de trainingsdagen met de oefeningen en wijst het aan Sanne toe. Hij laat weten wanneer het klaar is.
Stap 5: Controleer en laat het weten
Open het schema in FITsociety en loop het nog even na. Daarna kun je de assistent ook het bericht laten versturen:
Stuur Sanne een bericht dat haar nieuwe schema klaarstaat in de app en dat ze vragen altijd mag stellen.
Tip: gebruik je vaker hetzelfde type schema? Laat de assistent het opslaan als sjabloon. Daarna zeg je bijvoorbeeld: "Dupliceer mijn sjabloon 'Kracht beginners 3x' voor Mark en pas het aan voor iemand zonder knieklachten."
Voorbeeld: een voedingsplan maken
In dit voorbeeld maak je een voedingsplan voor Mark, die wil afvallen en spier wil behouden. Hiervoor heb je de voedingsmodule en een koppeling met schrijfrechten nodig.
Stap 1: Breng de uitgangssituatie in kaart
Zoek Mark Jansen op. Wat zijn zijn doelen, zijn huidige gewicht en zijn voedingsdoelen? En wat heeft hij de afgelopen week gemiddeld gegeten?
De assistent haalt Marks doelen, metingen en ingestelde voedingsdoelen op, en vat zijn gelogde inname samen. Zo zie je meteen waar de grootste winst zit.
Stap 2: Stel de voedingsdoelen in
Bepaal zelf de doelen, of laat de assistent een voorstel doen dat jij controleert:
Stel voor Mark de volgende dagelijkse doelen in: 2.200 kcal, 170 gram eiwit, 220 gram koolhydraten en 70 gram vet.
Stap 3: Vraag om een voorstel voor het plan
Maak een voorstel voor een voedingsplan voor Mark dat past binnen deze doelen: ontbijt, lunch, avondeten en twee tussendoortjes. Hij eet geen vis en heeft weinig tijd om te koken, dus houd het simpel. Gebruik waar mogelijk recepten uit mijn receptenbibliotheek. Maak nog niets aan.
De assistent laat per maaltijd zien wat hij voorstelt, met de hoeveelheden en de totale calorieën en macro's per dag.
Stap 4: Stuur bij
Vervang de kwark bij het ontbijt door havermout met whey, en maak de lunch op werkdagen iets dat hij mee kan nemen. Klopt het eiwit dan nog?
De assistent past het plan aan en rekent opnieuw na of het binnen de doelen valt.
Stap 5: Laat het plan aanmaken en controleer het
Prima. Maak dit voedingsplan aan in FITsociety voor Mark en controleer of het klopt met zijn doelen.
De assistent maakt het plan aan en controleert het tegen de ingestelde doelen. Wijkt een dag te veel af, dan meldt hij dat. Open het plan daarna zelf in FITsociety om het na te lopen.
Stap 6: Volg de voortgang
Na een week of twee kun je snel checken hoe het gaat:
Hoe goed houdt Mark zich de afgelopen twee weken aan zijn voedingsplan? Op welke dagen wijkt hij het meest af?
Tip: maak je een nieuw recept voor een klant, laat de assistent het dan ook in je receptenbibliotheek opslaan. Zo kun je het later voor andere klanten hergebruiken.
Meer voorbeeldvragen en tips
Voorbeeldvragen
Klanten en voortgang
"Welke klanten hebben hun check-up van deze week nog niet ingevuld?"
"Vat de laatste drie check-ups van Sanne samen en zet een notitie in haar dossier."
"Hoe is het gewicht van Mark de afgelopen drie maanden veranderd?"
Training en WOD's
"Maak een WOD voor zaterdag: een AMRAP van 20 minuten met kettlebells en roeien, en publiceer hem."
"Welke trainingen heeft Sanne deze maand afgerond en wat waren haar zwaarste squats?"
Agenda en boekingen
"Bekijk welke afspraken volgende week dinsdag om 18:00 in mijn agenda staan."
"Hoeveel mensen zaten er deze maand gemiddeld in mijn groepslessen?"
Administratie
"Geef me een overzicht van de openstaande facturen."
"Welke abonnementen lopen de komende maand af?"
"Hoeveel credits heeft Mark nog?"
Tips voor goede opdrachten
Wees concreet. Noem de klant bij volledige naam, en geef aantallen, dagen, tijden en doelen mee.
Geef context. Vertel over blessures, voorkeuren, beschikbaar materiaal en hoeveel tijd je klant heeft.
Vraag eerst om een voorstel. Zeg "maak nog niets aan" als je eerst wilt zien wat de assistent van plan is.
Stuur bij in gewone taal. Je hoeft niet opnieuw te beginnen; zeg gewoon wat er anders moet.
Controleer het resultaat. Kijk in FITsociety of alles klopt voordat je het met je klant deelt.
Werk in stappen bij grote klussen. Doe eerst één klant goed voordat je de assistent vraagt hetzelfde voor tien klanten te doen.
Wat (nog) niet kan
Facturen en betalingen aanmaken. Facturen en abonnementen kun je bekijken en laten samenvatten. Credits kun je bekijken en, met schrijfrechten, ook aanpassen. Facturen aanmaken of betalingen verwerken doe je zoals altijd in FITsociety zelf.
Abonnementen en bankgegevens importeren uit een ander systeem. Leden kun je met schrijfrechten wel laten importeren uit een CSV- of Excel-bestand. Abonnementen, bankgegevens en andere financiële gegevens importeer je niet via de MCP. Stap je over vanuit een ander systeem? Neem contact met ons op, dan helpen we je met de overstap.
Medisch advies. De assistent is een hulpmiddel voor jouw werk als coach, geen arts of diëtist. Bij medische klachten blijft jouw eigen oordeel en dat van een specialist leidend.
Buiten je modules of rechten werken. Wat je koppeling en de toepasselijke toegangsrechten niet toestaan, kan de assistent ook niet.
Mis je iets? Zet het op de wensenlijst
Mis je een mogelijkheid in Coach AI, MCP of de publieke API? Dien hiervoor een wishlistverzoek in. Zoek eerst op de wishlist of je wens al bestaat en stem daarop mee. Kies bij een nieuwe wens AI, API & automatiseringen en vervolgens Coach AI, API-koppeling of Automatisering / MCP. Beschrijf wat je wilt bereiken, welke gegevens of actie je nodig hebt en geef een anoniem praktijkvoorbeeld. Lees hoe je een goed wishlistverzoek indient.
Kan je gekoppelde MCP-assistent een API- of MCP-wens voor je indienen of op een bestaande wens stemmen? Laat hem eerst zoeken en geef akkoord voor het publiceren of stemmen. Daarvoor moeten het onderdeel Wishlist en de bijbehorende schrijfactie zijn toegestaan. Je kunt ook altijd zelf het wishlistformulier gebruiken. Een wens op de lijst is geen garantie dat we hem bouwen of wanneer. De wishlist is openbaar: voeg geen klantgegevens of andere gevoelige informatie toe.
Veelgestelde vragen
Welke AI-assistent heb ik nodig?
Een assistent die MCP-koppelingen ondersteunt, zoals Claude. Bij sommige assistenten heb je daarvoor een betaald abonnement nodig.
Kost de MCP extra?
Neem contact met ons op, dan vertellen we je wat de mogelijkheden zijn binnen jouw pakket.
Kan de assistent per ongeluk iets verwijderen of aanpassen?
Met een koppeling met alleen leesrechten kan hij niets wijzigen. Met schrijfrechten kan hij de afzonderlijk toegestane acties uitvoeren binnen het gekoppelde bedrijf en de gekozen modules. Vraag daarom eerst om een voorstel en controleer het resultaat.
Zien mijn klanten dat ik een AI-assistent gebruik?
Nee, niet vanzelf. Een schema, plan of bericht dat de assistent maakt, staat gewoon in FITsociety, net als wanneer je het zelf maakt.
Wat gebeurt er met de gegevens van mijn klanten?
De assistent krijgt resultaten uit de onderdelen waarvoor jij toegang hebt verleend. Voor gezondheidsgegevens en privécommunicatie is extra toestemming nodig. Je bedrijf blijft verantwoordelijk voor de gegevensdeling. Lees de uitleg over MCP en privacy en de privacyvoorwaarden van je AI-aanbieder.
Ik krijg een foutmelding. Wat nu?
Controleer of je de juiste koppeling gebruikt en of de benodigde module, toestemming en schrijfactie zijn toegestaan. Een verlopen login of sleutel vraagt om opnieuw koppelen. Lees MCP-foutmeldingen oplossen voor de foutcode en vervolgstappen.