AI-koppeling via MCP

Curriculate biedt een Model Context Protocol (MCP)-server waarmee Claude rechtstreeks kan lezen in — en schrijven naar — het curriculum van jouw school, zonder dat een ontwikkelaar de API handmatig hoeft te bevragen.

De assistent krijgt toegang tot de opleidingen, modules, leeruitkomsten en het SBB-kwalificatieraamwerk van jouw tenant.

Wat is MCP?

Het Model Context Protocol is een open standaard voor het koppelen van AI-modellen aan externe databronnen en tools. Een MCP-server beschrijft welke acties beschikbaar zijn; de AI-assistent kiest zelf welke acties hij aanroept op basis van wat de gebruiker vraagt.

Overzicht

Beschikbare tools

De Curriculate MCP-server biedt de volgende tools. De assistent kiest automatisch welke hij aanroept.

Lezen

Tool	Wat het doet
list-opleidingen	Alle opleidingen van jouw tenant ophalen, optioneel gefilterd op naam/code.
get-opleiding-structuur	Volledige boom van jaargangen, periodes en modules van één opleiding.
get-opleiding-raamwerk	Het SBB-kwalificatiedossier met kerntaken en werkprocessen.
get-werkproces	Details van één werkproces (omschrijving, prestatie-indicatoren).
search-modules	Modules zoeken op naam, code of omschrijving, met paginering.
get-module	Volledige details van één module: leeruitkomsten, toetsen, werkprocessen.
search-learning-outcomes	Leeruitkomsten doorzoeken binnen een opleiding.

Schrijven

Tool	Wat het doet
create-module	Nieuwe module aanmaken in een periode, optioneel met leeruitkomsten.
update-module	Bestaande module bijwerken (naam, EC, leeruitkomsten, etc.).
create-learning-outcome	Leeruitkomst toevoegen aan een bestaande module.
update-learning-outcome	Leeruitkomst bijwerken.
create-assessment	Toets toevoegen aan een module.
update-assessment	Toets bijwerken.

Schrijftoegang

De assistent kan wijzigingen doorvoeren in het curriculum. Gebruik schrijftools alleen als de assistent de juiste context heeft, en controleer wijzigingen daarna in Curriculate zelf.

Verbinden

Koppelen aan Claude

De koppeling verloopt via claude.ai in de browser — geen installatie of technische configuratie vereist.

1. Ga naar claude.ai en log in.

2. Klik op het Customize-icoon in de linkerzijbalk (de aktetas) en ga naar het tabblad Connectors.

3. Klik op de +-knop rechtsboven in het Connectors-paneel en kies Add custom connector. Voer de MCP-server URL in:

   https://curriculate.nl/mcp

4. Klik op “Connect”. Je wordt doorgestuurd naar de Curriculate inlogpagina om de koppeling te autoriseren. Log in met je Curriculate-account en geef de assistent toegang tot jouw tenant.

5. Test de koppeling door Claude te vragen:

   “Wat zijn de opleidingen in Curriculate?”

   Claude roept list-opleidingen aan en toont de resultaten.

Beperkingen

Wat de MCP-koppeling niet doet

• Geen gebruikersbeheer. Aanmaken, uitschakelen of verwijderen van gebruikers gaat via SCIM-provisioning, niet via MCP.
• Geen real-time push. De assistent haalt data op op het moment van bevragen; hij ontvangt geen notificaties bij wijzigingen.
• Snelheidslimiet: 60 verzoeken per minuut per ingelogde gebruiker. Bij intensief gebruik kan de assistent tijdelijk vertragen.

Troubleshooting

Veelvoorkomende problemen

Probleem	Oorzaak & oplossing
Connector verschijnt niet na toevoegen	Ververs de pagina. Controleer of de URL exact https://curriculate.nl/mcp is.
Autorisatie mislukt	Verwijder de connector en voeg hem opnieuw toe. Log daarna opnieuw in via de Curriculate-inlogpagina.
401 bij elke aanroep	Het OAuth-token is verlopen of ingetrokken. Verwijder de connector en voeg hem opnieuw toe.
429 Too Many Requests	Snelheidslimiet (60 req/min) overschreden. Wacht even en probeer opnieuw.
Geen data, wel verbinding	De ingelogde gebruiker heeft geen actieve tenant of heeft geen rechten binnen de tenant.

Combineer met SSO

Voor de beste gebruikerservaring stel je SSO via Microsoft Entra ID in. Medewerkers autoriseren de MCP-koppeling dan met hetzelfde account waarmee ze al inloggen op Office 365 — geen extra wachtwoord of magic link.