공공데이터 MCP Claude Desktop 설정법 — 한국 공공 API 연결 단계별 안내

Q: claude_desktop_config.json 파일은 어디에 있나요?

macOS는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows는 %APPDATA%/Claude/claude_desktop_config.json 경로에 있습니다. 파일이 없으면 직접 생성하면 됩니다.

Q: Cursor에서도 같은 MCP 서버를 쓸 수 있나요?

네. Cursor는 프로젝트 루트의 .cursor/mcp.json 또는 전역 설정에 mcpServers 항목을 추가하면 Claude Desktop과 동일한 MCP 서버를 사용할 수 있습니다.

Q: API 키를 설정 파일에 직접 쓰는 것이 안전한가요?

claude_desktop_config.json은 로컬 파일이므로 개인 PC라면 큰 문제는 없습니다. 그러나 Git에 올리지 않도록 주의하세요. 팀 공유 환경에서는 환경변수(.env)로 분리하는 것을 권장합니다.

Claude Desktop에서 한국 공공데이터 MCP 서버를 연결하면, 채팅창 한 줄로 부동산 실거래가·국민연금 사업장 정보·국세청 사업자등록 진위 여부를 조회할 수 있습니다. 핵심은 claude_desktop_config.json 파일에 mcpServers 항목을 추가하는 것뿐입니다. 이 가이드는 API 키 발급부터 설정 파일 편집, 오류 해결까지 단계별로 안내합니다.

왜 공공데이터 MCP가 필요한가

한국 공공데이터포털(data.go.kr)에는 1만 개가 넘는 API가 있지만, 매번 직접 호출하려면 API 문서를 찾고, 인증 헤더를 구성하고, JSON 응답을 파싱해야 합니다. MCP(Model Context Protocol)는 이 과정을 도구(tool)로 추상화해, Claude가 대화 흐름 속에서 자동으로 API를 호출하고 결과를 해석할 수 있게 해 줍니다.

실제 활용 예시를 보면 차이가 명확합니다.

방식	작업 흐름
기존 방식	API 문서 확인 → curl 작성 → 응답 파싱 → Claude에 복붙 → 해석 요청
MCP 방식	Claude에게 “판교 아파트 최근 실거래가 알려줘” → 자동 조회 + 해석

데이터 흐름을 도식으로 보면 아래와 같습니다.

[사용자 채팅] → [Claude Desktop] → [MCP 서버] → [공공데이터 API (data.go.kr)]
                                        ↑
                              (stdio 또는 uvx 프로세스)

준비물

Claude Desktop 최신 버전 (claude.ai/download)
공공데이터포털 계정 및 API 인증키 (data.go.kr)
Git (stdio 방식 서버 클론 시)
uv (uvx 방식 서버 사용 시 — Python 패키지 관리자)
터미널(macOS: 기본 Terminal, Windows: PowerShell)

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

공공데이터포털에서 사용할 API를 먼저 신청해야 합니다.

data.go.kr에 접속해 회원가입 또는 로그인합니다.
검색창에 원하는 데이터명(예: “아파트 실거래가”)을 입력하고 해당 API 서비스 페이지로 이동합니다.
활용신청 버튼을 클릭하고 활용 목적을 간단히 기재하면 인증키가 발급됩니다.
마이페이지 → API 인증키 관리에서 발급된 **서비스키(Encoding/Decoding 중 Decoding 키 권장)**를 복사해 둡니다.

일반 오픈 API는 즉시 발급되지만, 일부 기관 API는 1~2 영업일이 소요될 수 있습니다.

2단계: MCP 서버 설치

연결하려는 서버 종류에 따라 설치 방식이 다릅니다. 아래 표에서 원하는 서버를 확인하세요.

서버	설치 방식	주요 API
한국 부동산 MCP	stdio (git clone)	국토교통부 실거래가, 한국부동산원 청약홈
공공데이터포털 MCP 서버 모음	uvx	국민연금, 국세청, 조달청, 금감원 등
표준국어대사전 MCP	stdio (git clone)	국립국어원 사전 (API 키 불필요)

stdio 방식 (git clone)

한국 부동산 MCP 또는 표준국어대사전 MCP처럼 직접 클론이 필요한 서버는 아래와 같이 설치합니다.

# 한국 부동산 MCP 예시
git clone https://github.com/tae0y/real-estate-mcp
cd real-estate-mcp
# 의존성 설치 (서버별 README 참고)

# 표준국어대사전 MCP 예시
git clone https://github.com/dahlia/ko-stdict-mcp
cd ko-stdict-mcp

각 저장소의 README에 의존성 설치 명령이 안내되어 있으니 반드시 확인하세요.

uvx 방식 (공공데이터포털 MCP 서버 모음)

uv가 설치되어 있다면 별도 클론 없이 아래 명령 하나로 실행할 수 있습니다.

# uv 설치 (이미 있으면 생략)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 국민연금 사업장 가입 API 서버 실행 예시
uvx data-go-mcp.nps-business-enrollment@latest

3단계: claude_desktop_config.json 편집

Claude Desktop 설정 파일 경로는 운영체제마다 다릅니다.

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

파일이 없으면 새로 생성하면 됩니다. 아래는 세 서버를 모두 추가한 예시입니다. 본인 환경에 맞게 필요한 항목만 남겨 사용하세요.

{
  "mcpServers": {
    "real-estate-mcp": {
      "command": "python",
      "args": ["/절대경로/real-estate-mcp/server.py"],
      "env": {
        "DATA_GO_KR_API_KEY": "여기에_발급받은_인증키_입력"
      }
    },
    "data-go-mcp-nps": {
      "command": "uvx",
      "args": ["data-go-mcp.nps-business-enrollment@latest"],
      "env": {
        "DATA_GO_KR_API_KEY": "여기에_발급받은_인증키_입력"
      }
    },
    "ko-stdict-mcp": {
      "command": "python",
      "args": ["/절대경로/ko-stdict-mcp/server.py"]
    }
  }
}

주의 사항:

/절대경로/ 부분은 실제 클론한 디렉터리의 절대 경로로 교체하세요.
command에 들어갈 실행 파일명(python, python3, node 등)은 각 서버의 README를 확인하세요.
JSON 문법 오류(쉼표 누락, 따옴표 불일치)가 가장 흔한 실수입니다. 저장 전에 JSON 검사기로 확인하는 것을 권장합니다.

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

설정 파일을 저장한 뒤, Claude Desktop을 완전히 종료했다가 다시 실행해야 새 설정이 적용됩니다.

macOS: 메뉴바 또는 독(Dock)에서 우클릭 → Quit
Windows: 시스템 트레이 아이콘 우클릭 → 종료

재시작 후 채팅창 하단에 망치(도구) 아이콘이 나타나면 MCP 서버가 정상적으로 연결된 것입니다. 아이콘을 클릭하면 사용 가능한 도구 목록을 확인할 수 있습니다.

테스트 질문 예시:

판교 아파트 2024년 실거래가 최근 5건 알려줘.
사업자등록번호 123-45-67890의 등록 여부 확인해 줘.
"경우"의 표준국어대사전 뜻을 찾아줘.

5단계: Cursor에 MCP 서버 추가 (선택)

Cursor IDE를 사용한다면 동일한 MCP 서버를 Cursor에도 연결할 수 있습니다. 프로젝트 루트에 .cursor/mcp.json 파일을 생성하고 아래와 같이 작성하세요.

{
  "mcpServers": {
    "real-estate-mcp": {
      "command": "python",
      "args": ["/절대경로/real-estate-mcp/server.py"],
      "env": {
        "DATA_GO_KR_API_KEY": "여기에_발급받은_인증키_입력"
      }
    }
  }
}

Cursor → Settings → MCP 탭에서 서버가 Active 상태인지 확인하세요.

흔한 오류와 해결 방법

증상	원인	해결책
도구 아이콘이 나타나지 않음	설정 파일 JSON 오류 또는 경로 문제	JSON 검사기로 문법 확인 후 재시작
”API 인증 실패” 오류	잘못된 인증키 또는 Decoding 키 미사용	data.go.kr 마이페이지에서 Decoding 키 재확인
”command not found”	python/uvx가 PATH에 없음	절대 경로 사용: `/usr/bin/python3` 또는 `which uvx` 결과값
API 응답은 오지만 결과가 비어 있음	API 활용 신청이 미완료 상태	data.go.kr에서 해당 API의 활용 신청 승인 여부 확인
uvx 명령어를 찾을 수 없음	uv 미설치	`curl -LsSf https://astral.sh/uv/install.sh

자주 묻는 질문

claude_desktop_config.json 파일은 어디에 있나요?

macOS는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows는 %APPDATA%/Claude/claude_desktop_config.json 경로에 있습니다. 파일이 없으면 직접 생성하면 됩니다.

공공데이터 API 키는 어디서 발급받나요?

공공데이터포털(data.go.kr)에 회원가입한 뒤 원하는 API 서비스 페이지에서 ‘활용신청’을 클릭하면 발급됩니다. 일반적으로 즉시 발급되지만 일부 API는 1~2일 심사가 필요합니다.

MCP 서버가 Claude Desktop에 나타나지 않으면 어떻게 하나요?

Claude Desktop을 완전히 종료(트레이 아이콘 우클릭 → Quit)한 뒤 재시작하세요. 그래도 안 된다면 설정 파일의 JSON 문법 오류를 확인하거나, 서버 실행 경로가 올바른지 점검하세요.

Cursor에서도 같은 MCP 서버를 쓸 수 있나요?

네. Cursor는 프로젝트 루트의 .cursor/mcp.json 또는 전역 설정에 mcpServers 항목을 추가하면 Claude Desktop과 동일한 MCP 서버를 사용할 수 있습니다.

stdio 방식과 uvx 방식은 무엇이 다른가요?

stdio 방식은 GitHub 저장소를 직접 클론해 로컬에서 실행하는 방식이고, uvx 방식은 Python 패키지 관리자(uv)로 설치·실행하는 방식입니다. uvx 방식이 설치가 간편하고 버전 관리가 편리합니다.

API 키를 설정 파일에 직접 쓰는 것이 안전한가요?

claude_desktop_config.json은 로컬 파일이므로 개인 PC라면 큰 문제는 없습니다. 그러나 Git에 올리지 않도록 주의하세요. 팀 공유 환경에서는 환경변수(.env)로 분리하는 것을 권장합니다.

다음 단계

설정이 완료됐다면 각 서버의 상세 사용법을 확인해 보세요.

한국 부동산 MCP — 아파트 실거래가, 청약, 온비드 경매 정보 조회
공공데이터포털 MCP 서버 모음 — 국민연금, 국세청, 금감원 등 다양한 공공 API 한번에 연결
표준국어대사전 MCP — 오프라인 로컬 사전 검색, API 키 불필요

더 많은 한국 공공데이터 MCP 서버가 궁금하다면 공공데이터 카테고리를 둘러보거나, 전체 MCP 서버 목록에서 용도에 맞는 서버를 찾아보세요. 새로운 공공데이터 MCP 서버를 발견했다면 MCP모아에 등록해 주세요.