API 키를 코드에 직접 넣어도 되나요?

보안상 권장하지 않습니다. Claude Desktop 설정 파일의 env 항목에 환경변수로 주입하거나, OS 레벨 환경변수로 설정하는 방식이 안전합니다.

국민연금공단 사업장 가입 API 외에 다른 공공 API도 연결할 수 있나요?

data-go-mcp-servers 저장소에는 국세청 사업자등록 진위 확인, 조달청 나라장터, 금융감독원 기업재무정보, 기상청 날씨 등 여러 API 서버 모음이 포함되어 있습니다. GitHub 저장소를 확인하여 필요한 서버를 추가로 등록하면 됩니다.

data.go.kr MCP 연동 완전 가이드 — 공공 API를 AI 어시스턴트에 붙이기

Q: uvx 명령어를 쓰려면 무엇을 설치해야 하나요?

Python 3.9 이상이 필요하며, 공식 설치 스크립트(curl -LsSf https://astral.sh/uv/install.sh)로 uv를 설치하면 uvx를 바로 사용할 수 있습니다.

공공데이터포털(data.go.kr)의 OpenAPI를 Claude 같은 AI 어시스턴트에 직접 연결하려면 MCP(Model Context Protocol) 서버를 중간에 두면 됩니다. API 키를 발급받고, uvx로 MCP 서버를 실행한 뒤, Claude Desktop 설정 파일에 등록하는 세 단계면 충분합니다. 이 가이드는 처음부터 끝까지 실제로 동작하는 수준까지 안내합니다.

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

한국 공공데이터포털에는 국민연금 사업장 가입 현황, 국세청 사업자 진위 확인, 조달청 나라장터 입찰 공고, 기상청 단기예보 등 수만 개의 OpenAPI가 있습니다. 그런데 이 데이터를 AI와 대화하며 바로 조회하려면 보통 별도 스크립트를 작성하거나 복잡한 API 호출 과정을 거쳐야 했습니다.

MCP 서버를 쓰면 이 과정이 대화 한 줄로 줄어듭니다. “이 사업자번호 유효한지 확인해줘”라고 입력하면 AI가 공공 API를 직접 호출해 결과를 가져옵니다. 반복적인 데이터 조회, 사업 정보 검증, 입찰 모니터링 같은 실무 작업에서 특히 유용합니다.

사용자
  │
  │ 자연어 요청
  ▼
Claude Desktop (MCP 클라이언트)
  │
  │ MCP 프로토콜
  ▼
data-go-mcp-servers (MCP 서버)
  │
  │ REST API + 인증키
  ▼
data.go.kr OpenAPI (공공데이터포털)
  │
  │ JSON 응답
  ▼
Claude Desktop → 사용자에게 답변

data-go-mcp-servers란?

공공데이터포털 MCP 서버 모음은 data.go.kr의 다양한 API를 MCP 서버 형태로 묶어 제공하는 오픈소스 프로젝트입니다. GitHub 저장소는 github.com/Koomook/data-go-mcp-servers에서 확인할 수 있습니다.

현재 지원하는 주요 API는 다음과 같습니다.

API 제공 기관	주요 내용
국민연금공단	사업장 가입자 현황 조회
국세청	사업자등록 진위 확인
조달청 나라장터	입찰 공고·낙찰 정보
금융감독원	기업 재무정보
대통령기록원	연설문 아카이브
화학물질안전원	MSDS(물질안전보건자료)

이 서버는 uvx 방식으로 배포되어 별도의 설치 없이 바로 실행할 수 있습니다.

준비물

운영체제: macOS, Windows, Linux 모두 가능
Python 3.9 이상 및 uv 패키지 매니저
Claude Desktop 또는 MCP 지원 클라이언트
data.go.kr 계정 및 API 인증키

단계별 연동 방법

1단계: 공공데이터포털 API 키 발급

data.go.kr에 접속하여 회원가입 또는 로그인합니다.
상단 검색창에서 원하는 API를 검색합니다. 예를 들어 “국민연금 사업장 가입”을 검색합니다.
해당 OpenAPI 서비스 상세 페이지에서 활용신청 버튼을 클릭합니다.
승인 완료 후 마이페이지 → 오픈API → 개발계정 에서 일반 인증키(Encoding)를 복사합니다.

발급받은 키는 아래처럼 생긴 긴 문자열입니다.

abc123XYZ...== (실제 키는 훨씬 길며, 여기서는 예시로 표기합니다)

2단계: uv 설치 확인

uvx를 사용하려면 uv가 먼저 설치되어 있어야 합니다. 터미널에서 아래 명령어로 확인합니다.

uv --version

설치되지 않았다면 공식 설치 명령어를 사용합니다.

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

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

3단계: MCP 서버 동작 확인 (선택)

Claude Desktop에 등록하기 전에 터미널에서 직접 실행해 정상 동작하는지 확인할 수 있습니다. 아래 명령어에서 YOUR_API_KEY 부분을 발급받은 인증키로 교체합니다.

DATA_GO_KR_API_KEY=YOUR_API_KEY uvx data-go-mcp.nps-business-enrollment@latest

오류 없이 실행되면 서버가 정상 작동하는 것입니다. Ctrl+C로 종료합니다.

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

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

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

파일을 열어 아래와 같이 mcpServers 항목을 추가합니다. 파일이 없으면 새로 만듭니다.

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

이미 다른 MCP 서버가 등록되어 있다면 mcpServers 객체 안에 항목을 추가하면 됩니다.

5단계: Claude Desktop 재시작 및 확인

설정 파일을 저장한 후 Claude Desktop을 완전히 종료하고 다시 실행합니다. 입력창 옆의 도구 아이콘에 새 MCP 서버가 표시되면 연동 성공입니다.

다음과 같이 대화를 시작해 동작을 확인합니다.

사용자: 사업자번호 123-45-67890 국민연금 가입 사업장인지 확인해줘

Claude가 MCP 서버를 통해 공공데이터포털 API를 실시간으로 조회하고 결과를 답변으로 제공합니다.

흔한 오류와 해결 방법

”uvx: command not found” 오류

uv가 설치되지 않았거나 PATH에 등록되지 않은 경우입니다. 2단계로 돌아가 uv를 설치하고, 터미널을 재시작합니다.

API 호출 시 “SERVICE_KEY_IS_NOT_REGISTERED_ERROR”

API 키가 잘못 입력되었거나, 해당 API 서비스를 아직 신청하지 않은 경우입니다. data.go.kr 마이페이지에서 활용 신청 상태를 확인하세요. URL 인코딩된 키(Encoding)와 디코딩된 키(Decoding)를 혼동하지 않도록 주의합니다. 일반적으로 환경변수에는 Decoding 키를 사용합니다.

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

설정 파일의 JSON 문법 오류일 가능성이 높습니다. JSON 유효성 검사 도구(예: jsonlint.com)로 파일을 확인하세요. 특히 쉼표 누락, 중괄호 불일치를 체크합니다.

일일 호출 한도 초과

공공데이터포털 API는 서비스마다 일일 요청 한도가 다릅니다. 마이페이지에서 트래픽 현황을 확인하고, 한도를 늘리려면 해당 API 상세 페이지에서 ‘활용 신청 수정’으로 요청 횟수를 상향 조정합니다.

함께 쓰면 좋은 MCP 서버

공공 데이터 분석 작업을 확장하고 싶다면 아래 서버도 살펴보세요.

한국 금융 MCP: 한국은행 ECOS, DART 전자공시, KRX, 국토부 실거래가 등 자본시장 데이터를 통합 제공합니다. 기업 분석이나 부동산 조사에 유용합니다.
한국 기상청 날씨 MCP: 기상청 단기예보 API를 통해 지역별 날씨를 실시간으로 조회합니다. data.go.kr 인증키로 함께 활용할 수 있습니다.

공공 데이터 카테고리에서 더 많은 한국 공공 API MCP 서버를 찾아보실 수 있습니다.

자주 묻는 질문

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

공공데이터포털(data.go.kr)에 회원가입 후, 원하는 OpenAPI 서비스 상세 페이지에서 ‘활용신청’ 버튼을 클릭하면 됩니다. 승인은 대부분 즉시 처리되며, 마이페이지에서 인증키를 확인할 수 있습니다.

API 키를 설정 파일에 직접 넣어도 되나요?

Claude Desktop 설정 파일은 로컬에 저장되므로, 개인 용도에서는 크게 문제없습니다. 다만 설정 파일을 버전 관리 시스템(Git 등)에 올리지 않도록 주의하세요. 팀 환경에서는 OS 레벨 환경변수를 사용하는 것이 더 안전합니다.

uvx 명령어를 쓰려면 무엇을 설치해야 하나요?

Python 3.9 이상이 필요하며, uv 패키지 매니저를 설치하면 uvx를 바로 사용할 수 있습니다. uv는 pip보다 훨씬 빠른 Python 패키지 관리 도구로, 별도의 가상환경 설정 없이도 패키지를 실행할 수 있습니다.

국민연금 API 외에 다른 공공 API도 연결할 수 있나요?

네, data-go-mcp-servers 저장소에는 국세청 사업자등록 진위 확인, 조달청 나라장터, 금융감독원 기업재무정보 등 여러 API 서버가 포함되어 있습니다. GitHub 저장소에서 사용 가능한 서버 목록을 확인하고 필요한 것을 추가로 등록하면 됩니다.

Claude Desktop이 아닌 다른 MCP 클라이언트에서도 사용할 수 있나요?

네, MCP 표준을 지원하는 Cursor, Windsurf, Cline 등 대부분의 클라이언트에서 동일한 방식으로 설정할 수 있습니다. 각 클라이언트의 설정 파일 위치만 다르며, mcpServers 설정 형식은 동일합니다.

데이터 조회에 비용이 발생하나요?

공공데이터포털의 OpenAPI는 대부분 무료로 제공됩니다. 다만 일부 API는 일일 호출 한도가 있으므로, 해당 API 상세 페이지에서 제한 조건을 반드시 확인하시기 바랍니다.

다음 단계

이 가이드를 따라 data.go.kr MCP 연동을 완료했다면, 이제 AI와 대화하며 한국 공공 데이터를 실시간으로 조회할 수 있습니다. 공공 데이터 카테고리에서 더 많은 MCP 서버를 탐색하거나, 서버 목록에서 다른 한국 API MCP 서버를 찾아보세요. 직접 만든 MCP 서버가 있다면 등록 페이지를 통해 MCP모아에 등록할 수도 있습니다.