In breve
Piattaforma di apprendimento Moodle attraverso il suo protocollo Web Services REST: corsi e contenuti dei corsi, 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 in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Moodle con la configurazione guidata e aggiungi il tuo URL MCP a Claude. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
AnythingMCP è nella directory dei connettori di Claude: aggiungilo a Claude con un clic (si apre in una nuova scheda), poi accedi e scegli quali server MCP può usare Claude.
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, genera una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Moodle + Claude
Piattaforma di apprendimento Moodle attraverso il suo protocollo Web Services REST: corsi e contenuti dei corsi, partecipanti, utenti, voti, completamento delle attività, compiti e invii, quiz, calendario e scadenze, forum e messaggi. URL del sito e token del servizio web.
Prerequisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:
MOODLE_URL, MOODLE_TOKEN
Passo 1 — Ottieni le credenziali
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 nominate nell'elenco qui sotto. Il servizio web mobile di Moodle già contiene 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 agirà, idealmente un account dedicato. Il suo ruolo deve avere la capacità Usa protocollo REST (
webservice/rest:use) e i diritti per ciò che desideri 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 su 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à, nominata nel messaggio), invalidparameter (un valore ha il tipo sbagliato) e invalidrecord (nessun id del genere). Molti strumenti restituiscono anche warnings accanto ai dati quando singoli elementi sono stati saltati: leggili.
Ids: 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 velocità documentato; la capacità del sito stesso è il limite, quindi preferisci una chiamata con diversi ID di corsi piuttosto che una chiamata per ogni corso.
Passo 2 — Installa l'adattatore
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
Passo 3 — Aggiungi il connettore in Claude
L'URL del tuo server: in AnythingMCP, apri MCP Servers → il server su cui si trova questo connettore, e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostriYOUR_SERVER_ID.
Percorso consigliato: funziona su claude.ai web senza modificare alcun file di configurazione.
- In Claude apri Plugins (in alcuni piani ancora Customize) → Connectors.
- Clicca + Add e poi Add custom connector.
- Inserisci un nome, ad esempio
Moodle, e l'URL del server MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Continue, mantieni le impostazioni rilevate e clicca di nuovo Continue. - Scegli Sign in now, clicca Add e accedi ad AnythingMCP (OAuth) per consentire l'accesso.
Tutti gli strumenti qui sotto appariranno nella tua chat: inizia a digitare i prompt.
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 cosa 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 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, visibile) 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 gli 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, qanda, 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 prompt
- "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 su tutti i corsi."
- "Quali attività del corso di Biologia 101 non ho ancora completato?"
- "Riassumi le ultime discussioni nel forum del corso."
FAQ
Funziona anche con Claude Code oltre che con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Da dove proviene il token? Un amministratore Moodle abilita i servizi web e il protocollo REST, aggiunge un servizio con le funzioni utilizzate dagli strumenti (il servizio web mobile di Moodle ha già tutto tranne uno), e crea un token per un utente sotto Gestisci token. Gli utenti possono anche utilizzare il proprio token del servizio mobile da Preferenze, Chiavi di sicurezza quando il sito lo consente. Su AnythingMCP Cloud il sito deve essere raggiungibile da internet tramite HTTPS.
Cosa può vedere? Esattamente ciò che l'utente del token può vedere: un token studente legge i propri corsi, voti e scadenze; partecipanti, voti di altri e invii necessitano di un insegnante o manager. Copre corsi e contenuti, utenti, voti, completamento delle attività, compiti e invii, quiz, calendario, forum e messaggi privati, per Moodle 4 e 5, auto-ospitato o MoodleCloud.
Quali strumenti scrivono, e cosa installa spento? Solo moodle_send_message scrive, invia un messaggio privato. Niente installa spento.
Prossimi passi
- Pagina di atterraggio del connettore
- Collegati a ChatGPT
- Collegati a Cursor
- Collegati a Gemini
- Collegati a Meta Muse
- Collegati a Microsoft Copilot
Questa guida ti è stata utile?