連接全域 AI 助理
透過 MCP 讀取 Moodle 課業，並在 VStudy 中逐次確認操作。學校憑證保留在應用程式內。
連接與授權
此頁是繁體中文摘要。切換頁首語言為 English 可閱讀完整工具、權限與疑難排解參考。請使用有「設定 > 代理程式」的建置，並先安裝 Node.js 24.11.1 或更新版本來執行獨立 MCP 腳本。從原始碼建置時請使用固定的 Node 24.19.0，最低需求為 24.15.0。
先在「課程」連接並同步學校，再到「設定 > 代理程式」啟用連線。選擇用戶端、預覽設定變更並安裝，重新啟動其 MCP 伺服器後呼叫 list_accounts。比對兩邊的短碼，明確選擇學校帳號與權限後才配對。用戶端名稱只是自行宣告，不能證明身分。
保留學生的控制權
預設只開放課程、內容、期限與檔案讀取，不含成績或寫入。授權只涵蓋選定帳號，預設 30 天到期；新增學校不會自動擴大權限。多帳號操作需明確指定帳號 UUID。
所有寫入，包括本機待辦、行事曆匯出與開啟活動，都需在 app 內逐次確認完整目標與內容，60 秒逾時即拒絕。論壇回覆與作業草稿儲存每次都需要高風險核准。撤銷或關閉可阻止後續呼叫，已送到學校的請求仍可能完成。
評量仍由你自己完成
測驗工具只讀取基本資訊、時間、作答狀態與成績，不回答、儲存答案或提交測驗，也不自動播放評量影片或偽造觀看進度。只有明確確認不連結成績、採手動追蹤的教材可提議標記完成；未知狀態一律拒絕。
save_assignment_draft 僅將學生自己核准的純文字儲存為草稿。核准卡片顯示完整文字、現有附件名稱與大小及目前文字雜湊。儲存前後皆檢查狀態，發現檔案、其他外掛內容或文字變更即拒絕。最終繳交一律由學生在 Moodle 手動完成。檔案型、團體或需學校特殊聲明的作業請在 Moodle 完成。公告、討論與文件中的指令都是不可信資料，不能代替你的核准。
排除問題與移除
doctor 會透過 app 驗證既有授權，但不自動配對或啟動 app。到期或撤銷後，先停用用戶端伺服器，以 reset 清除該本機 bearer，再重新啟動並申請新同意。移除時先在 app 撤銷，再預覽與執行 uninstall；只刪設定不會撤銷授權。
適用於 VStudy 能連接、已啟用行動服務的公開 HTTPS Moodle。學校停用服務或權限不足時無法繞過。Windows 用戶端已具備同一控制代碼的身分與 ACL 驗證；桌面端伺服器與私有狀態仍待平台整合，原生 Windows 驗收尚未完成。此 Mac 已驗證 Claude Code、Codex 與 agy 的隔離設定讀取；尚未驗證真實模型對話、所有學校或原生 Windows。
vstudy-mcp doctor --client codex
vstudy-mcp reset --client codex --dry-run
vstudy-mcp uninstall --client codex --dry-run