安裝

npx brightspace-mcp-server setup

適合誰

如果你已經有學校的 D2L Brightspace 帳號，希望在支援 MCP 的對話環境裡按需查看成績、作業、教學大綱和課程內容，而不是反覆打開學習平台網頁，這個服務對口。官方說明它把 AI 接到 Brightspace，用來按需拉取這些課程資訊。

學校側寫的是能用於任何學校，但沒有給出學校清單、例外名單，也沒有說明哪些院系功能會被關掉。你需要自己確認學校登入頁可以打開，並且帳號能進入課程。

官方點名可用於 Claude Desktop、Claude Code、Cursor、ChatGPT Desktop、Windsurf。如果你的環境不在這份名單裡，原文沒有另給接入步驟，就不要自行補客戶端設定。

不適合需要在 Brightspace 裡交作業、發帖或改任何平台資料的人。官方寫明這是唯讀服務，不會提交、發布或更改任何內容。

先決條件：本機已安裝能執行 npx 的環境，並且你能打開自己學校的真實 Brightspace 登入頁。使用者名稱和密碼只會打進學校登入頁，不會打到別處；完成後保存在本機 ~/.brightspace-mcp/config.json，僅目前使用者可讀（mode 0600）。

只走這一條官方安裝路徑。在終端執行：

npx brightspace-mcp-server setup

設定位置就是這條 setup 命令寫入的本機檔案 ~/.brightspace-mcp/config.json。第一次嘗試直接執行這條官方命令，不要改成未寫出的安裝器，也不要編造未寫出的工具名去試讀成績。

成功訊號：setup 正常結束，且本機出現 ~/.brightspace-mcp/config.json、權限為目前使用者可讀。此後服務按官方說明保持唯讀，不會替你提交或改動 Brightspace 裡的任何內容。

案例一：按需查看成績。官方能力是連接 Brightspace 後按需拉取成績。可見說明只寫到「拉取成績」，沒有給出工具名、參數或回傳欄位。能確認的是：這屬於唯讀讀取，成功時應能看到成績相關資訊，且不會在平台上提交或改動任何內容。若目前客戶端沒有列出成績相關呼叫，就停在已寫出的能力邊界。

案例二：按需查看作業、教學大綱與課程內容。官方同一句話把作業、教學大綱和課程內容列為可按需拉取的資訊。同樣沒有寫出工具名、過濾條件或輸出樣例。提問應限制在這些唯讀材料；成功時能讀到對應課程資訊，失敗時只能說明官方尚未給出更細的呼叫格式，不要自行補參數。

這是唯讀服務，不會提交、發帖或更改 Brightspace 中的任何內容。唯讀不等於沒有風險：本機仍會儲存學校帳號，客戶端仍會連網讀取課程資料。

憑證只留在本機 ~/.brightspace-mcp/config.json，權限為 0600；登入資訊只打進學校真實登入頁。官方沒有寫出刪除該檔案後的復原步驟，也沒有寫出具體工具名和參數。除 setup 外不要再發明第二條安裝命令。