공공데이터포털 API 키 MCP 설정법 — 발급부터 Claude Desktop 연결까지

Q: Claude Desktop 설정 파일은 어디에 있나요?

macOS는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows는 %APPDATA%\Claude\claude_desktop_config.json에 위치합니다. 파일이 없다면 직접 생성하면 됩니다.

Q: MCP 서버가 여러 API 키를 요구하면 어떻게 하나요?

claude_desktop_config.json의 env 블록에 각 키를 별도 환경 변수로 나열하면 됩니다. 예를 들어 DATA_GO_KR_KEY와 ANOTHER_API_KEY를 각각 추가하면 서버가 구분해 사용합니다.

공공데이터포털(data.go.kr)에서 API 키를 발급받아 MCP 설정 파일에 연결하면, Claude Desktop에서 바로 부동산 실거래가·사업자 정보·연금 현황 등 한국 공공 데이터를 조회할 수 있습니다. 이 글은 회원가입부터 Claude Desktop 재시작 테스트까지 전 과정을 단계별로 안내합니다. 5단계면 충분하며, API 키 승인은 대부분 즉시 처리됩니다.

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

한국 정부는 국토교통부·국세청·금융감독원·조달청 등 수백 개 기관의 데이터를 data.go.kr에 표준 오픈API로 공개하고 있습니다. 하지만 이 데이터를 활용하려면 개발자가 직접 HTTP 호출 코드를 작성해야 했습니다. MCP(Model Context Protocol)를 사용하면 이 과정이 완전히 달라집니다.

MCP 서버가 API 호출 로직을 대신 처리해 주기 때문에, Claude Desktop 채팅창에서 “강남구 아파트 최근 실거래가 알려줘”라고 입력하는 것만으로 국토교통부 공공데이터가 즉시 조회됩니다. 코드를 한 줄도 작성하지 않아도 됩니다.

사용자 질문
    │
    ▼
Claude Desktop (AI)
    │  MCP 프로토콜
    ▼
공공데이터 MCP 서버
    │  HTTP 요청 + API 키
    ▼
data.go.kr 오픈API
    │  JSON 응답
    ▼
Claude Desktop (결과 정리 후 답변)

준비물 확인

항목	설명
data.go.kr 계정	이메일로 무료 가입 가능
API 키 (인증키)	활용 신청 후 마이페이지에서 확인
Claude Desktop	Anthropic 공식 사이트에서 무료 다운로드
Python 3.10+ 또는 Node.js	MCP 서버 실행에 필요 (서버마다 다름)
uv (Python 패키지 관리자)	uvx 방식 서버에 필요 (`pip install uv`)

단계 1 — data.go.kr 회원가입 및 로그인

공공데이터포털에 접속해 우상단 회원가입 버튼을 클릭합니다. 개인·기업·기관 중 해당 유형을 선택하고 이메일 인증을 완료하면 됩니다. 이미 계정이 있다면 로그인만 하면 됩니다.

단계 2 — 원하는 API 활용 신청 및 키 발급

포털 상단 검색창에 원하는 데이터를 입력합니다(예: “아파트 실거래가”, “사업자등록 진위확인”).
검색 결과에서 오픈API 탭을 선택합니다.
원하는 API 카드를 클릭해 상세 페이지로 이동합니다.
상단의 활용신청 버튼을 클릭합니다.
활용 목적(간단히 “개인 학습 및 AI 연동”)을 입력하고 신청을 완료합니다.
마이페이지 → 오픈API → 개발계정 메뉴에서 발급된 일반 인증키를 복사합니다.

대부분의 API는 신청 즉시 자동 승인됩니다. 승인 전에는 키가 활성화되지 않으니, 이메일 확인 후 진행하세요.

단계 3 — 공공데이터 MCP 서버 선택

용도에 따라 적합한 서버가 다릅니다.

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

더 많은 공공데이터 MCP 서버는 공공데이터 카테고리에서 확인하실 수 있습니다.

옵션 A — uvx로 설치 (공공데이터포털 MCP 서버 모음)

uv가 설치되어 있다면 별도 클론 없이 바로 실행할 수 있습니다.

# uv 설치 (이미 있으면 생략)
pip install uv

# 설치 확인
uvx --version

옵션 B — git clone으로 설치 (한국 부동산 MCP)

git clone https://github.com/tae0y/real-estate-mcp
cd real-estate-mcp
pip install -r requirements.txt

단계 4 — Claude Desktop 설정 파일 편집

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

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

파일이 없으면 직접 생성합니다. 아래는 두 서버를 동시에 등록하는 예시입니다.

설정 예시 A — 공공데이터포털 MCP 서버 모음 (uvx)

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

설정 예시 B — 한국 부동산 MCP (git clone 후 Python 실행)

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

주의: 경로는 반드시 절대 경로로 입력하세요. ~/real-estate-mcp 같은 ~ 표기는 Claude Desktop에서 인식하지 못할 수 있습니다.

두 서버를 함께 등록하는 경우

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

단계 5 — Claude Desktop 재시작 및 연결 테스트

설정 파일 저장 후 Claude Desktop을 완전히 종료하고 다시 시작합니다. 채팅 입력창 옆에 MCP 도구 아이콘(플러그 모양)이 표시되면 연결 성공입니다.

다음과 같이 테스트해 보세요.

강남구 아파트 2024년 실거래가 평균을 알려줘

또는

사업자등록번호 123-45-67890의 진위 여부를 확인해 줘

정상 응답이 오면 설정이 완료된 것입니다.

흔한 오류와 해결 방법

오류 증상	원인	해결 방법
MCP 도구 아이콘이 보이지 않음	설정 파일 JSON 문법 오류	JSON 유효성 검사 도구로 확인 후 재시작
”API 키가 유효하지 않습니다”	인증키 미승인 또는 오타	마이페이지에서 키 재확인, 승인 메일 확인
uvx 명령을 찾을 수 없음	uv 미설치	`pip install uv` 후 터미널 재시작
Python 경로 오류	상대 경로 사용	절대 경로로 변경
호출 횟수 초과	API 트래픽 쿼터 소진	포털에서 트래픽 증량 신청

JSON 문법 빠른 확인법

설정 파일을 저장하기 전, 아래 사이트에 붙여넣어 문법을 검증하면 실수를 예방할 수 있습니다.

https://jsonlint.com

자주 묻는 질문

공공데이터포털 API 키는 무료인가요?

네, data.go.kr의 오픈API는 기본적으로 무료로 제공됩니다. 다만 일부 API는 하루 호출 횟수 제한(트래픽 쿼터)이 있으며, 대량 호출이 필요하면 활용 신청 시 수량을 늘려 요청할 수 있습니다.

API 키 승인까지 얼마나 걸리나요?

대부분의 API는 신청 후 즉시(자동 승인) 또는 1~2일 이내에 승인됩니다. 일부 기관 API는 담당자 검토 후 승인되므로 최대 5영업일이 소요될 수 있습니다.

Claude Desktop 설정 파일은 어디에 있나요?

macOS는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows는 %APPDATA%\Claude\claude_desktop_config.json에 위치합니다. 파일이 없다면 직접 생성하면 됩니다.

API 키를 설정 파일에 직접 넣어도 안전한가요?

로컬 환경에서만 사용하는 경우 큰 문제는 없지만, 해당 파일을 Git 등 외부에 올리지 않도록 주의하세요. 보안이 중요한 환경이라면 환경 변수로 분리해 참조하는 방식을 권장합니다.

MCP 서버가 여러 API 키를 요구하면 어떻게 하나요?

claude_desktop_config.json의 env 블록에 각 키를 별도 환경 변수로 나열하면 됩니다. 서버 문서에서 요구하는 환경 변수명을 확인한 뒤 각각 추가하면 됩니다.

공공데이터포털 MCP 서버는 어떤 서비스에서 사용할 수 있나요?

Claude Desktop뿐 아니라 MCP 프로토콜을 지원하는 Cursor, Continue 등 다양한 AI 개발 도구에서 동일한 설정 방식으로 사용할 수 있습니다.

다음 단계

API 키 설정이 완료되었다면, 이제 더 다양한 공공데이터 MCP 서버를 탐색해 보세요.

한국 부동산 MCP — 국토교통부 실거래가·청약홈·온비드 연동
공공데이터포털 MCP 서버 모음 — 국민연금·국세청·조달청·금감원 등 멀티 API
공공데이터 카테고리 전체 보기 — 더 많은 한국 공공 API MCP 서버 목록
전체 MCP 서버 디렉토리 — 분야별 MCP 서버 탐색

직접 만든 공공데이터 MCP 서버가 있다면 등록 신청을 통해 MCP모아에 올려 주세요. 한국 개발자 커뮤니티와 함께 공공데이터 생태계를 넓혀 나가겠습니다.