MoveMentors stelt een Model Context Protocol (MCP) server beschikbaar. Als je Claude, ChatGPT (met Claude API-integraties), Cursor of een andere MCP-compatibele AI-assistent gebruikt, kun je ze met je account verbinden om dingen te vragen zoals:
- "Wat zijn mijn boekingen voor volgende week?"
- "Annuleer mijn zaterdagles en e-mail iedereen die geboekt had."
- "Voeg een dinsdagochtend yogales toe voor dezelfde prijs als mijn donderdag."
- "Stuur een bedankje naar klanten die in de afgelopen 30 dagen zijn geweest."
De MCP-server is algemeen beschikbaar voor Pro- en Premium-accounts.
Wat MCP is
Het Model Context Protocol is een open standaard waarmee AI-assistenten kunnen praten met externe tools. Oorspronkelijk gebouwd door Anthropic (de mensen achter Claude); nu overgenomen door ChatGPT, Cursor en anderen.
Voor MoveMentors betekent MCP dat je AI-assistent kan:
- Je boekingen, lessen, klanten zien (leestoegang).
- Nieuwe boekingen maken, lessen aanpassen, berichten sturen (schrijftoegang).
- Alles afgeschermd door OAuth-permissies die jij verleent.
Hoe het werkt
- Je gaat naar de instellingen van je AI-assistent (Claude Desktop, ChatGPT, enz.) en voegt MoveMentors toe als MCP-server.
- De assistent opent een OAuth-flow in je browser.
- Je logt in bij MoveMentors en verleent specifieke permissies (boekingen lezen, lessen schrijven, enz.).
- De assistent krijgt een token dat hij bij verzoeken meestuurt.
- Je kunt de assistent nu vragen om dingen te doen in je account.
Geen API-sleutels, geen credentials in platte tekst. OAuth regelt de auth.
Claude Desktop verbinden
Open Claude Desktop
De desktop-app voor Claude.
Ga naar Settings → Developer
Zoek de "MCP servers" sectie.
Voeg een nieuwe MCP-server toe
Klik op "Add server" en kies "Connect via OAuth".
Voer de MoveMentors MCP-URL in
https://movementors.com/api/mcpGeef toestemming
Claude opent een browservenster. Je logt in bij MoveMentors en ziet een toestemmingsscherm met de aangevraagde permissies.
Kies welke permissies je verleent
Je kunt specifieke scopes weigeren als je wilt beperken wat Claude kan doen. Je kunt bijvoorbeeld "boekingen lezen" verlenen maar "lessen schrijven" weigeren als je wilt dat Claude alleen kan opvragen maar niet aanpassen.
Klik op 'Approve'
Je keert terug naar Claude. De server is nu verbonden.
Begin met gebruiken
Praat tegen Claude zoals gewoonlijk. Hij heeft nu tools om je MoveMentors-account te bevragen en aan te passen.
ChatGPT verbinden
ChatGPT ondersteunt MCP-servers via de Anthropic API met Claude als model. De exacte UI verschilt van Claude Desktop, maar de OAuth-flow is hetzelfde.
Als je AI-assistent MCP ondersteunt, heeft hij ergens een vergelijkbare "Add MCP server" optie. De URL is altijd https://movementors.com/api/mcp.
Beschikbare tools (wat de AI kan doen)
De MCP-server stelt zo'n 20 tools beschikbaar. Een paar highlights:
whoami: wie is de huidige gebruiker (geeft je accountinfo terug).search_mentors,search_studios,search_classes: bevraag de openbare directory.get_mentor: krijg het volledige profiel van een specifieke mentor.list_my_bookings: je boekingen (als student of host).book_class: maak een boeking aan.cancel_booking: annuleer een boeking.list_my_classes: je gehoste lessen.update_class,delete_class: pas gehoste lessen aan.add_class_schedule: voeg een sessie toe aan een bestaande les.list_class_bookings: wie is geboekt voor een specifieke sessie.financials_summary: je verdiensten-overzicht.list_expenses,create_expense,update_expense,delete_expense: uitgaven bijhouden.send_mentor_inquiry: stuur een direct bericht.list_received_mentor_inquiries: zie binnenkomende berichten.
De assistent kiest de juiste tool voor je verzoek. Je hoeft de toolnamen niet te kennen.
Permissies en scopes
Permissies zijn granulair. Je kunt elke scope individueel verlenen of weigeren tijdens de OAuth-flow. Zie OAuth-scopes voor de volledige lijst en wat elke scope toestaat.
Veelvoorkomende scope-groeperingen:
- Alleen lezen: zie alles, verander niets. Handig om te testen.
- Boekingenbeheer: bekijk en wijzig boekingen, maar geen lessen.
- Volledige controle: alles.
Je kunt permissies op elk moment intrekken op /settings/connected-apps.
Use cases
"Toon mij mijn komende week"
De assistent gebruikt list_my_bookings en list_my_classes om een week aan events op te halen, geordend per dag. Je stelt vervolgvragen zoals "welke staan nog open qua betaling?".
"Annuleer zaterdag en betaal iedereen terug"
De assistent gebruikt list_class_bookings om de betrokken boekingen op te halen, daarna cancel_booking op elk. Terugbetalingen voor Stripe-betalingen worden automatisch verwerkt.
"Voeg een nieuwe les toe die lijkt op die van dinsdag maar op donderdag"
De assistent gebruikt get_class om de details van de dinsdagles op te halen, daarna create_class met dezelfde velden maar een ander rooster.
"Wat was mijn beste maand qua omzet?"
De assistent gebruikt financials_summary om maandtotalen op te halen en rapporteert terug.
"Stuur een bedankje naar iedereen die afgelopen weekend is geweest"
De assistent gebruikt list_my_bookings gefilterd op afgelopen weekend met status COMPLETED, daarna send_mentor_inquiry of vergelijkbaar om gepersonaliseerde berichten naar elk te sturen.
Beveiliging
Een paar dingen om te weten:
OAuth-scopes zijn de grens
De assistent kan niets buiten de scopes die jij hebt verleend. Als je alleen leestoegang hebt verleend, geven schrijfpogingen permissiefouten terug.
Elk verzoek wordt gelogd
We loggen elk MCP-verzoek: welke tool, welke argumenten, het resultaat. Zichtbaar in /settings/audit-log. Handig als je wilt weten wat de assistent heeft gedaan.
Tokens kunnen worden ingetrokken
/settings/connected-apps toont elke verbonden OAuth-client. Trek op elk moment in; de assistent verliest direct toegang.
Rate limits
We hanteren een rate limit per token. Een normale assistent die conversatie-verzoeken doet blijft ruim onder de limiet. Een assistent die je hele boekingsgeschiedenis in één keer probeert op te halen kan de limiet raken; hij probeert opnieuw met backoff.
Sandboxing
De meeste MCP-clients (Claude Desktop, enz.) draaien als aparte processen. Ze kunnen je andere bestanden niet lezen of je browser kapen. De verbinding met ons gaat over HTTPS met token-auth.
Beperkingen
Sommige tools zijn afgeschermd:
book_class: vereist Pro-tier. De gratis tier biedt alleen-lezen.update_class,delete_class,add_class_schedule: Pro-tier.financials_summaryen expense-tools: Pro-tier.
Als je op gratis zit en een afgeschermde tool probeert te gebruiken, krijg je een duidelijke foutmelding van de assistent.
Veelgestelde vragen
Deelt de assistent mijn gegevens met anderen? De assistent draait lokaal (Claude Desktop) of in de omgeving van je provider (Claude.ai web). Gegevens die hij leest uit MoveMentors blijven in jouw gesprek; ze worden niet gedeeld met andere gebruikers.
Het privacybeleid van Anthropic is van toepassing op wat zij doen met je gespreksgegevens. Daar hebben wij geen controle over.
Kan de assistent mijn wachtwoord zien? Nee. OAuth betekent dat de assistent nooit je wachtwoord ziet. Hij heeft een token dat ingetrokken kan worden.
Kan de assistent dingen achter mijn rug om doen? De assistent handelt alleen wanneer jij hem dat opdraagt (in een gesprek). Hij draait niet op de achtergrond, tenzij je een automatisering opzet. Elke actie wordt gelogd.
Wat als de assistent een fout maakt? Je kunt het audit log bekijken en de meeste acties ongedaan maken:
- Geannuleerde boekingen kunnen opnieuw geboekt worden (als er nog plekken zijn).
- Verwijderde lessen kunnen opnieuw worden aangemaakt (de assistent heeft de gegevens).
- Verzonden berichten kunnen niet teruggetrokken worden.
Behandel de assistent als een junior medewerker met toegang. Vertrouw maar verifieer.
Wordt MCP-ondersteuning in de loop van de tijd beter? Ja. We voegen nieuwe tools toe naarmate MCP zelf evolueert. Abonneer je op onze nieuwsbrief of check de changelog voor updates.
Volgende stappen
- OAuth-scopes: het permissiemodel.
- Probeer het uit: verbind Claude Desktop en vraag "toon mij mijn komende week".