Fehlerbehebung
Die Lizenzprüfung schlägt fehl
„Ungültige Zugangsdaten" — Lizenzschlüssel und Panel-Geheimnis müssen das gemeinsam ausgestellte Paar sein. Haben Sie die Zugangsdaten erneuert, hat das Plugin noch das alte Paar: Fügen Sie das neue ein. Haben Sie nur einen Wert kopiert, bevor Sie die Seite verlassen haben, erneuern Sie für ein frisches Paar.
„URL stimmt nicht überein" — die aufrufende Site passt nicht zur im Panel hinterlegten URL. Häufig, wenn Moodle hinter einem Proxy steht und $CFG-wwwroot vom öffentlichen Hostnamen abweicht, oder nach einem Domainwechsel. Aktualisieren Sie die URL unter Organisation → Moodle und prüfen Sie erneut.
Das Plugin erreicht das Panel gar nicht — Ihr Moodle braucht ausgehendes HTTPS. Prüfen Sie curl https://moodlemcp.com auf dem Server und die Proxy-Einstellungen in Moodle.
Die Site lässt sich nicht verbinden
„URL nicht erlaubt" — die URL muss öffentlich sein, HTTPS nutzen und ein gültiges Zertifikat haben. localhost, private Bereiche und nur per VPN erreichbare Hosts werden bewusst abgelehnt. Eine Staging-Site geht, wenn sie öffentlich erreichbar ist.
Zertifikatsfehler — ein selbstsigniertes oder abgelaufenes Zertifikat besteht die Prüfung nicht. Reparieren Sie das Zertifikat; es gibt keine Umgehung.
Der Assistent sagt, er habe keine Werkzeuge
- Der Client hat seine MCP-Konfiguration nicht neu geladen. Starten Sie ihn neu.
- Die URL ist falsch: Sie muss die Subdomain Ihrer Organisation sein und auf /mcp enden.
- Mit Bearer-Schlüssel: Prüfen Sie, ob der Header exakt Authorization: Bearer mcpk_… lautet und der Schlüssel weder gesperrt noch widerrufen oder abgelaufen ist.
- Mit OAuth: Entfernen Sie den Connector und autorisieren Sie erneut.
Der Assistent sieht nichts in Moodle
Der Schlüssel funktioniert, aber die zugrunde liegende Moodle-Person hat keinen Zugriff auf das Gefragte. Rollen sind die äußere Grenze: Ein Studierenden-Schlüssel kann die Teilnehmenden eines Kurses nicht auflisten. Prüfen Sie, für wen der Schlüssel ausgestellt wurde und ob er auf Nur-Lesen, bestimmte Werkzeuge oder bestimmte Kurse beschränkt ist. Siehe Schlüssel und Berechtigungen.
Aufrufe scheitern, nachdem sie funktioniert haben
- Der Schlüssel wurde gesperrt oder widerrufen, im Panel oder im Plugin.
- Die Zugangsdaten wurden erneuert und das Plugin nicht aktualisiert.
- Die Moodle-Person hat die Rolle verloren, auf der der Schlüssel beruht, oder wurde gelöscht.
- Das Token wurde in Moodle gelöscht, unter Website-Administration → Server → Webservices → Token verwalten.
Organisation → Moodle → Nutzung zeigt Fehler je Schlüssel und Werkzeug — meist ist die Ursache damit in Sekunden gefunden.
Eine Datei lässt sich nicht hochladen
Die URL muss die Datei liefern, nicht eine Seite darum herum. Testen Sie mit curl -IL url von außerhalb Ihres Netzes. Google Drive, Dropbox und GitHub brauchen jeweils eine bestimmte URL-Form — siehe Dateien hochladen. Fehlt das Werkzeug ganz, ist Ihr Plugin zu alt: aktualisieren.
Der Chat fehlt oder antwortet nicht
- Es ist kein MCP-Schlüssel als Chat-Identität unter Organisation → Moodle ausgewählt.
- Das Guthaben deckt die Nachricht nicht — laden Sie unter Organisation → Guthaben auf.
- Sie haben die Grenze von 10 Nachrichten pro Minute erreicht. Kurz warten.
Die Organisation ist gesperrt
Die Testphase ist beendet oder eine Zahlung schlug fehl. Schließen Sie ab oder korrigieren Sie die Zahlungsmethode unter Organisation → Abrechnung. Während der Sperre wird nichts gelöscht.
Immer noch festgefahren
Notieren Sie den genauen Fehler, die letzten 4 Zeichen des Schlüssels (nie den Schlüssel selbst) und die Uhrzeit, und eröffnen Sie ein Ticket auf github.com/studiolxd/moodle-local_mcpconnector/issues.