Zusammenfassung
Moodle-Lernplattform über ihr Web Services REST-Protokoll: Kurse und Kursinhalte, Teilnehmer, Benutzer, Noten, Aktivitätsabschlüsse, Aufgaben und Einreichungen, Quizze, Kalender und Fristen, Foren und Nachrichten. Site-URL und Webservice-Token.
Geführte Einrichtung
Moodle in 2 Minuten mit Microsoft Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Moodle in der geführten Einrichtung und trag deine MCP-URL in Microsoft Copilot ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Frag einfach
Beispiel-Prompts für Moodle
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → Moodle, gib die Adresse deiner Moodle-Seite und ein Webservice-Token ein, generiere einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein
git clone, kein lokaler Server.
Moodle + Microsoft Copilot
Moodle-Lernplattform über ihr Web Services REST-Protokoll: Kurse und Kursinhalte, Teilnehmer, Benutzer, Noten, Aktivitätsabschlüsse, Aufgaben und Einreichungen, Quizze, Kalender und Fristen, Foren und Nachrichten. Site-URL und Webservice-Token.
Voraussetzungen
Siehe die vollständigen Einrichtungsanweisungen, die im Connector integriert sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:
MOODLE_URL, MOODLE_TOKEN
Schritt 1 — Zugangsdaten erhalten
Einrichtung durch einen Moodle-Administrator (ca. 10 Minuten)
- Site-Administration, Allgemein, Erweiterte Funktionen: aktiviere Webservices aktivieren und speichere.
- Site-Administration, Server, Webservices, Protokolle verwalten: aktiviere das REST-Protokoll.
- Webservices, Externe Dienste: füge einen Dienst hinzu (aktiviert), dann Funktionen hinzufügen und füge die in der Liste unten genannten Funktionen hinzu. Der integrierte Moodle Mobile Webservice enthält bereits alle außer
core_user_get_usersund kann stattdessen verwendet werden, wenn Mobile App, Mobile Einstellungen, Webservices für mobile Geräte aktivieren aktiviert ist. - Wähle den Benutzer, in dessen Namen der Connector agiert, idealerweise ein dediziertes Konto. Seine Rolle benötigt die Berechtigung REST-Protokoll verwenden (
webservice/rest:use) und die Rechte für das, was du lesen möchtest: eine Lehrer- oder Managerrolle für Teilnehmer, Noten anderer und Einreichungen. - Webservices, Token verwalten, Token erstellen: wähle diesen Benutzer und den Dienst, speichere und kopiere das Token in
MOODLE_TOKEN. - Gib die Adresse der Seite in
MOODLE_URLein, ohne einen Schrägstrich am Ende, z.B.https://moodle.myschool.org.
Ein Benutzer ohne Administratorrechte kann sein eigenes Token des mobilen Dienstes verwenden, das unter Einstellungen, Sicherheitskeys angezeigt wird, wenn die Seite dies zulässt. Der Connector sieht dann genau das, was dieser Benutzer sieht.
Wo anfangen: moodle_get_site_info überprüft das Token und gibt userid zurück. Dann moodle_list_my_courses (oder moodle_list_user_courses) für die Kurs-IDs, die alles andere benötigt.
Kurse: moodle_list_my_courses, moodle_list_user_courses, moodle_search_courses, moodle_get_courses_by_field, moodle_list_courses (alle Kurse, Manager-Token), moodle_list_categories und moodle_get_course_contents für Abschnitte, Aktivitäten und Dateien.
Personen: moodle_list_enrolled_users (Teilnehmer eines Kurses), moodle_get_users_by_field (exakte Suche nach ID, Benutzername, E-Mail, ID-Nummer), moodle_search_users (benutzerdefinierter Dienst nur).
Fortschritt: moodle_get_grade_items (Notenbericht eines Kurses), moodle_get_course_grades_overview (Endnoten über Kurse hinweg), moodle_get_completion_status (Aktivitätsabschluss).
Aktivitäten: moodle_list_assignments, moodle_list_assignment_submissions, moodle_list_quizzes. Kalender: moodle_list_calendar_events, moodle_list_upcoming_deadlines. Foren: moodle_list_forums, moodle_list_forum_discussions, moodle_get_discussion_posts. Nachrichten: moodle_list_conversations und moodle_send_message, das einzige Tool, das schreibt.
Funktionen hinter den Tools (füge diese zu einem benutzerdefinierten Dienst hinzu): core_webservice_get_site_info, core_course_get_enrolled_courses_by_timeline_classification, core_enrol_get_users_courses, core_course_get_courses, core_course_get_courses_by_field, core_course_search_courses, core_course_get_contents, core_course_get_categories, core_enrol_get_enrolled_users, core_user_get_users_by_field, core_user_get_users, gradereport_user_get_grade_items, gradereport_overview_get_course_grades, core_completion_get_activities_completion_status, mod_assign_get_assignments, mod_assign_get_submissions, mod_quiz_get_quizzes_by_courses, core_calendar_get_calendar_events, core_calendar_get_action_events_by_timesort, mod_forum_get_forums_by_courses, mod_forum_get_forum_discussions, mod_forum_get_discussion_posts, core_message_get_conversations, core_message_send_instant_messages.
Fehler kommen mit HTTP 200: Moodle antwortet auf einen fehlgeschlagenen Aufruf mit dem Status 200 und einem Body, der exception, errorcode und message enthält. Der Connector wandelt das in einen fehlgeschlagenen Aufruf um. Häufige Codes: invalidtoken (Token falsch, abgelaufen oder gelöscht), accessexception (die Funktion ist nicht im Dienst des Tokens oder Webservices sind deaktiviert), nopermissions (der Benutzer hat nicht die erforderliche Berechtigung, die im Nachrichtennamen angegeben ist), invalidparameter (ein Wert hat den falschen Typ) und invalidrecord (keine solche ID). Viele Tools geben auch warnings neben den Daten zurück, wenn einzelne Elemente übersprungen wurden: lies sie.
IDs: Moodle hat drei IDs pro Aktivität. cmid (Kursmodul-ID) ist die, die in Seitenadressen und in moodle_get_course_contents verwendet wird; instance (oder id in den Listen für Aufgaben, Quizze und Foren) ist das, was die Aktivitäts-Tools verwenden. Benutzer-, Kurs- und Gruppen-IDs sind einfache Zahlen.
Werte: Zeiten sind Unix-Sekunden (0 bedeutet nicht gesetzt). Flags sind Zahlen: 1 für ja, 0 für nein; Moodle lehnt die Wörter true und false ab. Texte wie summary, intro und message sind HTML.
Berechtigungen: Jeder Aufruf wird als der Benutzer des Tokens ausgeführt. Ein Studententoken liest seine eigenen Kurse, Noten und Fristen; Listen von Teilnehmern, Noten anderer und Einreichungen benötigen einen Lehrer oder Manager. Es gibt keine dokumentierte Rate-Limitierung; die eigene Kapazität der Seite ist das Limit, daher bevorzuge einen Aufruf mit mehreren Kurs-IDs gegenüber einem Aufruf pro Kurs.
Schritt 2 — Adapter installieren
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Schritt 3 — Den Connector in Microsoft Copilot hinzufügen
Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese AnleitungYOUR_SERVER_IDzeigt.
Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.
- Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
- Trag einen Server name ein (zum Beispiel
AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft. - Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf
X-API-Keyund klicke auf Create. - Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
- Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die
Moodle-Tools braucht. - Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.
Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.
Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
moodle_get_site_info | Liest die Seite und den Benutzer, zu dem das Token gehört: sitename, siteurl, release (Moodle-Version), userid, username, fullname, lang und ob… |
moodle_list_my_courses | Listet die Kurse des Token-Benutzers wie im Moodle-Dashboard: id, fullname, shortname, summary, startdate, enddate (Unix-Sekunden)… |
moodle_list_user_courses | Listet die Kurse, in denen ein Benutzer eingeschrieben ist: id, shortname, fullname, category, startdate, enddate, lastaccess (Unix-Sekunden), Fortschritt in… |
moodle_list_courses | Liest Kurse nach ID mit ihren Einstellungen: id, shortname, fullname, categoryid, summary, format, startdate, enddate, visible, numsections… |
moodle_get_courses_by_field | Findet Kurse nach einem Feld und liest, was der Token-Benutzer von ihnen sehen kann: id, fullname, shortname, categoryid, categoryname, summary… |
moodle_search_courses | Durchsucht den Kurskatalog nach Text: nach Kurs-ID, fullname, shortname, categoryid, categoryname, summary, Kontakten (Lehrern) und… |
moodle_get_course_contents | Liest den Inhalt eines Kurses: seine Abschnitte (id, name, summary, Abschnittsnummer, sichtbar) und in jedem die Aktivitäten und Ressourcen als… |
moodle_list_categories | Listet Kurskategorien: id, name, description, parent (0 auf der obersten Ebene), coursecount, depth und path. Ohne Filter wird jede Kategorie… |
moodle_list_enrolled_users | Listet die Teilnehmer eines Kurses: id, username, fullname, email, idnumber, department, lastaccess und lastcourseaccess (Unix-Sekunden)… |
moodle_get_users_by_field | Sucht Benutzer nach id, username, email oder idnumber (exakte Werte): id, username, firstname, lastname, fullname, email, department, idnumber… |
moodle_search_users | Durchsucht die Benutzer der Seite nach einem Feld: id, username, firstname, lastname, fullname, email, idnumber, department, lastaccess und… |
moodle_get_grade_items | Liest den Notenbericht eines Kurses: pro Benutzer gradeitems mit itemname, itemtype (mod, category, course), itemmodule, graderaw… |
moodle_get_course_grades_overview | Liest die Endnote eines Benutzers in jedem Kurs, in dem er eingeschrieben ist: courseid, grade (wie angezeigt) und rawgrade. Verwende… |
moodle_get_completion_status | Liest, welche Aktivitäten eines Kurses ein Benutzer abgeschlossen hat: pro Aktivität cmid, modname, instance, state (0 nicht abgeschlossen, 1 abgeschlossen, 2… |
moodle_list_assignments | Listet die Aufgaben der Kurse: pro Kurs assignments mit id, cmid, name, intro, duedate, allowsubmissionsfromdate, cutoffdate… |
moodle_list_assignment_submissions | Listet die Einreichungen von Aufgaben: pro Aufgabe submissions mit id, userid, attemptnumber, status (neu, Entwurf, eingereicht, wiedereröffnet)… |
moodle_list_quizzes | Listet die Quizze der Kurse: id, coursemodule, course, name, intro, timeopen, timeclose (Unix-Sekunden, 0 wenn nicht gesetzt), timelimit in… |
moodle_list_calendar_events | Listet Kalenderereignisse: id, name, description, courseid, groupid, userid, modulename, instance, eventtype (Benutzer, Kurs, Gruppe, Seite, fällig… |
moodle_list_upcoming_deadlines | Listet, was der Token-Benutzer als Nächstes tun muss, wie auf der Moodle-Zeitleiste: Ereignisse mit einer Aktion wie einer Aufgabe, die eingereicht werden muss, oder einem Quiz… |
moodle_list_forums | Listet die Foren der Kurse: id, course, name, intro, type (Nachrichten, allgemein, Frage-Antwort, einzel und andere), cmid, numdiscussions… |
moodle_list_forum_discussions | Listet die Diskussionen eines Forums: pro Diskussion discussion (die Diskussions-ID für moodle_get_discussion_posts), name, subject, message von… |
moodle_get_discussion_posts | Liest alle Beiträge einer Forum-Diskussion: id, subject, message (HTML), author (id, fullname), parentid (der Beitrag, auf den geantwortet wird), timecreated… |
moodle_list_conversations | Listet die privaten Gespräche des Token-Benutzers: id, name, type (1 zwischen zwei Benutzern, 2 Gruppe, 3 Notizen für sich selbst), membercount, unreadcount… |
moodle_send_message | Sendet eine private Moodle-Nachricht vom Token-Benutzer an einen anderen Benutzer. Der Empfänger wird benachrichtigt, wie es seine Moodle-Einstellungen vorsehen (Web, E-Mail… |
Beispielaufforderungen
- "Welche Aufgaben sind diese Woche in meinen Kursen fällig?"
- "Liste die Teilnehmer des Kurses 42 auf, die die Essay-Aufgabe nicht eingereicht haben."
- "Zeige meine Notenübersicht über alle Kurse."
- "Welche Aktivitäten des Kurses Biologie 101 habe ich noch nicht abgeschlossen?"
- "Fasse die neuesten Diskussionen im Kursforum zusammen."
FAQ
Woher kommt das Token? Ein Moodle-Administrator aktiviert Webservices und das REST-Protokoll, fügt einen Dienst mit den Funktionen hinzu, die die Tools verwenden (der integrierte Moodle Mobile Webservice hat bereits alle bis auf eine), und erstellt ein Token für einen Benutzer unter Token verwalten. Benutzer können auch ihr eigenes Token des mobilen Dienstes aus den Einstellungen, Sicherheitskeys verwenden, wenn die Seite dies zulässt. Auf AnythingMCP Cloud muss die Seite über HTTPS aus dem Internet erreichbar sein.
Was kann es sehen? Genau das, was der Benutzer des Tokens sehen kann: ein Studententoken liest seine eigenen Kurse, Noten und Fristen; Teilnehmer, Noten anderer und Einreichungen benötigen einen Lehrer oder Manager. Es deckt Kurse und Inhalte, Benutzer, Noten, Aktivitätsabschlüsse, Aufgaben und Einreichungen, Quizze, den Kalender, Foren und private Nachrichten ab, für Moodle 4 und 5, self-hosted oder MoodleCloud.
Welche Tools schreiben, und was installiert abgeschaltet? Nur moodle_send_message schreibt, es sendet eine private Nachricht. Nichts installiert abgeschaltet.
Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.
Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.
Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.
Nächste Schritte
War dieser Guide hilfreich?