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. De organisatie bezit de leden, de facturatie en de Moodle-verbindingen; je krijgt 30 dagen proef zonder creditcard.

2. Maak een Moodle-verbinding

Open in het paneel Organisatie → Moodle en vul Een Moodle-site verbinden in:

  • een verbindingsslug — kleine letters, cijfers en koppeltekens, bijvoorbeeld main-campus. Hij benoemt deze Moodle in de connector-URL, dus kies iets herkenbaars.
  • de Moodle-URL van de site, via HTTPS.

Het paneel antwoordt met een licentiesleutel en een paneelgeheim, die één keer worden getoond: kopieer ze voordat je de pagina verlaat. Je kunt zo veel verbindingen maken als je abonnement toestaat — de pagina vermeldt hoeveel plaatsen er over zijn. De details staan in je site verbinden.

3. Installeer de plug-in in die Moodle

Open de verbinding uit de lijst en gebruik Plug-in downloaden (.zip). Installeer hem in je Moodle via Sitebeheer → Plug-ins → Plug-ins installeren, open MCP Connector → Licentie en plak de vier waarden: de paneel-URL, de licentiesleutel, het paneelgeheim en de connector-URL van deze verbinding. Klik op Licentie valideren. Zie de Moodle-plug-in.

Terug in het paneel vraagt Nu controleren, op de pagina van de verbinding, live aan Moodle of de webservice antwoordt en de plug-in geïnstalleerd is.

4. Voorzie een gebruiker en krijg een sleutel

Wijs in de sectie Gebruikers van de plug-in een gebruiker toe aan een service die bij zijn rol past. De plug-in maakt een Moodle-token, het paneel maakt daar een MCP-sleutel van (mcpk_…), en de gebruiker krijgt die per e-mail. De waarde wordt één keer getoond.

Eigenaren en beheerders kunnen sleutels ook rechtstreeks aanmaken in Organisatie → Moodle → MCP-sleutels, waarbij ze kiezen bij welke verbinding de sleutel hoort. Een sleutel werkt alleen op zijn eigen verbinding.

5. Verbind je assistent

Elke verbinding heeft zijn eigen connector-URL, in deze vorm:

https://<jouw-organisatie>.slxd.app/mcp/lmsmcp/<verbinding>

Typ hem niet over: de pagina van de verbinding toont hem onder Connector-URL met een kopieerknop, en de lijst met verbindingen ook.

  • ChatGPT of Claude (claude.ai of Claude Desktop): voeg hem toe als externe connector en kies Aanmelden met je Moodle. Geen sleutel te plakken.
  • Cursor, VS Code, Claude Code, scripts: stuur de MCP-sleutel mee in een Bearer-header.

Stap-voor-stapinstructies per client staan in client instellen.

6. Vraag iets

Probeer een van deze om te bevestigen dat alles klopt:

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

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

Als er iets niet werkt

De meeste beginproblemen zitten in de licentievalidatie, de URL van de site of een sleutel die op de verkeerde verbinding is gericht. Zie probleemoplossing.

Snelstart