Brightspace MCP로 성적과 강의 내용을 필요할 때 보기

누구에게 맞나

이미 학교 D2L Brightspace 계정이 있고, 학습 플랫폼 웹을 반복해 열기보다 MCP를 지원하는 대화 환경에서 성적, 과제, 강의계획서, 강의 내용을 필요할 때 보고 싶다면 이 서비스가 맞다. 공식 문서는 AI를 Brightspace에 연결해 그 강의 정보를 필요할 때 가져온다고 설명한다.

학교 측은 어떤 학교든 쓸 수 있다고 쓰지만 학교 목록, 예외 명단, 어떤 학부 기능이 꺼지는지는 없다. 학교 로그인 페이지가 열리는지, 계정이 강의에 들어갈 수 있는지를 스스로 확인해야 한다.

공식이 이름을 든 것은 Claude Desktop, Claude Code, Cursor, ChatGPT Desktop, Windsurf다. 환경이 그 명단에 없으면 원문은 다른 접속 절차를 주지 않는다. 클라이언트 설정을 스스로 보태지 마라.

Brightspace에서 과제를 제출하거나 글을 올리거나 플랫폼 데이터를 바꿔야 하는 사람에게는 맞지 않다. 공식 문서는 읽기 전용 서비스라고 적는다. 제출, 게시, 내용 변경을 하지 않는다.

3분 안에 첫 시도 끝내기

전제: 이 기기에 npx를 실행할 환경이 있고, 자기 학교의 실제 Brightspace 로그인 페이지를 열 수 있다. 사용자 이름과 비밀번호는 학교 로그인 페이지에만 넣고 다른 곳에는 넣지 않는다. 완료 후 이 기기의 ~/.brightspace-mcp/config.json에 저장되며 현재 사용자만 읽을 수 있다(mode 0600).

공식 설치 경로는 이 한 가지만 간다. 터미널에서 실행한다:

npx brightspace-mcp-server setup

설정 위치는 이 setup 명령이 쓰는 이 기기 파일 ~/.brightspace-mcp/config.json다. 첫 시도에서는 이 공식 명령을 그대로 실행한다. 쓰지 않은 설치기로 바꾸지 말고, 쓰지 않은 도구 이름을 만들어 성적을 시험 읽지 마라.

성공 신호: setup이 정상 종료되고 이 기기에 ~/.brightspace-mcp/config.json가 나타나며 권한이 현재 사용자 읽기 가능이다. 이후 서비스는 공식 설명대로 읽기 전용을 유지하며 Brightspace의 어떤 내용도 대신 제출하거나 바꾸지 않는다.

사용 사례

사례 1: 필요할 때 성적을 본다. 공식 능력은 Brightspace에 연결한 뒤 필요할 때 성적을 가져오는 것이다. 보이는 설명은 「성적 가져오기」까지이며 도구 이름, 매개변수, 반환 필드가 없다. 확인할 수 있는 것은 이것이 읽기 전용 읽기라는 점이다. 성공 시 성적 관련 정보가 보여야 하고 플랫폼에서 제출하거나 바꾸지 않는다. 현재 클라이언트에 성적 관련 호출이 없으면 적힌 능력 경계에서 멈춘다.

사례 2: 필요할 때 과제, 강의계획서, 강의 내용을 본다. 공식 같은 문장이 과제, 강의계획서, 강의 내용을 필요할 때 가져올 정보로 나열한다. 역시 도구 이름, 필터 조건, 출력 샘플이 없다. 질문은 이런 읽기 전용 자료 안으로 제한한다. 성공 시 해당 강의 정보를 읽을 수 있다. 실패 시 공식이 더 가는 호출 형식을 아직 주지 않았다고만 말할 수 있다. 매개변수를 스스로 보태지 마라.

사용 경계

이것은 읽기 전용 서비스이며 Brightspace에서 제출, 게시, 내용 변경을 하지 않는다. 읽기 전용은 위험이 없다는 뜻이 아니다. 이 기기는 여전히 학교 계정을 저장하고 클라이언트는 네트워크로 강의 데이터를 읽는다.

자격 증명은 이 기기의 ~/.brightspace-mcp/config.json에만 남고 권한은 0600이다. 로그인 정보는 학교의 실제 로그인 페이지에만 넣는다. 공식 문서는 해당 파일을 삭제한 뒤의 실행 취소 단계도, 구체 도구 이름과 매개변수도 쓰지 않는다. setup 외에 두 번째 설치 명령을 만들지 마라.