Ver notas e conteúdo da disciplina sob demanda com Brightspace MCP

Para quem

Se já tem uma conta escolar D2L Brightspace e quer ver notas, trabalhos, ementas e conteúdo da disciplina sob demanda num chat compatível com MCP, em vez de abrir repetidamente o site da plataforma, este serviço serve. Oficialmente liga a IA ao Brightspace para extrair essa informação da disciplina sob demanda.

O lado da escola escreve que serve para qualquer escola, mas não dá inventário de escolas, lista de exceções nem quais funções de faculdade são desligadas. Precisa confirmar você mesmo que a página de início de sessão da escola abre e que a conta entra nas disciplinas.

Nomes oficiais: Claude Desktop, Claude Code, Cursor, ChatGPT Desktop, Windsurf. Se o seu ambiente não está nessa lista, o texto original não dá outros passos de ligação. Não invente configuração de cliente.

Não serve se precisar entregar trabalhos, publicar ou alterar dados da plataforma no Brightspace. Oficialmente é um serviço somente leitura. Não submete, não publica nem altera nenhum conteúdo.

Primeira tentativa em 3 minutos

Pré-requisitos: esta máquina tem um ambiente que consegue executar npx, e você consegue abrir a página real de início de sessão Brightspace da sua escola. Nome de utilizador e senha só entram na página de início de sessão da escola, em nenhum outro sítio. Ao terminar ficam guardados nesta máquina em ~/.brightspace-mcp/config.json, legíveis só pelo utilizador atual (mode 0600).

Siga só este caminho oficial de instalação. Num terminal:

npx brightspace-mcp-server setup

A localização da configuração é o ficheiro local ~/.brightspace-mcp/config.json que este comando setup escreve. Na primeira tentativa execute este comando oficial tal qual. Não mude para um instalador nunca escrito, nem invente nomes de ferramentas nunca escritos para tentar ler notas.

Sucesso: setup termina normalmente, ~/.brightspace-mcp/config.json aparece nesta máquina e a permissão é legível pelo utilizador atual. Depois o serviço mantém-se somente leitura segundo o texto oficial. Não submete nem altera nada no Brightspace por si.

Casos de uso

Caso 1: ver notas sob demanda. Capacidade oficial: extrair notas sob demanda após ligar ao Brightspace. O texto visível só escreve «extrair notas». Não há nome de ferramenta, parâmetros nem campos devolvidos. Confirmável: é uma leitura somente leitura. Em caso de sucesso deve ver informação relacionada com notas, sem submissão nem alteração na plataforma. Se o cliente atual não mostrar uma chamada relacionada com notas, pare no limite de capacidade escrito.

Caso 2: ver trabalhos, ementas e conteúdo da disciplina sob demanda. A mesma frase oficial coloca trabalhos, ementas e conteúdo da disciplina como informação extraível sob demanda. Também não há nome de ferramenta, filtro nem amostra de saída. Limite as perguntas a estes materiais somente leitura. Em caso de sucesso lê a informação da disciplina correspondente. Em caso de falha, só pode dizer que o texto oficial ainda não deu um formato de chamada mais fino. Não invente parâmetros.

Limites de uso

É um serviço somente leitura. Não submete, não publica nem altera nenhum conteúdo no Brightspace. Somente leitura não é ausência de risco: esta máquina continua a guardar a conta escolar e o cliente continua a ler dados da disciplina pela rede.

As credenciais ficam só em ~/.brightspace-mcp/config.json nesta máquina, permissão 0600. A informação de início de sessão só entra na página real de início de sessão da escola. Oficialmente não há um passo de desfazer após apagar esse ficheiro, nem nomes de ferramentas e parâmetros concretos. Além de setup, não invente um segundo comando de instalação.