공공데이터포털 MCP 서버 설치 — data.go.kr를 Claude에 연결하기

Q: 공공데이터포털 MCP 서버를 Claude Code(CLI)에서도 쓸 수 있나요?

네, 가능합니다. Claude Code는 프로젝트 루트의 .claude/settings.json에 mcpServers 설정을 추가하거나, 사용자 홈의 ~/.claude/settings.json에 전역 설정으로 추가하면 됩니다. 설정 형식은 Claude Desktop과 동일합니다.

Q: uvx로 설치할 때 오류가 발생하면 어떻게 하나요?

먼저 uv 버전을 확인하세요(uv --version). 0.4 이상이어야 합니다. 이전 버전이라면 curl -LsSf https://astral.sh/uv/install.sh | sh 명령으로 최신 버전으로 업데이트한 뒤 다시 시도하세요. Python 가상환경 충돌이 의심되면 --no-cache 옵션을 추가해 보세요.

Q: Windows에서도 동일하게 설정하면 되나요?

Claude Desktop 설정 파일 경로가 다릅니다. Windows에서는 %APPDATA%\Claude\claude_desktop_config.json 파일을 수정하세요. 명령어 형식은 동일하지만, 경로 구분자를 백슬래시로 바꿔야 할 수 있습니다.

공공데이터포털 MCP 서버를 설치하면 Claude가 data.go.kr의 공공 API를 직접 호출해 부동산 실거래가 조회, 사업자 정보 확인, 나라장터 입찰 현황 파악 등을 대화 흐름 안에서 처리할 수 있습니다. API 키 발급부터 Claude Desktop 설정까지 10~15분이면 충분하며, 설치 후에는 “최근 강남구 아파트 실거래가 알려줘”처럼 자연어로 공공데이터를 활용할 수 있습니다. 이 가이드에서는 대표적인 두 서버인 한국 부동산 MCP와 공공데이터포털 MCP 서버 모음을 중심으로 단계별 설치 방법을 설명합니다.

왜 공공데이터포털을 MCP로 연결해야 하나요?

data.go.kr에는 6만 건이 넘는 공공데이터셋이 공개되어 있습니다. 문제는 각 API마다 문서를 찾고, 키를 발급받고, 코드를 직접 작성해야 한다는 점입니다. MCP(Model Context Protocol)를 사용하면 이 과정을 Claude가 대신 처리합니다.

아래 흐름을 보면 구조가 명확합니다.

사용자(대화) → Claude Desktop → MCP 서버 → data.go.kr API → 결과 반환

Claude가 MCP 서버를 통해 API 요청을 구성하고, 응답을 파싱해 자연어로 요약해 줍니다. 별도의 파이썬 스크립트를 작성하거나 Jupyter 노트북을 열 필요가 없습니다.

현재 한국에서 활용 가능한 공공데이터 MCP 서버

공공데이터 카테고리에는 현재 아래 서버들이 등록되어 있습니다.

서버 이름	연결 API	설치 방식	API 키 필요
한국 부동산 MCP	국토교통부 실거래가, 청약홈, 온비드	stdio (Git 클론)	필요
공공데이터포털 MCP 서버 모음	국민연금, 국세청, 나라장터, 금감원 등	uvx	필요
표준국어대사전 MCP	국립국어원 표준국어대사전	stdio (로컬 SQLite)	불필요

준비물

설치를 시작하기 전에 아래 항목을 확인하세요.

항목	최소 요구 사항	확인 명령어
Claude Desktop	최신 버전	앱 메뉴 > About Claude
Python	3.10 이상	`python3 --version`
uv	0.4 이상	`uv --version`
data.go.kr 계정	활용 신청 완료	data.go.kr 마이페이지

uv가 설치되어 있지 않다면 아래 명령으로 설치합니다.

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

설치 후에는 터미널을 새로 열거나 source ~/.bashrc(또는 ~/.zshrc)를 실행해 PATH를 갱신하세요.

단계별 설치 방법

1단계: data.go.kr API 키 발급

data.go.kr에 접속해 회원가입 또는 로그인합니다.
원하는 API 상세 페이지에서 활용 신청 버튼을 클릭합니다.
- 부동산 실거래가 API: 국토교통부 실거래가 API
- 그 외 API: data.go.kr 통합 검색에서 검색
활용 목적을 간단히 기재하면 자동 승인 또는 2~3 영업일 내 승인됩니다.
승인 후 마이페이지 > 개발 계정 > 일반 인증키에서 서비스 키를 복사합니다.

서비스 키는 인코딩(URL-encoded) 형태와 디코딩 형태 두 가지로 제공됩니다. MCP 설정에서는 디코딩된 키를 사용하세요.

2단계: 원하는 MCP 서버 선택

사용 목적에 따라 두 가지 서버 중 하나를 선택하세요.

옵션 A — 공공데이터포털 MCP 서버 모음 (uvx, 권장)

공공데이터포털 MCP 서버 모음은 uvx로 바로 실행할 수 있어 별도의 환경 설정이 필요 없습니다. 국민연금공단 사업장 가입 API, 국세청 사업자등록 진위 확인 API, 조달청 나라장터 API, 금융감독원 기업재무정보 API 등 여러 서버가 포함되어 있습니다.

아래 명령으로 실행 가능 여부를 먼저 확인하세요.

uvx data-go-mcp.nps-business-enrollment@latest --help

옵션 B — 한국 부동산 MCP (Git 클론)

부동산 실거래가에 집중하려면 한국 부동산 MCP를 사용하세요. GitHub에서 클론 후 로컬에서 실행합니다.

git clone https://github.com/tae0y/real-estate-mcp.git
cd real-estate-mcp
uv sync

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

Claude Desktop의 설정 파일을 텍스트 편집기로 엽니다.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

옵션 A (공공데이터포털 MCP 서버 모음) 설정

{
  "mcpServers": {
    "data-go-nps": {
      "command": "uvx",
      "args": ["data-go-mcp.nps-business-enrollment@latest"],
      "env": {
        "DATA_GO_KR_API_KEY": "여기에_발급받은_서비스_키_입력"
      }
    }
  }
}

옵션 B (한국 부동산 MCP) 설정

클론한 경로를 실제 절대 경로로 바꿔 입력하세요.

{
  "mcpServers": {
    "real-estate-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/사용자이름/real-estate-mcp",
        "run",
        "real-estate-mcp"
      ],
      "env": {
        "DATA_GO_KR_API_KEY": "여기에_발급받은_서비스_키_입력"
      }
    }
  }
}

기존에 다른 MCP 서버가 설정되어 있다면 mcpServers 객체 안에 항목을 추가하면 됩니다. 파일 전체를 덮어쓰지 않도록 주의하세요.

4단계: Claude Desktop 재시작 및 연결 확인

Claude Desktop을 완전히 종료합니다(macOS는 메뉴바 아이콘까지 확인).
다시 실행합니다.
새 대화를 열고 아래 메시지를 입력해 연결을 확인합니다.

사용 가능한 공공데이터 도구 목록을 알려줘.

연결이 성공했다면 Claude가 등록된 MCP 도구 목록을 나열합니다. 한국 부동산 MCP가 연결됐다면 “강남구 아파트 최근 3개월 실거래가를 표로 보여줘”처럼 바로 활용할 수 있습니다.

흔한 오류와 해결 방법

오류 메시지	원인	해결 방법
`spawn uvx ENOENT`	uv 미설치 또는 PATH 미등록	uv 재설치 후 터미널 재시작
`API key not found`	환경 변수 오타 또는 누락	설정 파일의 `env` 키 이름 확인
`403 Forbidden`	API 키 미승인 또는 만료	data.go.kr 마이페이지에서 승인 상태 확인
`Connection timeout`	공공데이터 서버 응답 지연	잠시 후 재시도. data.go.kr 공지사항 확인
MCP 서버 목록에 미노출	설정 파일 JSON 문법 오류	JSON 유효성 검사 후 재시작

JSON 유효성 검사는 아래 명령으로 간단히 확인할 수 있습니다.

# macOS 기준
python3 -m json.tool ~/Library/Application\ Support/Claude/claude_desktop_config.json

오류가 없으면 포맷된 JSON이 출력됩니다. 오류가 있으면 문법 문제가 있는 줄 번호가 표시됩니다.

데이터 흐름 한눈에 보기

공공데이터포털 MCP 서버의 전체 흐름은 다음과 같습니다.

[사용자 입력]
    "강남구 최근 아파트 실거래가 조회해줘"
          |
          v
[Claude Desktop]
    의도 분석 → MCP 도구 선택
          |
          v
[MCP 서버 (로컬 실행)]
    API 파라미터 구성 → HTTP 요청
          |
          v
[data.go.kr REST API]
    국토교통부 실거래가 공공데이터 반환
          |
          v
[Claude Desktop]
    JSON 파싱 → 자연어 요약 → 사용자에게 출력

이 구조에서 MCP 서버는 Claude와 공공 API 사이의 번역기 역할을 합니다. Claude는 자연어 의도를 MCP 프로토콜 호출로 변환하고, MCP 서버는 이를 실제 API 요청으로 바꿉니다. 사용자 입장에서는 API 문서를 볼 필요 없이 대화만으로 공공데이터를 활용할 수 있습니다.

자주 묻는 질문

data.go.kr API 키는 어디서 발급받나요?

data.go.kr에 회원가입한 뒤, 활용하려는 데이터 API 상세 페이지에서 ‘활용 신청’ 버튼을 클릭하면 됩니다. 자동 승인 API는 즉시 키가 발급되고, 심사 필요 API는 2~3 영업일이 소요됩니다. 발급된 키는 마이페이지 > 개발 계정에서 확인할 수 있습니다.

공공데이터포털 MCP 서버를 Claude Code(CLI)에서도 쓸 수 있나요?

네, 가능합니다. Claude Code는 프로젝트 루트의 .claude/settings.json에 mcpServers 설정을 추가하거나, 사용자 홈의 ~/.claude/settings.json에 전역 설정으로 추가하면 됩니다. 설정 형식은 Claude Desktop과 동일합니다.

API 호출 횟수 제한이 있나요?

data.go.kr의 대부분 API는 일 1,000~10,000건의 기본 호출 한도를 제공합니다. 활용 신청 시 기재한 예상 호출량을 초과할 경우 추가 신청이 필요합니다. 구체적인 한도는 각 API 상세 페이지의 ‘상세 정보’ 탭에서 확인하세요.

uvx로 설치할 때 오류가 발생하면 어떻게 하나요?

먼저 uv 버전을 확인하세요(uv --version). 0.4 이상이어야 합니다. 이전 버전이라면 설치 스크립트로 최신 버전으로 업데이트한 뒤 다시 시도하세요. Python 가상환경 충돌이 의심되면 --no-cache 옵션을 추가해 보세요.

어떤 공공데이터 API를 MCP로 쓸 수 있나요?

현재 MCP로 활용 가능한 한국 공공데이터는 국토교통부 실거래가, 국민연금공단 사업장 가입 정보, 국세청 사업자등록 진위 확인, 조달청 나라장터, 금융감독원 기업재무정보 등 다양합니다. 지원 API 목록은 각 서버의 GitHub 저장소에서 확인하세요.

Windows에서도 동일하게 설정하면 되나요?

Claude Desktop 설정 파일 경로가 다릅니다. Windows에서는 %APPDATA%\Claude\claude_desktop_config.json 파일을 수정하세요. 명령어 형식은 동일하지만, 경로 구분자를 백슬래시로 바꿔야 할 수 있습니다.

다음 단계

공공데이터포털 MCP 서버 설치가 완료됐다면, 이제 Claude와의 대화 속에서 한국 공공데이터를 자유롭게 활용할 수 있습니다. 더 많은 서버를 탐색하고 싶다면 전체 서버 목록을 확인하거나, 공공데이터 카테고리에서 관련 서버를 더 찾아보세요.

직접 개발한 공공데이터 MCP 서버가 있다면 서버 등록을 통해 한국 MCP 커뮤니티와 공유해 주세요.