In breve
Piattaforma di apprendimento Moodle tramite il suo protocollo Web Services REST: corsi e contenuti del corso, partecipanti, utenti, voti, completamento delle attività, compiti e invii, quiz, calendario e scadenze, forum e messaggi. URL del sito e token del servizio web.
Configurazione guidata
Collega Moodle a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Moodle con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per Moodle
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connectors → Moodle, inserisci l'indirizzo del tuo sito Moodle e un token del servizio web, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Moodle
Piattaforma di apprendimento Moodle tramite il suo protocollo Web Services REST: corsi e contenuti del corso, partecipanti, utenti, voti, completamento delle attività, compiti e invii, quiz, calendario e scadenze, forum e messaggi. URL del sito e token del servizio web.
Configurazione
Configurazione da parte di un amministratore Moodle (circa 10 minuti)
- Amministrazione del sito, Generale, Funzionalità avanzate: seleziona Abilita i servizi web e salva.
- Amministrazione del sito, Server, Servizi web, Gestisci protocolli: abilita il protocollo REST.
- Servizi web, Servizi esterni: aggiungi un servizio (abilitato), poi Aggiungi funzioni e aggiungi le funzioni elencate qui sotto. Il servizio web mobile Moodle integrato contiene già tutte tranne
core_user_get_users, e può essere utilizzato invece quando App mobile, Impostazioni mobili, Abilita i servizi web per dispositivi mobili è attivato. - Scegli l'utente con cui il connettore agisce, idealmente un account dedicato. Il suo ruolo deve avere la capacità Usa il protocollo REST (
webservice/rest:use) e i diritti per ciò che vuoi leggere: un ruolo di insegnante o manager per partecipanti, voti di altri e invii. - Servizi web, Gestisci token, Crea token: seleziona quell'utente e il servizio, salva e copia il token in
MOODLE_TOKEN. - Inserisci l'indirizzo del sito in
MOODLE_URL, senza uno slash alla fine, ad esempiohttps://moodle.myschool.org.
Un utente senza diritti di amministratore può utilizzare il proprio token del servizio mobile, mostrato sotto Preferenze, Chiavi di sicurezza quando il sito lo consente. Il connettore vede esattamente ciò che quell'utente vede.
Da dove iniziare: moodle_get_site_info controlla il token e restituisce userid. Poi moodle_list_my_courses (o moodle_list_user_courses) per gli id dei corsi di cui tutto il resto ha bisogno.
Corsi: moodle_list_my_courses, moodle_list_user_courses, moodle_search_courses, moodle_get_courses_by_field, moodle_list_courses (tutti i corsi, token manager), moodle_list_categories e moodle_get_course_contents per sezioni, attività e file.
Persone: moodle_list_enrolled_users (partecipanti di un corso), moodle_get_users_by_field (ricerca esatta per id, nome utente, email, idnumber), moodle_search_users (servizio personalizzato solo).
Progresso: moodle_get_grade_items (rapporto di voto di un corso), moodle_get_course_grades_overview (voti finali nei corsi), moodle_get_completion_status (completamento delle attività).
Attività: moodle_list_assignments, moodle_list_assignment_submissions, moodle_list_quizzes. Calendario: moodle_list_calendar_events, moodle_list_upcoming_deadlines. Forum: moodle_list_forums, moodle_list_forum_discussions, moodle_get_discussion_posts. Messaggi: moodle_list_conversations e moodle_send_message, l'unico strumento che scrive.
Funzioni dietro gli strumenti (aggiungi queste a un servizio personalizzato): 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.
Gli errori arrivano con HTTP 200: Moodle risponde a una chiamata fallita con stato 200 e un corpo contenente exception, errorcode e message. Il connettore trasforma questo in una chiamata fallita. Codici comuni: invalidtoken (token errato, scaduto o eliminato), accessexception (la funzione non è nel servizio del token, o i servizi web sono disattivati), nopermissions (l'utente non ha una capacità, indicata nel messaggio), invalidparameter (un valore ha il tipo errato) e invalidrecord (nessun id del genere). Molti strumenti restituiscono anche warnings accanto ai dati quando singoli elementi sono stati saltati: leggili.
Id: Moodle ha tre id per attività. cmid (id del modulo del corso) è quello negli indirizzi delle pagine e in moodle_get_course_contents; instance (o id nelle liste di compiti, quiz e forum) è ciò che gli strumenti delle attività prendono. Gli id di utenti, corsi e gruppi sono numeri semplici.
Valori: i tempi sono secondi Unix (0 significa non impostato). I flag sono numeri: 1 per sì, 0 per no; Moodle rifiuta le parole vero e falso. Testi come summary, intro e message sono HTML.
Permessi: ogni chiamata viene eseguita come l'utente del token. Un token studente legge i propri corsi, voti e scadenze; le liste di partecipanti, voti di altri e invii necessitano di un insegnante o manager. Non c'è un limite di frequenza documentato; la capacità del sito stesso è il limite, quindi preferisci una chiamata con diversi id di corsi piuttosto che una chiamata per ogni corso.
Prerequisiti: MOODLE_URL, MOODLE_TOKEN
Installa il connettore localmente
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
Apri http://localhost:3000/connectors/store, scegli Moodle e incolla le variabili d'ambiente elencate sotto Prerequisiti.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
moodle_get_site_info | Legge il sito e l'utente a cui appartiene il token: sitename, siteurl, release (versione Moodle), userid, username, fullname, lang e se… |
moodle_list_my_courses | Elenca i corsi dell'utente del token come nel dashboard di Moodle: id, fullname, shortname, summary, startdate, enddate (secondi Unix)… |
moodle_list_user_courses | Elenca i corsi a cui un utente è iscritto: id, shortname, fullname, category, startdate, enddate, lastaccess (secondi Unix), progress in… |
moodle_list_courses | Legge i corsi per id con le loro impostazioni: id, shortname, fullname, categoryid, summary, format, startdate, enddate, visible, numsections… |
moodle_get_courses_by_field | Trova corsi per un campo e leggi ciò che l'utente del token può vedere di essi: id, fullname, shortname, categoryid, categoryname, summary… |
moodle_search_courses | Cerca nel catalogo dei corsi per testo: per id del corso, fullname, shortname, categoryid, categoryname, summary, contatti (insegnanti) e… |
moodle_get_course_contents | Legge il contenuto di un corso: le sue sezioni (id, nome, summary, numero della sezione, visible) e in ciascuna le attività e risorse come… |
moodle_list_categories | Elenca le categorie dei corsi: id, nome, descrizione, parent (0 al livello superiore), coursecount, depth e path. Senza un filtro ogni categoria… |
moodle_list_enrolled_users | Elenca i partecipanti di un corso: id, username, fullname, email, idnumber, department, lastaccess e lastcourseaccess (secondi Unix)… |
moodle_get_users_by_field | Cerca utenti per id, username, email o idnumber (valori esatti): id, username, firstname, lastname, fullname, email, department, idnumber… |
moodle_search_users | Cerca gli utenti del sito per un campo: id, username, firstname, lastname, fullname, email, idnumber, department, lastaccess e… |
moodle_get_grade_items | Legge il rapporto di voto di un corso: per utente gradeitems con itemname, itemtype (mod, category, course), itemmodule, graderaw… |
moodle_get_course_grades_overview | Legge il voto finale di un utente in ogni corso a cui è iscritto: courseid, grade (come visualizzato) e rawgrade. Usa… |
moodle_get_completion_status | Legge quali attività di un corso un utente ha completato: per attività cmid, modname, instance, state (0 non completato, 1 completato, 2… |
moodle_list_assignments | Elenca i compiti dei corsi: per corso assignments con id, cmid, name, intro, duedate, allowsubmissionsfromdate, cutoffdate… |
moodle_list_assignment_submissions | Elenca gli invii dei compiti: per compito submissions con id, userid, attemptnumber, status (nuovo, bozza, inviato, riaperto)… |
moodle_list_quizzes | Elenca i quiz dei corsi: id, coursemodule, course, name, intro, timeopen, timeclose (secondi Unix, 0 quando non impostato), timelimit in… |
moodle_list_calendar_events | Elenca eventi del calendario: id, nome, descrizione, courseid, groupid, userid, modulename, instance, eventtype (utente, corso, gruppo, sito, scadenza… |
moodle_list_upcoming_deadlines | Elenca cosa deve fare l'utente del token successivamente, come nella timeline di Moodle: eventi con un'azione come un compito da inviare o un quiz da… |
moodle_list_forums | Elenca i forum dei corsi: id, corso, nome, intro, tipo (notizie, generale, domande e risposte, singolo e altri), cmid, numdiscussions… |
moodle_list_forum_discussions | Elenca le discussioni di un forum: per discussione discussion (l'id della discussione per moodle_get_discussion_posts), nome, soggetto, messaggio di… |
moodle_get_discussion_posts | Legge tutti i post di una discussione di forum: id, soggetto, messaggio (HTML), autore (id, fullname), parentid (il post a cui risponde), timecreated… |
moodle_list_conversations | Elenca le conversazioni private dell'utente del token: id, nome, tipo (1 tra due utenti, 2 gruppo, 3 note per se stesso), membercount, unreadcount… |
moodle_send_message | Invia un messaggio privato Moodle dall'utente del token a un altro utente. Il destinatario viene notificato come indicato nelle sue preferenze Moodle (web, email… |
Esempi di richieste
- "Quali compiti scadono nei miei corsi questa settimana?"
- "Elenca i partecipanti del corso 42 che non hanno inviato il compito saggio."
- "Mostrami la mia panoramica dei voti in tutti i corsi."
- "Quali attività del corso di Biologia 101 non ho ancora completato?"
- "Riassumi le ultime discussioni nel forum del corso."
Prossimi passi
Questa guida ti è stata utile?