Brightspace D2l MCP
D2L Brightspace para Claude, ChatGPT e Cursor. Sabe o que você já entregou, então mostra apenas o que realmente falta.
Documentação
Servidor MCP Brightspace D2L
Conecte o D2L Brightspace ao Claude, ChatGPT, Cursor e Copilot.
Ele sabe o que você já entregou, então mostra apenas o que realmente falta.
Um comando. Entre do mesmo jeito que você sempre faz. Nenhuma senha armazenada.
Por Nick, um estudante de redes no Fleming College
Um servidor MCP (Model Context Protocol) que dá a assistentes de IA e agentes acesso de leitura aos seus cursos do Brightspace: datas de entrega com status real de envio, notas, tarefas, rubricas, conteúdo do curso, avisos, discussões e listas de turma. Funciona em qualquer escola que use o D2L Brightspace, incluindo escolas com login único Microsoft, Duo, Okta ou Shibboleth.
Início rápido
Você precisa de Node.js 20 ou mais recente e Google Chrome ou Microsoft Edge.
npx brightspace-d2l-mcp setup
É isso. A configuração pede sua escola, abre um navegador para você entrar e conecta todos os aplicativos de IA que encontrar. Depois pergunte à sua IA:
"No que devo trabalhar agora?"
Novo nisso? O guia de configuração passo a passo explica tudo com imagens de cada etapa.
O que você pode perguntar
| Tente perguntar | |
|---|---|
| ✅ O que falta | "No que devo trabalhar agora?" · "O que ainda não enviei?" |
| 📅 Prazos | "O que vence esta semana?" · "Tem algo vencendo amanhã?" |
| 📊 Notas | "Quais são minhas notas?" · "Estou passando em Cálculo?" |
| 📢 Avisos | "Algum professor postou algo hoje?" |
| 📚 Conteúdo do curso | "Encontre os slides de revisão da prova" · "Resuma as instruções do Lab 3" |
| 📎 Arquivos de tarefas | "O que a rubrica do projeto pede?" |
| 💬 Discussões | "O que estão dizendo no tópico do projeto final?" |
| 👥 Lista de turma | "Quem é o monitor do meu curso de redes?" |
| 🎯 Nota alvo | "O que preciso na final para tirar 80?" · "Ainda posso passar?" |
| 🗓️ Calendário | "Coloque meus prazos no meu calendário" |
| 📝 Provas | "Quando é minha prova parcial?" · "O que tem na minha agenda esta semana?" |
| 🔔 Novidades | "Me atualize" · "Algo foi corrigido?" |
Ele sabe o que você já entregou
A maioria das ferramentas só vê datas de entrega, então ficam te dizendo para fazer trabalhos que você já terminou. Este verifica seu envio real para cada tarefa:
| Status | Significado |
|---|---|
submitted / graded | Concluído. Nunca sugerido como pendência. |
not_submitted / draft | Ainda precisa ser feito. |
not_open_yet | A caixa de envio ainda não abriu; mostra quando vai abrir. |
closed / past_due | Você não pode mais enviar. |
unknown | Testes: o Brightspace não mostra aos alunos suas tentativas de teste, então sua IA vai perguntar a você. |
Ferramentas
17 ferramentas MCP para o D2L Brightspace. Tudo é lido do Brightspace e nada é alterado lá:
| Ferramenta | O que faz |
|---|---|
get_todo | Lista de tarefas priorizada em todos os cursos: o que vence em breve, atrasado, ainda não aberto e já concluído |
get_upcoming_due_dates | Próximos prazos com o status real de envio de cada tarefa |
get_my_courses | Seus cursos matriculados com nomes, códigos e ids |
get_my_grades | Detalhamento de notas por curso com pontos, porcentagens e comentários do instrutor |
get_assignments | Tarefas (caixas de envio) e testes com datas de entrega, status e rubricas |
get_assignment_files | Lê as instruções, apostilas e arquivos de rubrica anexados a uma tarefa |
get_course_content | Módulos do curso, slides de aula, arquivos e links |
get_syllabus | Ementa e visão geral do curso |
get_announcements | Avisos recentes (notícias) dos seus instrutores |
get_discussions | Fóruns de discussão, tópicos e postagens |
get_roster | Instrutores e monitores com informações de contato, opcionalmente a lista completa da turma |
get_classlist_emails | Endereços de e-mail de todos em um curso |
download_file | Salva um arquivo do curso ou envio em uma pasta que você escolher |
get_grade_outlook | Sua situação no curso e o que você precisa no trabalho restante para atingir uma nota alvo |
export_due_dates_calendar | Gera um arquivo de calendário (.ics) dos seus prazos pendentes para Google Calendar, Apple Calendar e Outlook |
get_calendar_events | Provas, testes, laboratórios, aulas e outros eventos dos calendários dos seus cursos |
get_whats_new | Atualização geral de todos os cursos: novos avisos, trabalhos recém-corrigidos, discussões não lidas e testes não tentados |
Prompts integrados
Aplicativos que suportam prompts MCP mostram estes como atalhos de um clique ou 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 em qualquer escola com Brightspace
Cada escola entra de um jeito diferente: Microsoft, ADFS, Duo, Shibboleth, Okta, Google, seletores de campus ou o próprio formulário do Brightspace. Em vez de adivinhar como sua escola funciona, a configuração abre uma janela de navegador normal e você entra exatamente como faz todos os dias, incluindo códigos por texto e aplicativos autenticadores.
Depois disso, ele permanece conectado silenciosamente em segundo plano. Se sua escola pedir que você entre novamente, a janela do navegador simplesmente aparece e fecha sozinha quando você terminar.
Minha escola funciona?
Se sua escola usa o D2L Brightspace, sim. A configuração abre uma janela de navegador normal, então qualquer login funciona, incluindo Microsoft, Duo, Okta e Shibboleth.
| Escola | Status |
|---|---|
| Fleming College | Testado pelo autor |
| Qualquer outra escola D2L | Deve funcionar. Abra uma issue com a sua e eu adicionarei aqui |
Funciona com seu aplicativo ou agente de IA
Conectado automaticamente pela configuração: Claude Desktop · Claude Code · Cursor · VS Code (GitHub Copilot) · Windsurf · OpenAI Codex · Gemini CLI · Cline · Roo Code · OpenCode · Zed · LM Studio · Kiro
A um copiar e colar de distância: ChatGPT (modo desenvolvedor) · Continue · Goose · JetBrains AI Assistant · Warp · Amp · Msty · Jan · AnythingLLM
Frameworks de agentes: OpenAI Agents SDK · Claude Agent SDK · LangChain / LangGraph · Vercel AI SDK · Mastra · CrewAI · Pydantic AI · LlamaIndex
Ele roda via stdio para aplicativos locais e HTTP transmissível (serve --http) para ChatGPT e agentes hospedados.
Veja docs/agents.md para configuração por copiar e colar para cada um destes.
Instale com sua IA
Cole isto no Claude Code, Cursor, Windsurf, Copilot ou Codex e ele configurará tudo para você.
Install brightspace-d2l-mcp for me by following
https://github.com/AnonymousOnyx22/brightspace-d2l-mcp/blob/main/llms.txt
Comandos
| Comando | O que faz |
|---|---|
npx brightspace-d2l-mcp setup | Escolha sua escola, entre, conecte seus aplicativos de IA. No Windows, a janela fecha sozinha ao terminar (--keep-open para impedir isso) |
npx brightspace-d2l-mcp login | Entre novamente |
npx brightspace-d2l-mcp status | Mostra sua escola, se você está conectado e os aplicativos conectados |
npx brightspace-d2l-mcp doctor | Verifica Node, sua escola, login e aplicativos conectados, e diz como corrigir qualquer problema |
npx brightspace-d2l-mcp logout | Exclui a sessão salva |
Quando uma versão mais nova está disponível, os comandos perguntam se você quer atualizar primeiro. Defina BRIGHTSPACE_NO_UPDATE_CHECK=1 para desativar isso.
| npx brightspace-d2l-mcp uninstall | Remove de todos os aplicativos de IA e exclui todos os dados locais |
| npx brightspace-d2l-mcp serve --http | Roda via HTTP para ChatGPT e agentes baseados em HTTP |
| npx brightspace-d2l-mcp config | Imprime o JSON de configuração MCP para qualquer outro aplicativo |
Opções de configuração
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 aplicativos: claude-desktop, claude-code, cursor, vscode, windsurf, codex, gemini-cli, cline, roo-code, opencode, zed, lm-studio, kiro.
Privacidade e segurança
- Sua senha nunca é vista ou armazenada. Você a digita na página de login da própria escola em um navegador real.
- Somente leitura. Não pode enviar, postar ou alterar nada no Brightspace. Nenhuma ferramenta envia nada além de solicitações GET, o cliente de API não tem nenhum método de escrita e um teste falha na compilação se algum for adicionado. Veja como a somente leitura é aplicada.
- Apenas local. Tudo roda no seu computador e fala apenas com o Brightspace da sua escola. Não há servidor no meio e nenhuma análise de dados.
- Usa a API oficial do Brightspace com o mesmo acesso que você tem no navegador.
- Sua sessão é salva em
~/.brightspace-d2l-mcp/, legível apenas pela sua conta de usuário.logouta exclui;uninstallexclui tudo.
Solução de problemas
"Nenhum navegador suportado foi encontrado"
Instale o Google Chrome ou use o Microsoft Edge (já vem no Windows).
Ou instale uma cópia privada do Chromium com npx playwright install chromium.
O endereço da minha escola não é aceito
Entre no Brightspace no seu navegador e copie o endereço da barra de endereço (qualquer página serve). Se disser que seu site "roda Blackboard" ou "Canvas", sua escola não usa Brightspace.
O Brightspace não aparece no Claude Desktop
Saia completamente do Claude Desktop (ícone da bandeja → Sair, não apenas fechar a janela) e execute setup novamente.
O Claude Desktop reescreve suas configurações enquanto está aberto, então a configuração oferece reiniciá-lo para você.
Fica pedindo para eu entrar
Algumas escolas encerram sessões a cada poucas horas. Quando isso acontece, uma janela do navegador abre para você entrar novamente.
Execute npx brightspace-d2l-mcp doctor para descobrir o que está errado, status para uma olhada rápida ou login para entrar imediatamente.
Se preferir que ele nunca abra uma janela sozinho, adicione "autoLogin": false a ~/.brightspace-d2l-mcp/config.json.
Quero filtrar cursos antigos
Adicione ids de cursos a ~/.brightspace-d2l-mcp/config.json:
{ "excludeCourses": [123456, 789012] }
Ou mantenha apenas os específicos com "includeCourses". Pergunte à sua IA "liste meus cursos com seus ids" para encontrá-los.
Perguntas frequentes
Como conecto o D2L Brightspace ao Claude?
Execute npx brightspace-d2l-mcp setup. Ele conecta o Claude Desktop e o Claude Code automaticamente. Depois pergunte ao Claude sobre seus cursos.
Existe um assistente de IA para o D2L Brightspace?
Sim. Isto conecta o Brightspace ao aplicativo de IA que você já usa (Claude, ChatGPT, Cursor, GitHub Copilot, Gemini e outros), para que você possa perguntar sobre prazos, notas e arquivos do curso em linguagem simples em vez de navegar por cada curso.
Como uso o ChatGPT com o Brightspace?
Execute npx brightspace-d2l-mcp serve --http, exponha-o com um túnel e adicione a URL como conector no modo desenvolvedor do ChatGPT. docs/agents.md explica cada etapa.
Como conecto o Brightspace ao Cursor, VS Code Copilot ou Windsurf?
Execute npx brightspace-d2l-mcp setup. Ele encontra Cursor, VS Code, Windsurf e outros 10 aplicativos e os conecta para você.
Posso usar isso com ChatGPT, um agente personalizado ou o Claude Agent SDK?
Sim. Agentes locais e SDKs o iniciam com npx -y brightspace-d2l-mcp@latest, e ChatGPT ou agentes baseados em HTTP usam npx brightspace-d2l-mcp serve --http. docs/agents.md tem configuração de copiar e colar para ChatGPT, OpenAI Agents SDK, Claude Agent SDK, LangChain, Vercel AI SDK e mais.
Precisa de uma chave de API ou acesso de administrador da minha escola?
Não. Chaves de API do Brightspace normalmente exigem um administrador. Isso usa seu próprio login de estudante, então vê exatamente o que você vê no Brightspace, e ninguém na sua escola precisa configurar nada.
Funciona com Duo, Microsoft Authenticator ou códigos por mensagem de texto?
Sim. Você faz login em uma janela de navegador real, então qualquer método de login que sua escola use funciona.
Ele pode me dizer o que preciso na prova final para alcançar uma nota?
Sim. Pergunte "o que preciso na final para tirar 80 em Cálculo?" e get_grade_outlook usa os pesos que o Brightspace reporta para dar sua porcentagem atual, sua melhor e pior nota final possível, e a média que você precisa em tudo que resta.
Posso colocar minhas datas de entrega do Brightspace no Google Calendar, Apple Calendar ou Outlook?
Sim. Peça à sua IA para colocar seus prazos no seu calendário. export_due_dates_calendar cria um arquivo .ics com um link de volta para o Brightspace e um lembrete de um dia em cada evento, e só inclui trabalhos que você ainda não entregou.
Com quais escolas ele funciona?
Qualquer escola no D2L Brightspace, seja o endereço parecido com yourschool.brightspace.com, yourschool.desire2learn.com, ou um domínio personalizado como learn.yourschool.edu.
Ele pode enviar trabalhos ou postar por mim?
Não. É somente leitura de propósito.
Isso é feito pela D2L?
Não. É um projeto independente de código aberto que usa a API oficial do Brightspace com seu próprio login. Não é afiliado ou endossado pela D2L.
Desenvolvimento
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
As ferramentas ficam em src/tools/, o login em src/auth/, e a configuração em src/cli/.
Issues e pull requests são bem-vindos.
Licença
MIT © AnonymousOnyx22
D2L e Brightspace são marcas registradas da D2L Corporation. Este projeto não é afiliado à D2L.