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 plazos, foros y mensajes. URL del sitio y token de servicio web.
Configuración guiada
Conecta Moodle a Microsoft 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 Microsoft Copilot. 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.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Moodle, ingresa 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 + Microsoft Copilot
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 plazos, foros y mensajes. URL del sitio y token de servicio web.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
MOODLE_URL, MOODLE_TOKEN
Paso 1 — Obtener credenciales
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 Agregar funciones y añade 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 ser utilizado 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 deseas 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 ejemplohttps://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 todo lo demás necesita.
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 a través de 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) y 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 plazos; 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.
Paso 2 — Instalar el adaptador
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
Paso 3 — Añadir el conector en Microsoft Copilot
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
Moodle. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
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, summary, 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, username, email 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, vencido… |
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 indicaciones
- "¿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."
Preguntas frecuentes
¿De dónde proviene el token? Un administrador de Moodle habilita los servicios web y el protocolo REST, añade un servicio con las funciones que utilizan las herramientas (el servicio web móvil de Moodle ya tiene todas menos una), y crea un token para un usuario bajo Gestionar tokens. Los usuarios también pueden usar su propio token del servicio móvil desde Preferencias, Claves de seguridad cuando el sitio lo permite. En AnythingMCP Cloud, el sitio debe ser accesible desde internet a través de HTTPS.
¿Qué puede ver? Exactamente lo que el usuario del token puede ver: un token de estudiante lee sus propios cursos, calificaciones y plazos; los participantes, calificaciones de otros y entregas necesitan un profesor o gestor. Cubre cursos y contenido, usuarios, calificaciones, finalización de actividades, tareas y entregas, cuestionarios, el calendario, foros y mensajes privados, para Moodle 4 y 5, autoalojado o MoodleCloud.
¿Qué herramientas escriben, y qué instalaciones están desactivadas? Solo moodle_send_message escribe, envía un mensaje privado. Nada instala desactivado.
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Próximos pasos
¿Te ha sido útil esta guía?