Verfügbare Werkzeuge
Warum nicht ein Werkzeug je Moodle-Funktion
Moodle stellt je Rolle Hunderte Webservice-Funktionen bereit. Für jede ein MCP-Werkzeug zu listen, würde in manchen Clients den Werkzeugimport sprengen und in anderen die Antwortqualität verschlechtern. Deshalb ist die angebotene Oberfläche vom aufrufbaren Katalog entkoppelt.
Ein Assistent sieht rund fünfzehn Werkzeuge, egal wie groß der Katalog Ihres Moodle ist, und erreicht den Rest bei Bedarf.
Der kuratierte Satz
Die häufigsten Aufgaben sind als Werkzeuge erster Klasse verfügbar, gefiltert nach den Rollen des Schlüssels:
| Werkzeug | Was es beantwortet |
|---|---|
| core_webservice_get_site_info | Site-Name, Version, wer Sie sind |
| core_enrol_get_users_courses | In welchen Kursen jemand eingeschrieben ist |
| core_course_get_courses_by_field | Kurs per ID, Kurzname … suchen |
| core_course_get_contents | Abschnitte, Aktivitäten und Ressourcen eines Kurses |
| core_enrol_get_enrolled_users | Teilnehmende eines Kurses |
| gradereport_user_get_grade_items | Noten einer Person in einem Kurs |
| core_calendar_get_calendar_events | Anstehende Termine und Fristen |
| mod_assign_get_assignments | Aufgaben in den Kursen |
| mod_forum_get_forum_discussions | Diskussionen in einem Forum |
| core_message_get_messages | Mitteilungen einer Person |
| core_group_get_course_groups | Gruppen eines Kurses |
| core_user_get_users_by_field | Person per ID, E-Mail oder Anmeldename suchen |
| moodle_request_file_upload | Temporäre Upload-URL holen — siehe Dateien hochladen |
Das Gateway
Drei Meta-Werkzeuge erreichen den restlichen Katalog, ohne ihn zu listen:
- moodle_find_tools(suche) — durchsucht den gesamten rollenerlaubten Katalog per Stichwort. Liefert bis zu 25 Treffer, damit die Suche den Kontext des Assistenten nie überschwemmt.
- moodle_tool_schema(name) — holt das Eingabeschema eines Werkzeugs.
- moodle_run_tool(name, argumente) — führt jedes rollenerlaubte Werkzeug aus.
In der Praxis sucht der Assistent, liest das Schema und führt den Aufruf aus — deshalb kann er Dinge tun, die oben nicht stehen, ohne dass Sie etwas einrichten.
Was das Plugin beisteuert
Über Moodles eigene Funktionen hinaus bringt local_mcpconnector eigene externe Funktionen für Aufgaben mit, die die Kern-Webservices nicht abdecken: Tests, SCORM- und H5P-Aktivitäten, Dateiressourcen, Fragenimport, Auszeichnungen vergeben sowie Kurse sichern und wiederherstellen. Sie erscheinen im Katalog wie jedes andere Werkzeug und unterliegen derselben Rollenprüfung.
Der vollständige Katalog
Alle Werkzeuge, die über das Gateway erreichbar sind — die übrigen Moodle-eigenen Funktionen plus die des Plugins — stehen mit einer Kurzbeschreibung im vollständigen Werkzeugkatalog.
Grenzen, die immer gelten
- Rollen — ein Werkzeug, das die Rollen des Schlüssels nicht erlauben, wird weder gelistet noch ausgeführt.
- Schlüsseleinschränkungen — Nur-Lesen, erlaubte Werkzeuge und erlaubte Kurse werden serverseitig bei jedem Aufruf durchgesetzt, auch über das Gateway. Siehe Schlüssel und Berechtigungen.
- Zustimmung im Chat — im Chat des Panels laufen nur lesende Erkundungswerkzeuge unbeaufsichtigt; alles, was Moodle ändern könnte, fragt vorher nach.
Diese Prüfungen laufen auf dem Server — ein Assistent kann sie nicht umverhandeln.