udesa-mcp

MCP (Model Context Protocol) no oficial para el Campus Virtual (Moodle 5.1) de la Universidad de San Andrés. Le da a un agente (Claude Code, Codex, ChatGPT…) acceso a tus cursos con tu propia cuenta, sea cual sea tu rol: estudiantes y docentes leen lo suyo en todos sus cursos, y quien es docente o gestor en un curso además ve los datos de otras personas y puede escribir ahí. Las políticas de alcance y de escritura las aplica este servidor.

Funciona en dos modos con el mismo núcleo:

• local (STDIO): las credenciales quedan en el almacén seguro de tu sistema;
• remoto privado en Vercel: OAuth propio y login con GitHub, limitado a una sola cuenta (la tuya).

Cada resultado trae procedencia, cobertura y advertencias. Un error nunca se presenta como lista vacía.

Proyecto personal, sin relación oficial con UdeSA. Usalo con tu propia cuenta y respetando las políticas de la universidad.

Qué puede hacer

Lecturas. Todos los cursos donde la cuenta está matriculada, con cualquier rol (ADR-122):

• Con cualquier rol: contenido, archivos, foros, avisos, calendario, tus notas y tus intentos de cuestionarios y H5P. Los intentos se ven según las opciones de revisión de cada cuestionario (ADR-123).
• Con rol docente o superior (editingteacher, teacher, manager o coursecreator) en ese curso, también los datos de terceros:
  • entregas, notas, intentos, participantes (con email, legajo, país, descripción y foto, ADR-124), grupos, asistencia y pendientes;
  • con sesión web, estructura de cuestionarios, preguntas y reportes.

Escrituras. En todos los cursos donde tu rol es de profesor, gestor o superior (editingteacher, manager o coursecreator), con las capacidades del perfil de escritura (ADR-125). Conviene probar cada capacidad primero en un curso de pruebas (sandbox). Cubren:

• foros (avisos, respuestas, edición, adjuntos, moderación);
• calendario;
• tareas: prórrogas, excepciones, bloqueo y comentarios de entregas;
• calificación de tareas, foros y preguntas: a mano, con escala, rúbrica o guía, y con archivos de retroalimentación;
• libro de calificaciones y asistencia;
• cuestionarios: crear, importar preguntas, armarlos por páginas y secciones, overrides, estado de preguntas;
• contenido: páginas, enlaces (también incrustados), etiquetas, archivos, foros y fechas de actividades. Desde ChatGPT, los archivos que adjuntás o que genera la conversación se suben a recursos y carpetas, también en el remoto (ADR-129);
• estructura: mostrar, mover, renombrar, secciones;
• grupos, agrupamientos y elecciones de grupo;
• cada tipo de elemento: carpetas, libros, wikis (también por grupo o individuales), glosarios, consultas, bases de datos, lecciones, encuestas y más (docs/SANDBOX_ELEMENTOS.md);
• contenido H5P generado por el MCP (ADR-110 y 111): cuestionarios, presentaciones, libros, videos interactivos, escenarios ramificados, tarjetas, gráficos, líneas de tiempo y acordeones desde un esquema tipado, también en el remoto;
• laboratorio en Vercel (ADR-116 y 117): ejercicios de Python con pruebas automáticas, incrustados o como actividad LTI con nota en el libro de calificaciones, y un visor paso a paso de ejecuciones de Python ya registradas;
• borrados (R4), también en lote, de intentos de cuestionario y de entregas de estudiantes (ADR-119).

Reglas de las escrituras:

• Toda escritura se planifica primero (campus_plan_*), se ejecuta con campus_execute_plan y se verifica releyendo el Campus. Muchas se pueden deshacer.
• Hasta 2000 escrituras por día (ADR-078).
• No hay aprobación fuera del chat (ADR-061). Para R3 y R4 decide el humano: el agente le plantea la acción y sólo ejecuta con su aprobación, o el servidor se la pregunta por elicitación (ADR-118).
• Notificaciones a participantes permitidas (allow_participant_notifications: true, ADR-130). Publicar o responder en Avisos (suscripción forzada) de un curso real y mandar un mensaje privado son R3: el agente te pide aprobación antes. Las calificaciones de tareas y foros solicitan aviso por defecto; se puede desactivar por plan. Con false, sólo se notifica a las cuentas de prueba de tu sandbox (notifiable_user_ids, ADR-115 y 120). El perfil publicado trae esa lista y la del sandbox vacías: se completan con los tuyos (PROCESOS.md).

Sesión web automática (opcional, no recomendada; ADR-087, ADR-088 y ADR-127). Donde el keepalive no es viable, el MCP local y el remoto pueden iniciar sesión en la web solos, con la contraseña guardada y un dispositivo de confianza de 28 días (el MFA por correo se pide sólo al activarlo o renovarlo).

以上為 README 的開頭部分。其餘內容請閱讀原文。 檢視完整 README ↗