Die Lizenzprüfung schlägt fehl
„Ungültige Zugangsdaten" — Lizenzschlüssel und Panel-Geheimnis müssen das Paar sein, das für diese Verbindung gemeinsam ausgestellt wurde. Nach einem Wechsel der Zugangsdaten hat das Plugin noch das alte Paar: Fügen Sie das neue ein. Wenn Sie nur einen der Werte kopiert haben, bevor Sie die Seite verlassen haben, erzeugen Sie mit einem Wechsel ein frisches Paar. Wer mehrere Moodles betreibt, prüft, ob nicht das Paar einer anderen Verbindung eingefügt wurde.
„URL stimmt nicht überein" — die aufrufende Site passt nicht zu der für die Verbindung registrierten URL. Häufig, wenn Moodle hinter einem Proxy steht und $CFG-wwwroot vom öffentlichen Hostnamen abweicht, oder nach einem Domainwechsel. Aktualisieren Sie die URL in der Zeile der Verbindung unter Organisation → Moodle und prüfen Sie erneut.
Das Plugin erreicht das Panel überhaupt nicht — Ihr Moodle braucht ausgehendes HTTPS. Testen Sie curl https://lmsmcp.slxd.app auf dem Server und prüfen Sie die Proxy-Einstellungen in Moodle.
Die Site lässt sich nicht verbinden
„URL nicht erlaubt" — die URL muss öffentliches HTTPS mit gültigem Zertifikat sein. localhost, private Adressbereiche und nur per VPN erreichbare Hosts werden bewusst abgelehnt. Ein Testsystem geht, wenn es öffentlich erreichbar ist.
Zertifikatsfehler — ein selbstsigniertes oder abgelaufenes Zertifikat besteht die Prüfung nicht. Reparieren Sie das Zertifikat; es gibt keine Umgehung.
Keine freien Verbindungsplätze — Ihr Tarif begrenzt, wie viele Moodle-Sites eine Organisation verbinden darf; die Verbindungsseite nennt die verbleibenden. Löschen Sie eine nicht mehr genutzte Verbindung oder wechseln Sie den Tarif unter Organisation → Abrechnung.
Der Assistent sagt, er habe keine Werkzeuge
- Der Client hat seine MCP-Konfiguration nicht neu geladen. Starten Sie ihn neu.
- Die URL ist falsch: Es muss die Connector-URL dieser Verbindung sein — die Subdomain Ihrer Organisation, dann /mcp/lmsmcp/ und der Slug der Verbindung. Kopieren Sie sie von der Seite der Verbindung, statt sie abzutippen.
- Mit Bearer-Schlüssel: Prüfen Sie, dass der Header genau Authorization: Bearer mcpk_… lautet und der Schlüssel weder gesperrt noch widerrufen oder abgelaufen ist.
- Mit OAuth: Connector entfernen und neu autorisieren.
Der Assistent antwortet zum falschen Moodle oder wird abgelehnt
Jeder Schlüssel gehört zu einer Verbindung und funktioniert nur an deren Connector-URL. Den Schlüssel des einen Moodle an der URL eines anderen zu verwenden, wird abgewiesen. Prüfen Sie auf der Seite der Verbindung, dass der vorgezeigte Schlüssel dort gelistet ist.
Die Verbindung zeigt „Plugin fehlt" oder „Nicht erreichbar"
Jetzt prüfen auf der Seite der Verbindung fragt Ihr Moodle live:
- Plugin fehlt — Moodle hat geantwortet, aber das Connector-Plugin ist dort nicht installiert. Laden Sie es mit Plugin herunterladen (.zip) und installieren Sie es.
- Nicht erreichbar — Moodle hat nicht geantwortet: Die Site ist offline, die URL hat sich geändert, oder das Token des für die Prüfung genutzten Schlüssels gilt in Moodle nicht mehr.
- Kein aktiver Schlüssel — die Prüfung braucht ein Token; legen Sie zuerst einen Schlüssel für diese Verbindung an.
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 — der Schlüssel einer studierenden Person kann die Teilnehmenden eines Kurses nicht auflisten. Prüfen Sie, für wen der Schlüssel erzeugt wurde und ob er auf Nur-Lesen, auf bestimmte Werkzeuge oder auf bestimmte Kurse beschränkt ist. Siehe Schlüssel und Berechtigungen.
„Access control exception" beim Erstellen oder Bearbeiten
Die Rolle eines Schlüssels wird einmal site-weit geprüft; Moodle prüft Berechtigungen pro Kurs. Ein Schlüssel mit Rolle Trainer:in mit Bearbeitungsrecht darf das Werkzeug nutzen, aber Moodle lehnt es in einem Kurs ab, in dem diese Person kein Bearbeitungsrecht hat. Prüfen Sie, ob die Person, für die der Schlüssel erzeugt wurde:
- in diesem Kurs mit einer Rolle eingeschrieben ist, die die Fähigkeit moodle/course:manageactivities gewährt (Aktivitäten anlegen und bearbeiten);
- den Kurs sehen kann, falls er verborgen ist.
Sie im Kurs einzuschreiben oder ihr eine Rolle mit dieser Fähigkeit zu geben, behebt den Fehler. Siehe Schlüssel und Berechtigungen.
Aufrufe schlagen fehl, nachdem sie funktioniert haben
- Der Schlüssel wurde gesperrt oder widerrufen, im Panel oder über das Plugin.
- Die Zugangsdaten der Verbindung wurden gewechselt 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 unter Website-Administration → Server → Webservices → Tokens verwalten gelöscht.
Die Seite der Verbindung zeigt Nutzung und Fehler pro Schlüssel und pro Werkzeug, Organisation → Moodle → Nutzung zeigt die ganze Organisation; zusammen findet man die Ursache meist in Sekunden.
Eine Datei lässt sich nicht hochladen
Die URL muss die Datei zurückgeben, 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 Sie es.
Der Chat fehlt oder antwortet nicht
- Unter Organisation → Moodle ist kein MCP-Schlüssel als Identität des KI-Chats ausgewählt. Der Chat antwortet zur Verbindung des gewählten Schlüssels.
- Das Guthaben deckt die Nachricht nicht — laden Sie unter Organisation → Guthaben auf.
- Sie haben das Limit von 10 Nachrichten pro Minute erreicht. Warten Sie einen Moment.
Die Organisation ist gesperrt
Die Testphase ist abgelaufen oder eine Zahlung ist fehlgeschlagen. Schließen Sie ein Abo ab oder korrigieren Sie die Zahlungsart 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 Issue unter github.com/studiolxd/moodle-local_mcpconnector/issues.