De licentievalidatie mislukt
"Ongeldige gegevens" — de licentiesleutel en het paneelgeheim moeten het paar zijn dat voor die verbinding samen is uitgegeven. Heb je de gegevens vernieuwd, dan heeft de plug-in nog het oude paar: plak het nieuwe. Kopieerde je maar één waarde voordat je de pagina verliet, vernieuw dan om een vers paar te krijgen. Beheer je meerdere Moodles, controleer dan of je niet het paar van een andere verbinding hebt geplakt.
"URL komt niet overeen" — de site die belt komt niet overeen met de URL die voor de verbinding is geregistreerd. Vaak wanneer Moodle achter een proxy staat en $CFG-wwwroot afwijkt van de publieke hostnaam, of na een domeinwijziging. Werk de URL bij vanaf de rij van de verbinding in Organisatie → Moodle en valideer opnieuw.
De plug-in bereikt het paneel helemaal niet — je Moodle heeft uitgaand HTTPS nodig. Test curl https://lmsmcp.slxd.app vanaf de server en controleer de proxyinstellingen in Moodle.
De site kan niet verbonden worden
"URL niet toegestaan" — de URL moet publiek HTTPS zijn met een geldig certificaat. localhost, private reeksen en hosts die alleen via VPN bereikbaar zijn worden bewust geweigerd. Een testsite mag, zolang die publiek bereikbaar is.
Certificaatfouten — een zelfondertekend of verlopen certificaat komt niet door de validatie. Repareer het certificaat; er is geen omweg.
Geen verbindingsplaatsen meer — je abonnement bepaalt hoeveel Moodle-sites een organisatie mag verbinden; de verbindingenpagina vermeldt hoeveel er over zijn. Verwijder een verbinding die je niet meer gebruikt of stap over naar een ander abonnement in Organisatie → Facturatie.
De assistent zegt dat hij geen tools heeft
- De client heeft zijn MCP-configuratie niet herladen. Herstart hem.
- De URL klopt niet: het moet de connector-URL van die verbinding zijn — het subdomein van je organisatie, dan /mcp/lmsmcp/ en de slug van de verbinding. Kopieer hem van de pagina van de verbinding in plaats van hem over te typen.
- Met een Bearer-sleutel: controleer dat de header exact Authorization: Bearer mcpk_… is en dat de sleutel niet is opgeschort, ingetrokken of verlopen.
- Met OAuth: verwijder de connector en autoriseer opnieuw.
De assistent antwoordt over de verkeerde Moodle, of wordt geweigerd
Elke sleutel hoort bij één verbinding en werkt alleen op de connector-URL daarvan. De sleutel van de ene Moodle gebruiken op de URL van een andere wordt afgewezen. Controleer op de pagina van de verbinding of de sleutel die je gebruikt daar in de lijst staat.
De verbinding toont "Plug-in ontbreekt" of "Niet bereikbaar"
Nu controleren, op de pagina van de verbinding, vraagt het live aan je Moodle:
- Plug-in ontbreekt — Moodle antwoordde, maar de connector-plug-in is daar niet geïnstalleerd. Download hem met Plug-in downloaden (.zip) en installeer hem.
- Niet bereikbaar — Moodle antwoordde niet: de site ligt eruit, de URL is gewijzigd, of het token van de sleutel die voor de controle is gebruikt geldt niet meer in Moodle.
- Geen actieve sleutel — de controle heeft een token nodig, maak dus eerst een sleutel voor die verbinding aan.
De assistent ziet niets in Moodle
De sleutel werkt, maar de onderliggende Moodle-gebruiker heeft geen toegang tot wat je vraagt. Rollen zijn de buitenste grens — de sleutel van een student kan de deelnemers van een cursus niet opsommen. Controleer voor welke gebruiker de sleutel is gemaakt en of de sleutel beperkt is tot alleen lezen, tot bepaalde tools of tot bepaalde cursussen. Zie sleutels en rechten.
"Access control exception" bij aanmaken of bewerken
De rol van een sleutel wordt één keer sitebreed gecontroleerd; Moodle controleert rechten per cursus. Een sleutel van een docent met bewerkingsrechten mag de tool gebruiken, maar Moodle weigert die in een cursus waar die gebruiker geen bewerkende docent is. Controleer of de gebruiker voor wie de sleutel is gemaakt:
- in die cursus is ingeschreven met een rol die de bevoegdheid moodle/course:manageactivities geeft (activiteiten maken en bewerken);
- de cursus kan zien, als die verborgen is.
Hem in de cursus inschrijven, of hem een rol met die bevoegdheid geven, lost de fout op. Zie sleutels en rechten.
Aanroepen gingen mislukken nadat ze eerst werkten
- De sleutel is opgeschort of ingetrokken, in het paneel of vanuit de plug-in.
- De gegevens van de verbinding zijn vernieuwd en de plug-in is niet bijgewerkt.
- De Moodle-gebruiker verloor de rol waarop de sleutel steunt, of is verwijderd.
- Het token is in Moodle verwijderd via Sitebeheer → Server → Webservices → Tokens beheren.
De pagina van de verbinding toont het gebruik en de fouten per sleutel en per tool, en Organisatie → Moodle → Gebruik toont de hele organisatie; samen wijzen ze het probleem meestal in seconden aan.
Een bestand wil niet uploaden
De URL moet het bestand teruggeven, niet een pagina eromheen. Test met curl -IL url van buiten je netwerk. Google Drive, Dropbox en GitHub vragen elk een specifieke URL-vorm — zie bestanden uploaden. Ontbreekt de tool helemaal, dan is je plug-in te oud; werk hem bij.
De chat ontbreekt of weigert te antwoorden
- Er is geen MCP-sleutel gekozen als identiteit van de AI-chat in Organisatie → Moodle. De chat antwoordt over de verbinding van de gekozen sleutel.
- Het creditsaldo dekt het bericht niet — vul aan in Organisatie → Credits.
- Je hebt de limiet van 10 berichten per minuut bereikt. Wacht even.
De organisatie is geblokkeerd
De proefperiode is afgelopen of een betaling is mislukt. Neem een abonnement of corrigeer de betaalmethode in Organisatie → Facturatie. Er wordt niets verwijderd zolang de blokkade duurt.
Kom je er nog niet uit
Noteer de exacte foutmelding, de laatste 4 tekens van de sleutel (nooit de sleutel zelf) en het tijdstip, en open een issue op github.com/studiolxd/moodle-local_mcpconnector/issues.