Resumen
Plataforma de aprendizaje Moodle a través de su protocolo REST de Servicios Web: cursos y contenido del curso, participantes, usuarios, calificaciones, finalización de actividades, tareas y entregas, cuestionarios, calendario y fechas límite, foros y mensajes. URL del sitio y token del servicio web.
Configuración guiada
Conecta Moodle a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Moodle con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Moodle
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Moodle, introduce la dirección de tu sitio Moodle y un token de servicio web, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Moodle
Plataforma de aprendizaje Moodle a través de su protocolo REST de Servicios Web: cursos y contenido del curso, participantes, usuarios, calificaciones, finalización de actividades, tareas y entregas, cuestionarios, calendario y fechas límite, foros y mensajes. URL del sitio y token del servicio web.
Configuración
Configuración por un administrador de Moodle (unos 10 minutos)
- Administración del sitio, General, Funciones avanzadas: marca Habilitar servicios web y guarda.
- Administración del sitio, Servidor, Servicios web, Gestionar protocolos: habilita el protocolo REST.
- Servicios web, Servicios externos: añade un servicio (habilitado), luego Añadir funciones y agrega las funciones nombradas en la lista a continuación. El servicio web móvil de Moodle ya contiene todas excepto
core_user_get_users, y puede usarse en su lugar cuando Aplicación móvil, Configuración móvil, Habilitar servicios web para dispositivos móviles está activado. - Elige el usuario con el que actúa el conector, idealmente una cuenta dedicada. Su rol necesita la capacidad Usar protocolo REST (
webservice/rest:use) y los derechos para lo que quieras leer: un rol de profesor o gestor para participantes, calificaciones de otros y entregas. - Servicios web, Gestionar tokens, Crear token: selecciona ese usuario y el servicio, guarda y copia el token en
MOODLE_TOKEN. - Coloca la dirección del sitio en
MOODLE_URL, sin una barra al final, por ejemplo,https://moodle.myschool.org.
Un usuario sin derechos de administrador puede usar su propio token del servicio móvil, mostrado bajo Preferencias, Claves de seguridad cuando el sitio lo permite. El conector entonces ve exactamente lo que ese usuario ve.
Por dónde empezar: moodle_get_site_info verifica el token y devuelve userid. Luego moodle_list_my_courses (o moodle_list_user_courses) para los ids de los cursos que necesita todo lo demás.
Cursos: moodle_list_my_courses, moodle_list_user_courses, moodle_search_courses, moodle_get_courses_by_field, moodle_list_courses (todos los cursos, token de gestor), moodle_list_categories y moodle_get_course_contents para secciones, actividades y archivos.
Personas: moodle_list_enrolled_users (participantes de un curso), moodle_get_users_by_field (búsqueda exacta por id, nombre de usuario, correo electrónico, idnumber), moodle_search_users (servicio personalizado solamente).
Progreso: moodle_get_grade_items (informe de calificaciones de un curso), moodle_get_course_grades_overview (calificaciones finales en todos los cursos), moodle_get_completion_status (finalización de actividades).
Actividades: moodle_list_assignments, moodle_list_assignment_submissions, moodle_list_quizzes. Calendario: moodle_list_calendar_events, moodle_list_upcoming_deadlines. Foros: moodle_list_forums, moodle_list_forum_discussions, moodle_get_discussion_posts. Mensajes: moodle_list_conversations y moodle_send_message, la única herramienta que escribe.
Funciones detrás de las herramientas (añade estas a un servicio personalizado): 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.
Los errores vienen con HTTP 200: Moodle responde a una llamada fallida con estado 200 y un cuerpo que contiene exception, errorcode y message. El conector convierte eso en una llamada fallida. Códigos comunes: invalidtoken (token incorrecto, expirado o eliminado), accessexception (la función no está en el servicio del token, o los servicios web están desactivados), nopermissions (el usuario carece de una capacidad, nombrada en el mensaje), invalidparameter (un valor tiene el tipo incorrecto) e invalidrecord (no existe tal id). Muchas herramientas también devuelven warnings junto a los datos cuando se omitieron elementos individuales: léelos.
Ids: Moodle tiene tres ids por actividad. cmid (id del módulo del curso) es el que aparece en las direcciones de página y en moodle_get_course_contents; instance (o id en las listas de tareas, cuestionarios y foros) es lo que toman las herramientas de actividad. Los ids de usuario, curso y grupo son números simples.
Valores: los tiempos son segundos Unix (0 significa no establecido). Las banderas son números: 1 para sí, 0 para no; Moodle rechaza las palabras verdadero y falso. Textos como summary, intro y message son HTML.
Permisos: cada llamada se ejecuta como el usuario del token. Un token de estudiante lee sus propios cursos, calificaciones y fechas límite; las listas de participantes, calificaciones de otros y entregas necesitan un profesor o gestor. No hay un límite de tasa documentado; la capacidad propia del sitio es el límite, así que prefiere una llamada con varios ids de curso sobre una llamada por curso.
Requisitos previos: MOODLE_URL, MOODLE_TOKEN
Instala el conector 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
Abre http://localhost:3000/connectors/store, elige Moodle y pega las variables de entorno listadas bajo Requisitos previos.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
moodle_get_site_info | Lee el sitio y el usuario al que pertenece el token: sitename, siteurl, release (versión de Moodle), userid, username, fullname, lang y si… |
moodle_list_my_courses | Lista los cursos del usuario del token como en el panel de Moodle: id, fullname, shortname, summary, startdate, enddate (segundos Unix)… |
moodle_list_user_courses | Lista los cursos en los que un usuario está inscrito: id, shortname, fullname, category, startdate, enddate, lastaccess (segundos Unix), progreso en… |
moodle_list_courses | Lee cursos por id con sus configuraciones: id, shortname, fullname, categoryid, summary, format, startdate, enddate, visible, numsections… |
moodle_get_courses_by_field | Encuentra cursos por un campo y lee lo que el usuario del token puede ver de ellos: id, fullname, shortname, categoryid, categoryname, summary… |
moodle_search_courses | Busca en el catálogo de cursos por texto: por id de curso, fullname, shortname, categoryid, categoryname, summary, contactos (profesores) y… |
moodle_get_course_contents | Lee el contenido de un curso: sus secciones (id, nombre, resumen, número de sección, visible) y en cada una las actividades y recursos como… |
moodle_list_categories | Lista categorías de cursos: id, nombre, descripción, padre (0 en el nivel superior), coursecount, depth y path. Sin un filtro, cada categoría… |
moodle_list_enrolled_users | Lista los participantes de un curso: id, username, fullname, email, idnumber, department, lastaccess y lastcourseaccess (segundos Unix)… |
moodle_get_users_by_field | Busca usuarios por id, nombre de usuario, correo electrónico o idnumber (valores exactos): id, username, firstname, lastname, fullname, email, department, idnumber… |
moodle_search_users | Busca los usuarios del sitio por un campo: id, username, firstname, lastname, fullname, email, idnumber, department, lastaccess y… |
moodle_get_grade_items | Lee el informe de calificaciones de un curso: por usuario gradeitems con itemname, itemtype (mod, category, course), itemmodule, graderaw… |
moodle_get_course_grades_overview | Lee la calificación final de un usuario en cada curso en el que está inscrito: courseid, grade (como se muestra) y rawgrade. Usa… |
moodle_get_completion_status | Lee qué actividades de un curso ha completado un usuario: por actividad cmid, modname, instance, state (0 no completado, 1 completado, 2… |
moodle_list_assignments | Lista las tareas de los cursos: por curso assignments con id, cmid, name, intro, duedate, allowsubmissionsfromdate, cutoffdate… |
moodle_list_assignment_submissions | Lista las entregas de tareas: por tarea submissions con id, userid, attemptnumber, status (nuevo, borrador, enviado, reabierto)… |
moodle_list_quizzes | Lista los cuestionarios de los cursos: id, coursemodule, course, name, intro, timeopen, timeclose (segundos Unix, 0 cuando no está establecido), timelimit en… |
moodle_list_calendar_events | Lista eventos del calendario: id, nombre, descripción, courseid, groupid, userid, modulename, instance, eventtype (usuario, curso, grupo, sitio, debido… |
moodle_list_upcoming_deadlines | Lista lo que el usuario del token tiene que hacer a continuación, como en la línea de tiempo de Moodle: eventos con una acción como una tarea a entregar o un cuestionario a… |
moodle_list_forums | Lista los foros de los cursos: id, curso, nombre, intro, tipo (noticias, general, preguntas y respuestas, único y otros), cmid, numdiscussions… |
moodle_list_forum_discussions | Lista las discusiones de un foro: por discusión discussion (el id de discusión para moodle_get_discussion_posts), nombre, asunto, mensaje de… |
moodle_get_discussion_posts | Lee todas las publicaciones de una discusión de foro: id, asunto, mensaje (HTML), autor (id, fullname), parentid (la publicación a la que responde), timecreated… |
moodle_list_conversations | Lista las conversaciones privadas del usuario del token: id, nombre, tipo (1 entre dos usuarios, 2 grupo, 3 notas para uno mismo), membercount, unreadcount… |
moodle_send_message | Envía un mensaje privado de Moodle del usuario del token a otro usuario. El destinatario es notificado según lo que digan sus preferencias de Moodle (web, correo… |
Ejemplos de prompts
- "¿Qué tareas tienen que entregarse en mis cursos esta semana?"
- "Lista los participantes del curso 42 que no han entregado la tarea del ensayo."
- "Muestra mi resumen de calificaciones en todos los cursos."
- "¿Qué actividades del curso Biología 101 no he completado aún?"
- "Resume las últimas discusiones en el foro del curso."
Próximos pasos
¿Te ha sido útil esta guía?