M MCP모아
튜토리얼

고려대 포털 MCP 서버 설치·사용법 — 고려대학교 KUPID 포털·Canvas LM

ku-portal-mcp MCP 서버를 Claude Desktop·Cursor에 설치해 고려대 KUPID 포털, Canvas LMS, 도서관 좌석예약을 자연어로 조회하는 방법을 단계별로 안내합니다.

고려대학교 KUPID 포털과 Canvas LMS 데이터를 MCP 서버를 통해 Claude AI가 자연어로 조회하는 데이터 흐름 다이어그램

TL;DR: ku-portal-mcp를 설치하면 고려대학교 KUPID 포털, Canvas LMS, 도서관 좌석예약 시스템을 Claude 대화창에서 자연어로 조회할 수 있습니다. API 키 없이 uvx ku-portal-mcp@latest 한 줄과 설정 파일 수정만으로 연결이 완료됩니다. 이 가이드는 설치부터 실제 사용 예시, 흔한 오류 해결까지 단계별로 안내합니다.

왜 고려대 포털 MCP가 필요한가

매 학기 수강신청 기간마다 KUPID 포털을 여러 탭으로 열어두고, Canvas LMS에서 과제 마감일을 복사해 캘린더에 붙여넣고, 도서관 좌석예약 페이지를 새로고침하는 작업을 반복해 본 경험이 있으실 겁니다. 각 시스템이 분리돼 있어 정보를 한눈에 파악하기 어렵고, 매번 로그인·탐색·복사라는 단순 반복 작업이 시간을 잡아먹습니다.

MCP(Model Context Protocol)는 AI 클라이언트(Claude, Cursor 등)와 외부 데이터 소스를 표준 방식으로 연결하는 프로토콜입니다. ku-portal-mcp는 이 프로토콜을 이용해 고려대학교 포털 생태계 — KUPID, Canvas LMS, 도서관 좌석예약, InfoDepot 강좌 카탈로그 — 를 Claude에 연결합니다. 설치 후에는 “이번 주 Canvas 과제 마감일 정리해줘” 한 문장으로 결과를 받을 수 있습니다.

사용자 (Claude 대화창)
        │
        ▼
Claude Desktop / Claude Code (MCP 클라이언트)
        │
        ▼
ku-portal-mcp 서버 (uvx 실행)
        │
        ├─► KUPID (kupid.korea.ac.kr)       — 수강신청·학사 정보
        ├─► Canvas LMS (mylms.korea.ac.kr)  — 강좌·과제·공지
        ├─► 도서관 좌석예약 (librsv.korea.ac.kr)
        └─► InfoDepot                        — 강좌 카탈로그
        │
        ▼
Claude — 자연어 요약·정리·분석 제공

서버 개요

항목내용
서버 이름고려대 포털 MCP 서버
GitHubgithub.com/SonAIengine/ku-portal-mcp
설치 방식uvx (Python 기반)
실행 명령uvx ku-portal-mcp@latest
API 키 필요 여부없음
지원 시스템KUPID, Canvas LMS, 고려대 도서관 좌석예약, InfoDepot

준비물

  • Claude Desktop 최신 버전 또는 Cursor (MCP를 지원하는 AI 클라이언트)
  • Python 3.8 이상 및 uv 패키지 매니저
  • 고려대학교 포털 구성원 계정 (KUPID·Canvas 로그인용)
  • 텍스트 편집기 (설정 파일 수정용)

uv 설치 방법

uv가 없다면 아래 명령으로 설치합니다.

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# pip으로도 설치 가능
pip install uv

설치 후 터미널을 재시작하고 uv --version으로 정상 설치를 확인하세요.

단계별 설치 및 설정

1단계: uv 설치 확인

uv --version

버전 번호가 출력되면 준비 완료입니다. 출력되지 않으면 위의 설치 명령을 실행한 뒤 터미널을 재시작하세요.

2단계: uvx로 서버 동작 테스트

Claude Desktop 설정 전에 서버가 정상 실행되는지 먼저 확인합니다.

uvx ku-portal-mcp@latest

오류 없이 서버가 시작되면 Ctrl+C로 종료합니다. 패키지 다운로드 메시지가 나타나는 것은 정상입니다.

3단계: Claude Desktop 설정 파일 수정

Claude Desktop의 MCP 설정 파일 위치는 운영체제에 따라 다릅니다.

운영체제설정 파일 경로
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json

파일을 텍스트 편집기로 열고 mcpServers 항목에 아래 블록을 추가합니다.

{
  "mcpServers": {
    "ku-portal-mcp": {
      "command": "uvx",
      "args": ["ku-portal-mcp@latest"]
    }
  }
}

이미 다른 MCP 서버가 등록돼 있다면 mcpServers 객체 안에 쉼표로 구분해 추가하면 됩니다.

{
  "mcpServers": {
    "기존-서버": {
      "command": "...",
      "args": ["..."]
    },
    "ku-portal-mcp": {
      "command": "uvx",
      "args": ["ku-portal-mcp@latest"]
    }
  }
}

설정 파일을 저장합니다.

4단계: Claude Desktop 재시작

Claude Desktop을 완전히 종료(트레이 아이콘까지 종료)한 뒤 다시 실행합니다. 새 대화를 열고 입력창 옆의 도구 아이콘(망치 모양)을 클릭했을 때 ku-portal-mcp 관련 도구 목록이 보이면 연결이 완료된 것입니다.

5단계: 자연어 질의로 포털 조회

연결 확인 후 바로 사용해 볼 수 있습니다. 아래 예시 프롬프트를 참고하세요.

Canvas LMS 과제 조회:

이번 주 Canvas에 마감되는 과제 목록을 정리해줘. 과목명, 마감일, 제출 여부를 표로 보여줘.

KUPID 수강신청 일정 확인:

이번 학기 수강신청 일정과 현재 내 수강 과목 목록을 KUPID에서 가져와줘.

도서관 좌석 현황 조회:

지금 고려대 도서관에서 이용 가능한 좌석이 몇 개인지 알려줘.

InfoDepot 강좌 탐색:

InfoDepot에서 데이터 분석 관련 강좌를 찾아서 목록으로 정리해줘.

Claude Code(CLI)에서 사용하기

Claude Code를 사용하는 경우 프로젝트 루트에 .mcp.json 파일을 만들거나 기존 파일에 아래 내용을 추가합니다.

{
  "mcpServers": {
    "ku-portal-mcp": {
      "command": "uvx",
      "args": ["ku-portal-mcp@latest"]
    }
  }
}

Claude Code에서는 claude mcp list 명령으로 등록된 MCP 서버 목록을 확인할 수 있습니다.

흔한 오류와 해결 방법

uvx 명령을 찾을 수 없음

command not found: uvx

uv가 설치되지 않았거나 PATH에 등록되지 않은 상태입니다. 설치 후 터미널을 재시작하세요. macOS에서는 ~/.local/bin이 PATH에 포함돼 있는지 확인합니다.

MCP 서버가 도구 목록에 나타나지 않음

  1. JSON 문법 오류 여부를 확인합니다. 쉼표 하나가 빠지거나 따옴표가 맞지 않아도 전체 설정이 로드되지 않습니다.
  2. 터미널에서 uvx ku-portal-mcp@latest를 직접 실행해 패키지 설치 오류가 없는지 확인합니다.
  3. Claude Desktop을 트레이까지 완전히 종료한 뒤 재시작합니다.

포털 로그인·인증 오류

KUPID·Canvas LMS는 고려대학교 구성원 계정으로 인증이 필요합니다. 서버가 인증을 어떻게 처리하는지는 공식 GitHub 저장소의 README에서 확인하세요. 환경변수로 자격증명을 전달하는 방식이라면 설정 파일의 env 항목에 추가합니다.

패키지 버전 충돌

uvx ku-portal-mcp@latest --force-reinstall

@latest를 명시했는데도 이전 버전이 캐시됐다면 위 명령으로 강제 재설치할 수 있습니다.

다른 공공데이터 MCP 서버와 함께 쓰기

ku-portal-mcp는 대학 포털에 특화돼 있지만, 실생활에서는 다른 공공데이터 MCP 서버와 조합하면 더욱 강력합니다.

서버용도링크
공공데이터포털 MCP 서버 모음국민연금·국세청·조달청 등 data.go.kr API 전반GitHub
한국 부동산 MCP국토교통부 실거래가·청약 정보GitHub

예를 들어 졸업 후 취업·이사를 계획 중인 학생이라면, Canvas LMS에서 졸업 요건을 조회하는 동시에 부동산 MCP로 직주근접 매물 실거래가를 Claude에서 한 번에 비교할 수 있습니다.

더 많은 공공데이터 MCP 서버는 공공데이터 카테고리 페이지에서 찾아보세요.

자주 묻는 질문

ku-portal-mcp를 사용하려면 API 키가 필요한가요?

아니요. ku-portal-mcp는 별도 API 키 발급 없이 사용할 수 있습니다. 다만 KUPID·Canvas LMS 조회는 고려대학교 구성원 계정(포털 로그인)이 필요할 수 있으므로, 설치 전 서버 GitHub README를 먼저 확인하세요.

npx 대신 uvx를 쓰는 이유가 무엇인가요?

ku-portal-mcp는 Python 기반 서버입니다. uvx는 uv 패키지 매니저의 실행 도구로, npx가 Node.js 패키지를 별도 설치 없이 실행하듯 PyPI 패키지를 가상환경 없이 바로 실행합니다. 파이썬 환경 설정 부담이 크게 줄어드는 장점이 있습니다.

Claude Code(CLI)에서도 사용할 수 있나요?

네. Claude Code는 프로젝트 루트의 .mcp.json 파일에 동일한 JSON 블록을 추가하면 됩니다. Claude Desktop과 설정 구조가 같습니다.

Canvas LMS에서 가져올 수 있는 정보는 어떤 것이 있나요?

ku-portal-mcp가 지원하는 Canvas 기능의 최신 목록은 GitHub 저장소 README에서 확인하세요. 일반적으로 강좌 목록, 과제 제출 현황, 공지사항 조회 등이 포함됩니다.

도서관 좌석예약(librsv.korea.ac.kr)도 MCP로 조회할 수 있나요?

네. 고려대 도서관 좌석예약 시스템이 지원 대상에 포함돼 있습니다. 잔여 좌석 조회 등 구체적인 기능은 서버 README를 참조하세요.

MCP 서버가 도구 목록에 나타나지 않으면 어떻게 하나요?

JSON 설정 파일의 문법 오류(쉼표 누락, 따옴표 불일치 등)를 먼저 점검하세요. 이후 터미널에서 uvx ku-portal-mcp@latest를 직접 실행해 패키지 설치 오류가 없는지 확인하고, Claude Desktop을 완전히 재시작합니다.

다음 단계

ku-portal-mcp 설치가 완료됐다면 KUPID·Canvas·도서관 좌석예약을 Claude에서 바로 조회해 보세요. 학사 일정 정리, 과제 마감일 모아보기, 도서관 좌석 확인이 대화 한 번으로 가능해집니다.

더 많은 MCP 서버와 활용 가이드는 가이드 목록에서 확인하실 수 있습니다. 새로운 국내 MCP 서버를 발견했다면 서버 등록도 환영합니다. 공공데이터 카테고리에서 다양한 한국 공공데이터 연동 서버를 탐색해 보세요.

이 글과 관련된 MCP 서버