Brightspace D2l MCP
D2L Brightspace para Claude, ChatGPT y Cursor. Sabe lo que ya has entregado, así que solo muestra lo que realmente queda.
Documentación
Servidor MCP Brightspace D2L
Conecta D2L Brightspace a Claude, ChatGPT, Cursor y Copilot.
Sabe lo que ya has entregado, así que solo muestra lo que realmente falta.
Un solo comando. Inicia sesión como siempre lo haces. Sin contraseñas almacenadas.
Por Nick, estudiante de redes en Fleming College
Un servidor MCP (Model Context Protocol) que da a los asistentes y agentes de IA acceso de lectura a tus cursos de Brightspace: fechas de entrega con estado real de envío, calificaciones, tareas, rúbricas, contenido del curso, anuncios, debates y listas de clase. Funciona en cualquier escuela que use D2L Brightspace, incluidas las que usan inicio de sesión único de Microsoft, Duo, Okta o Shibboleth.
Inicio rápido
Necesitas Node.js 20 o más reciente y Google Chrome o Microsoft Edge.
npx brightspace-d2l-mcp setup
Eso es todo. La configuración pide tu escuela, abre un navegador para que inicies sesión y conecta cada aplicación de IA que encuentre. Luego pregúntale a tu IA:
"¿En qué debería trabajar ahora mismo?"
¿Nuevo en esto? La guía de configuración paso a paso explica todo con imágenes de cada paso.
Lo que puedes preguntar
| Prueba a preguntar | |
|---|---|
| ✅ Lo que falta | "¿En qué debería trabajar ahora mismo?" · "¿Qué no he enviado todavía?" |
| 📅 Fechas límite | "¿Qué vence esta semana?" · "¿Algo vence mañana?" |
| 📊 Calificaciones | "¿Cuáles son mis calificaciones?" · "¿Estoy aprobando Cálculo?" |
| 📢 Anuncios | "¿Algún profesor publicó algo hoy?" |
| 📚 Contenido del curso | "Encuentra las diapositivas del repaso del parcial" · "Resume las instrucciones del Laboratorio 3" |
| 📎 Archivos de tareas | "¿Qué pide la rúbrica del proyecto?" |
| 💬 Debates | "¿Qué dice la gente en el hilo del proyecto final?" |
| 👥 Lista de clase | "¿Quién es el asistente de mi curso de redes?" |
| 🎯 Calificación objetivo | "¿Qué necesito en el final para obtener un 80?" · "¿Todavía puedo aprobar?" |
| 🗓️ Calendario | "Pon mis fechas límite en mi calendario" |
| 📝 Exámenes | "¿Cuándo es mi parcial?" · "¿Qué hay en mi agenda esta semana?" |
| 🔔 Novedades | "Ponme al día" · "¿Se calificó algo?" |
Sabe lo que ya has entregado
La mayoría de las herramientas solo ven fechas de entrega, así que te siguen diciendo que hagas trabajo que ya terminaste. Esta verifica tu envío real de cada tarea:
| Estado | Significado |
|---|---|
submitted / graded | Hecho. Nunca se sugiere como pendiente. |
not_submitted / draft | Todavía necesita hacerse. |
not_open_yet | El buzón no ha abierto; muestra cuándo abrirá. |
closed / past_due | Ya no puedes enviar. |
unknown | Cuestionarios: Brightspace no muestra a los estudiantes sus intentos de cuestionario, así que tu IA te preguntará. |
Herramientas
17 herramientas MCP para D2L Brightspace. Todo se lee desde Brightspace y nada se cambia allí:
| Herramienta | Qué hace |
|---|---|
get_todo | Lista de tareas priorizada en todos los cursos: qué vence pronto, está atrasado, aún no abre y ya está hecho |
get_upcoming_due_dates | Próximas fechas límite con el estado real de envío de cada tarea |
get_my_courses | Tus cursos inscritos con nombres, códigos e ids |
get_my_grades | Desglose de calificaciones por curso con puntos, porcentajes y comentarios del instructor |
get_assignments | Tareas (buzones) y cuestionarios con fechas límite, estado y rúbricas |
get_assignment_files | Lee las instrucciones, documentos y archivos de rúbrica adjuntos a una tarea |
get_course_content | Módulos del curso, diapositivas de clase, archivos y enlaces |
get_syllabus | Programa y resumen del curso |
get_announcements | Anuncios recientes (noticias) de tus instructores |
get_discussions | Foros de debate, temas y publicaciones |
get_roster | Instructores y asistentes con información de contacto, opcionalmente la lista completa de clase |
get_classlist_emails | Direcciones de correo de todos en un curso |
download_file | Guarda un archivo del curso o un envío en una carpeta que elijas |
get_grade_outlook | Tu posición en un curso y lo que necesitas en el trabajo restante para alcanzar una calificación objetivo |
export_due_dates_calendar | Crea un archivo de calendario (.ics) de tus fechas límite pendientes para Google Calendar, Apple Calendar y Outlook |
get_calendar_events | Exámenes, pruebas, laboratorios, clases y otros eventos de los calendarios de tus cursos |
get_whats_new | Puesta al día en todos los cursos: nuevos anuncios, trabajo recién calificado, debates no leídos y cuestionarios no intentados |
Prompts integrados
Las aplicaciones que admiten prompts de MCP los muestran como accesos directos de un clic o comandos de barra:
what_should_i_do_now · plan_my_week · weekly_digest · grade_target · exam_prep · summarize_assignment · put_deadlines_in_my_calendar · catch_me_up · when_are_my_exams
Funciona en cualquier escuela con Brightspace
Cada escuela inicia sesión de manera diferente: Microsoft, ADFS, Duo, Shibboleth, Okta, Google, selectores de campus o el propio formulario de Brightspace. En lugar de adivinar cómo funciona tu escuela, la configuración abre una ventana de navegador normal e inicias sesión exactamente como lo haces todos los días, incluidos códigos de texto y aplicaciones de autenticación.
Después de eso, permanece con la sesión iniciada silenciosamente en segundo plano. Si tu escuela te pide iniciar sesión nuevamente, la ventana del navegador simplemente aparece y se cierra sola cuando terminas.
¿Funciona mi escuela?
Si tu escuela usa D2L Brightspace, sí. La configuración abre una ventana de navegador normal, por lo que cualquier inicio de sesión funciona, incluidos Microsoft, Duo, Okta y Shibboleth.
| Escuela | Estado |
|---|---|
| Fleming College | Probada por el autor |
| Cualquier otra escuela con D2L | Debería funcionar. Abre un issue con la tuya y la agregaré aquí |
Funciona con tu aplicación o agente de IA
Conectadas automáticamente por la configuración: Claude Desktop · Claude Code · Cursor · VS Code (GitHub Copilot) · Windsurf · OpenAI Codex · Gemini CLI · Cline · Roo Code · OpenCode · Zed · LM Studio · Kiro
A un copiar y pegar de distancia: ChatGPT (modo desarrollador) · Continue · Goose · JetBrains AI Assistant · Warp · Amp · Msty · Jan · AnythingLLM
Marcos de agentes: OpenAI Agents SDK · Claude Agent SDK · LangChain / LangGraph · Vercel AI SDK · Mastra · CrewAI · Pydantic AI · LlamaIndex
Se ejecuta sobre stdio para aplicaciones locales y HTTP transmisible (serve --http) para ChatGPT y agentes alojados.
Consulta docs/agents.md para la configuración de copiar y pegar para cada uno de estos.
Instálalo con tu IA
Pega esto en Claude Code, Cursor, Windsurf, Copilot o Codex y configurará todo por ti.
Install brightspace-d2l-mcp for me by following
https://github.com/AnonymousOnyx22/brightspace-d2l-mcp/blob/main/llms.txt
Comandos
| Comando | Qué hace |
|---|---|
npx brightspace-d2l-mcp setup | Elige tu escuela, inicia sesión, conecta tus aplicaciones de IA. En Windows la ventana se cierra sola al terminar (--keep-open para evitar eso) |
npx brightspace-d2l-mcp login | Inicia sesión nuevamente |
npx brightspace-d2l-mcp status | Muestra tu escuela, si tienes la sesión iniciada y las aplicaciones conectadas |
npx brightspace-d2l-mcp doctor | Verifica Node, tu escuela, el inicio de sesión y las aplicaciones conectadas, y dice cómo arreglar cualquier problema |
npx brightspace-d2l-mcp logout | Elimina la sesión guardada |
Cuando hay una versión más reciente, los comandos preguntan si actualizar primero. Configura BRIGHTSPACE_NO_UPDATE_CHECK=1 para desactivar eso.
| npx brightspace-d2l-mcp uninstall | Elimina de todas las aplicaciones de IA y borra todos los datos locales |
| npx brightspace-d2l-mcp serve --http | Ejecuta sobre HTTP para ChatGPT y agentes basados en HTTP |
| npx brightspace-d2l-mcp config | Imprime el JSON de configuración de MCP para cualquier otra aplicación |
Opciones de configuración
npx brightspace-d2l-mcp setup --school yourschool.brightspace.com # skip the school question
npx brightspace-d2l-mcp setup --apps claude-desktop,cursor # only connect these apps
npx brightspace-d2l-mcp setup --skip-login # sign in later, on first use
npx brightspace-d2l-mcp setup --yes # accept every default
Ids de aplicaciones: claude-desktop, claude-code, cursor, vscode, windsurf, codex, gemini-cli, cline, roo-code, opencode, zed, lm-studio, kiro.
Privacidad y seguridad
- Tu contraseña nunca se ve ni se almacena. La escribes en la página de inicio de sesión de tu propia escuela en un navegador real.
- Solo lectura. No puede enviar, publicar ni cambiar nada en Brightspace. Ninguna herramienta envía nada más que solicitudes GET, el cliente de API no tiene métodos de escritura en absoluto, y una prueba falla la compilación si alguna vez se agrega uno. Consulta cómo se aplica el modo solo lectura.
- Solo local. Todo se ejecuta en tu computadora y solo habla con el Brightspace de tu escuela. No hay servidor intermedio ni análisis.
- Usa la API oficial de Brightspace con el mismo acceso que tienes en tu navegador.
- Tu sesión se guarda en
~/.brightspace-d2l-mcp/, legible solo por tu cuenta de usuario.logoutla elimina;uninstallelimina todo.
Solución de problemas
"No se encontró un navegador compatible"
Instala Google Chrome o usa Microsoft Edge (ya está en Windows).
O instala una copia privada de Chromium con npx playwright install chromium.
La dirección de mi escuela no es aceptada
Inicia sesión en Brightspace en tu navegador y luego copia la dirección de la barra de direcciones (cualquier página funciona). Si dice que tu sitio "ejecuta Blackboard" o "Canvas", tu escuela no usa Brightspace.
Brightspace no aparece en Claude Desktop
Cierra Claude Desktop por completo (ícono de la bandeja → Salir, no solo cerrar la ventana) y luego ejecuta setup nuevamente.
Claude Desktop reescribe su configuración mientras está abierto, por lo que la configuración ofrece reiniciarlo por ti.
Me pide iniciar sesión constantemente
Algunas escuelas terminan las sesiones cada pocas horas. Cuando eso sucede, se abre una ventana del navegador para que inicies sesión nuevamente.
Ejecuta npx brightspace-d2l-mcp doctor para descubrir qué está mal, status para una revisión rápida, o login para iniciar sesión de inmediato.
Si prefieres que nunca abra una ventana por sí solo, agrega "autoLogin": false a ~/.brightspace-d2l-mcp/config.json.
Quiero filtrar cursos antiguos
Agrega ids de cursos a ~/.brightspace-d2l-mcp/config.json:
{ "excludeCourses": [123456, 789012] }
O conserva solo algunos específicos con "includeCourses". Pregunta a tu IA "lista mis cursos con sus ids" para encontrarlos.
Preguntas frecuentes
¿Cómo conecto D2L Brightspace a Claude?
Ejecuta npx brightspace-d2l-mcp setup. Conecta Claude Desktop y Claude Code automáticamente. Luego pregúntale a Claude sobre tus cursos.
¿Hay un asistente de IA para D2L Brightspace?
Sí. Esto conecta Brightspace a la aplicación de IA que ya usas (Claude, ChatGPT, Cursor, GitHub Copilot, Gemini y otras), para que puedas preguntar sobre fechas límite, calificaciones y archivos del curso en lenguaje natural en lugar de navegar por cada curso.
¿Cómo uso ChatGPT con Brightspace?
Ejecuta npx brightspace-d2l-mcp serve --http, exponlo con un túnel y agrega la URL como conector en el modo desarrollador de ChatGPT. docs/agents.md explica cada paso.
¿Cómo conecto Brightspace a Cursor, VS Code Copilot o Windsurf?
Ejecuta `npx brightspace-d2l-mcp setup`. Encuentra Cursor, VS Code, Windsurf y otras 10 aplicaciones y las conecta por ti.¿Puedo usarlo con ChatGPT, un agente personalizado o el Claude Agent SDK?
Sí. Los agentes locales y los SDK lo lanzan con npx -y brightspace-d2l-mcp@latest, y ChatGPT o los agentes basados en HTTP usan npx brightspace-d2l-mcp serve --http. docs/agents.md tiene configuración de copiar y pegar para ChatGPT, el OpenAI Agents SDK, Claude Agent SDK, LangChain, Vercel AI SDK y más.
¿Necesita una clave de API o acceso de administrador de mi escuela?
No. Las claves de API de Brightspace normalmente requieren un administrador. Esto usa tu propio inicio de sesión de estudiante, así que ve exactamente lo que tú ves en Brightspace, y nadie en tu escuela tiene que configurar nada.
¿Funciona con Duo, Microsoft Authenticator o códigos por mensaje de texto?
Sí. Tú inicias sesión en una ventana de navegador real, así que cualquier método de inicio de sesión que use tu escuela funciona.
¿Puede decirme qué necesito en el final para alcanzar una calificación?
Sí. Pregunta "¿qué necesito en el final para obtener un 80 en Cálculo?" y get_grade_outlook usa los pesos que Brightspace reporta para darte tu porcentaje actual, tu mejor y peor calificación final posible, y el promedio que necesitas en todo lo que queda.
¿Puedo obtener mis fechas de entrega de Brightspace en Google Calendar, Apple Calendar u Outlook?
Sí. Pide a tu IA que ponga tus plazos en tu calendario. export_due_dates_calendar crea un archivo .ics con un enlace de vuelta a Brightspace y un recordatorio de un día en cada evento, y solo incluye el trabajo que no has entregado.
¿Con qué escuelas funciona?
Cualquier escuela en D2L Brightspace, ya sea que la dirección se vea como yourschool.brightspace.com, yourschool.desire2learn.com, o un dominio personalizado como learn.yourschool.edu.
¿Puede enviar tareas o publicar por mí?
No. Es de solo lectura a propósito.
¿Esto está hecho por D2L?
No. Es un proyecto independiente de código abierto que usa la API oficial de Brightspace con tu propio inicio de sesión. No está afiliado ni respaldado por D2L.
Desarrollo
git clone https://github.com/AnonymousOnyx22/brightspace-d2l-mcp.git
cd brightspace-d2l-mcp
npm install
npm run build
npm test
node build/index.js setup # connects your AI apps to this local build
Las herramientas viven en src/tools/, el inicio de sesión en src/auth/, y la configuración en src/cli/.
Los problemas y las solicitudes de extracción son bienvenidos.
Licencia
MIT © AnonymousOnyx22
D2L y Brightspace son marcas comerciales de D2L Corporation. Este proyecto no está afiliado con D2L.