Naar hoofdinhoud
Documentatie

Snelstart

Voordat je begint

Controleer de vereisten: Moodle 4.2 of hoger, publiek bereikbaar via HTTPS, webservices ingeschakeld en sitebeheerdersrechten.

1. Maak je organisatie aan

Registreer je en maak een organisatie aan. Een organisatie hoort bij één Moodle-installatie en is eigenaar van de verbinding, de sleutels en de facturatie. Je krijgt 30 dagen proef zonder creditcard.

2. Verbind je Moodle-site

Open in het paneel Organisatie → Moodle en vul de URL van je Moodle in. Je krijgt een licentiesleutel en een paneelgeheim — deze worden één keer getoond: kopieer ze voordat je de pagina verlaat — samen met de URL van je MCP-eindpunt. De details staan in je site verbinden.

3. Installeer de plug-in

Installeer local_mcpconnector in je Moodle via Sitebeheer → Plug-ins → Plug-ins installeren, open MCP Connector → Licentie en plak de vier waarden die het paneel toont: de paneel-URL, de licentiesleutel, het geheim en de URL van het MCP-eindpunt. Klik op Licentie valideren. Zie de Moodle-plug-in.

4. Geef een gebruiker toegang en haal een sleutel op

Wijs in het onderdeel Gebruikers van de plug-in een gebruiker toe aan een service op basis van diens rol. De plug-in genereert een Moodle-token, het paneel zet dat om in een MCP-sleutel (mcpk_…) en de gebruiker ontvangt hem per e-mail. De waarde wordt één keer getoond.

Eigenaren en beheerders kunnen sleutels ook rechtstreeks uitgeven in Organisatie → Moodle → MCP-sleutels.

5. Verbind je assistent

Wijs je assistent naar het eindpunt van je organisatie:

https://<jouw-organisatie>.moodlemcp.com/mcp
  • ChatGPT of Claude (claude.ai of Claude Desktop): voeg het toe als externe connector en kies Aanmelden met je Moodle. Er is geen sleutel om te plakken.
  • Cursor, VS Code, Claude Code, scripts: stuur de MCP-sleutel mee als Bearer-header.

Stap voor stap per client staat in client instellen.

6. Stel een vraag

Probeer een van deze om te bevestigen dat alles verbonden is:

  • "Voor welke cursussen ben ik ingeschreven?"
  • "Toon de deelnemers van de cursus Inleiding tot de biologie."
  • "Welke opdrachten moeten de komende twee weken worden ingeleverd?"

Wil je liever geen client instellen, open dan de AI-chat van het paneel: dezelfde tools, zonder enige instelling.

Als iets niet werkt

De meeste beginnersproblemen zitten in de licentievalidatie of de site-URL. Zie problemen oplossen.