Problemen oplossen
De licentievalidatie mislukt
"Ongeldige inloggegevens" — de licentiesleutel en het paneelgeheim moeten het samen uitgegeven paar zijn. Heb je de inloggegevens 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 voor een vers paar.
"URL komt niet overeen" — de site die belt komt niet overeen met de URL die in het paneel staat. Gebruikelijk als Moodle achter een proxy draait en $CFG-wwwroot afwijkt van de publieke hostnaam, of na een domeinwijziging. Werk de URL bij in Organisatie → Moodle en valideer opnieuw.
De plug-in bereikt het paneel helemaal niet — je Moodle heeft uitgaand HTTPS nodig. Controleer curl https://moodlemcp.com vanaf de server en de proxy-instellingen in Moodle.
De site kan niet worden verbonden
"URL niet toegestaan" — de URL moet publiek zijn, HTTPS gebruiken en een geldig certificaat hebben. localhost, privébereiken en hosts die alleen via VPN bereikbaar zijn worden bewust geweigerd. Een testomgeving mag, als die publiek bereikbaar is.
Certificaatfouten — een zelfondertekend of verlopen certificaat komt niet door de validatie. Herstel het certificaat; er is geen omweg.
De assistent zegt geen tools te hebben
- De client heeft zijn MCP-configuratie niet herladen. Herstart hem.
- De URL klopt niet: het moet het subdomein van jouw organisatie zijn en eindigen op /mcp.
- Met een Bearer-sleutel: controleer of de header exact Authorization: Bearer mcpk_… is en of de sleutel niet geschorst, ingetrokken of verlopen is.
- Met OAuth: verwijder de connector en autoriseer opnieuw.
De assistent ziet niets in Moodle
De sleutel werkt, maar de onderliggende Moodle-gebruiker heeft geen toegang tot wat je vraagt. Rollen zijn de buitengrens: een studentensleutel kan de deelnemers van een cursus niet opsommen. Controleer voor wie de sleutel is uitgegeven en of hij beperkt is tot alleen-lezen, tot bepaalde tools of tot bepaalde cursussen. Zie sleutels en rechten.
Aanroepen mislukken nadat ze werkten
- De sleutel is geschorst of ingetrokken, in het paneel of vanuit de plug-in.
- De inloggegevens 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, onder Sitebeheer → Server → Webservices → Tokens beheren.
Organisatie → Moodle → Gebruik toont fouten per sleutel en per tool, wat het meestal in seconden lokaliseert.
Een bestand wordt niet geüpload
De URL moet het bestand teruggeven, niet een pagina eromheen. Test met curl -IL url van buiten je netwerk. Google Drive, Dropbox en GitHub hebben elk een specifieke URL-vorm nodig — zie bestanden uploaden. Ontbreekt de tool helemaal, dan is je plug-in te oud: werk hem bij.
De chat ontbreekt of antwoordt niet
- Er is geen MCP-sleutel gekozen als chatidentiteit in Organisatie → Moodle.
- Het creditsaldo dekt het bericht niet — vul aan bij Organisatie → Credits.
- Je hebt de limiet van 10 berichten per minuut bereikt. Even wachten.
De organisatie is vastgezet
De proefperiode is afgelopen of een betaling is mislukt. Neem een abonnement of corrigeer de betaalmethode bij Organisatie → Facturatie. Tijdens het vastzetten wordt niets verwijderd.
Nog steeds vast
Noteer de exacte fout, de laatste 4 tekens van de sleutel (nooit de sleutel zelf) en het tijdstip, en open een melding op github.com/studiolxd/moodle-local_mcpconnector/issues.