Met de FITsociety MCP en API koppel je je FITsociety-account aan een AI-assistent zoals Claude. Daarna regel je je coachwerk in gewone taal: je typt wat je nodig hebt, en de assistent doet het voor je in FITsociety.
In dit artikel lees je:
wat een API en een MCP eigenlijk zijn
wat je ermee kunt
hoe je de koppeling instelt
hoe je stap voor stap een trainingsschema en een voedingsplan maakt
wat (nog) niet kan, en antwoorden op veelgestelde vragen
Dit artikel is bedoeld voor coaches en sportschooleigenaren die met FITsociety werken. Technische kennis heb je niet nodig.
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.
Zonder MCP kan een AI-assistent alleen praten en adviseren. Met de MCP kan hij ook echt dingen voor je doen in je eigen FITsociety-account.
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 jij kunt gebruiken, hangt af van de modules in je account.
Onderdeel | Wat de assistent kan | Voorbeeldvraag |
Klanten | Klanten zoeken en aanmaken, profielen, doelen, metingen, intakeformulieren en check-ins 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?" |
Gewoontes | Gewoontesjablonen maken, aan klanten koppelen en de voortgang volgen | "Koppel de gewoonte 'dagelijks 8.000 stappen' aan Sanne." |
Agenda en boekingen | Lessen, afspraken en taken bekijken en plannen, boekingen maken 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 kan nooit meer dan jij zelf in FITsociety mag, en je bepaalt zelf hoeveel hij mag.
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.
Toestemming van je klanten. Gegevens van klanten zijn alleen beschikbaar binnen de toestemming die zij hebben gegeven. Ontbreekt die, dan kan de assistent die gegevens niet inzien.
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 koppeling instellen
Je koppelt FITsociety in een paar minuten aan je AI-assistent. Je hebt een assistent nodig die MCP-koppelingen ondersteunt, zoals Claude.
Beschikbaarheid: de MCP gaat na het webinar van 6 november voor iedereen live. Wil je er nu al mee werken? Stuur ons een bericht, dan zetten we hem alvast aan in je account.
Stap 1: Open de MCP-pagina in FITsociety
Open in FITsociety de MCP-pagina. Bij Connectiegegevens vind je het endpoint (het webadres van de koppeling) en een configuratievoorbeeld dat je kunt kopiëren. Zie je de pagina niet? Dan is de MCP nog niet geactiveerd in je account. Stuur ons een bericht, dan helpen we je verder.
Stap 2: Maak een sleutel aan en kies de rechten
Maak op dezelfde pagina een nieuwe sleutel (token) aan. Kies daarbij wat de koppeling mag:
Alleen lezen: de assistent kan gegevens bekijken en samenvatten, maar niets aanpassen.
Lezen en schrijven: de assistent kan ook schema's, plannen, notities, berichten en afspraken aanmaken en wijzigen.
Kopieer de sleutel en bewaar hem veilig. Deel hem met niemand: wie de sleutel heeft, kan bij je account met de rechten die je hebt gekozen.
Stap 3: Voeg de koppeling toe aan je AI-assistent
Voeg in je AI-assistent een nieuwe MCP-koppeling toe:
Geef de koppeling een herkenbare naam, bijvoorbeeld FITsociety.
Plak het endpoint uit stap 1 als adres. Kies als verbindingstype Streamable HTTP als je assistent daarom vraagt.
Voeg je sleutel toe zoals het configuratievoorbeeld uit FITsociety aangeeft. Vervang daarin de tijdelijke tekst door je eigen sleutel.
Sla op en laat de assistent de beschikbare acties ophalen.
Stap 4: Test de koppeling
Stel een eenvoudige vraag, bijvoorbeeld: "Welke klanten heb ik in FITsociety?" of "Wat staat er vandaag in mijn agenda?" Krijg je antwoord met je eigen gegevens, dan werkt de koppeling.
Werkt het niet? Controleer of je de sleutel volledig hebt gekopieerd, of de koppeling in je assistent aanstaat en of de MCP al in je account is geactiveerd.
Sleutel intrekken
Wil je de toegang stoppen, bijvoorbeeld omdat je sleutel is uitgelekt of je een andere assistent gaat gebruiken? Trek de sleutel dan in op de MCP-pagina in FITsociety. De koppeling werkt daarna direct niet meer.
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-in van deze week nog niet ingevuld?"
"Vat de laatste drie check-ins 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
"Plan volgende week dinsdag om 18:00 een intakegesprek met Lisa."
"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, abonnementen en credits kun je bekijken en laten samenvatten. Facturen aanmaken of betalingen verwerken doe je zoals altijd in FITsociety zelf.
Klanten en abonnementen importeren uit een ander systeem. 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 account of je sleutel niet toestaat, kan de assistent ook niet.
Mis je iets? Zet het op de wensenlijst
Kan de assistent iets nog niet? Vraag het hem gewoon. Als het echt om een ontbrekende functie gaat, biedt hij aan je idee op onze wensenlijst te zetten. Andere coaches kunnen daarop stemmen, zodat wij zien wat het meest gevraagd wordt. Een wens op de lijst is geen garantie dat we hem bouwen, en ook geen toezegging over wanneer. Op de wensenlijst komen nooit klantgegevens of persoonlijke informatie te staan.
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 sleutel met alleen leesrechten kan hij niets wijzigen. Met schrijfrechten kan hij wel dingen aanmaken en aanpassen, maar alleen binnen jouw account en 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 kan alleen gegevens inzien waarvoor je klanten toestemming hebben gegeven, en alleen binnen jouw account. Lees ook de privacyvoorwaarden van de AI-assistent die je gebruikt.
Ik krijg een foutmelding. Wat nu?
Controleer eerst de sleutel, de rechten en of de koppeling in je assistent aanstaat. Krijg je een melding over ontbrekende rechten, dan heeft je sleutel waarschijnlijk alleen leesrechten. Kom je er niet uit? Neem contact op met onze support.
Waar kan ik het in actie zien?
Tijdens ons webinar op vrijdag 6 november om 13:00 laten we aan de hand van een praktijkcase zien hoe je de MCP gebruikt. Wil je erbij zijn? Stuur ons een bericht, dan zorgen we dat je de uitnodiging krijgt.