서울열린데이터광장 API 키는 유료인가요?

아니요. 서울열린데이터광장(data.seoul.go.kr) 회원가입 후 대부분의 API는 무료로 즉시 발급됩니다. 일부 고트래픽 데이터셋은 활용 신청 승인이 필요할 수 있습니다.

서울 공공데이터 MCP로 조회할 수 있는 데이터 종류는 무엇인가요?

서울시 버스·지하철 실시간 정보, 공원·주차장 현황, 문화 행사 일정, 대기질 정보, 부동산 실거래가 등 서울열린데이터광장 및 공공데이터포털이 제공하는 다양한 API 데이터를 연동할 수 있습니다.

한국 공공데이터를 Claude에 연결하기 — 공공 API용 MCP 서버 설치 가이드

Q: Windows에서도 같은 방법으로 설치할 수 있나요?

네. Node.js와 Git이 설치된 Windows 환경에서도 동일한 절차로 설치할 수 있습니다. Claude Desktop 설정 파일 경로만 %APPDATA%\Claude\claude_desktop_config.json으로 달리 적용하면 됩니다.

Q: API 응답이 느리거나 타임아웃이 날 때는 어떻게 하나요?

서울시 공공 API는 서버 점검 시간대에 응답이 지연될 수 있습니다. 서울열린데이터광장 공지사항에서 점검 일정을 확인하고, MCP 서버 타임아웃 옵션을 늘려보세요. 반복 실패 시 data.seoul.go.kr 서비스 상태 페이지를 확인하세요.

한국의 공공 API를 MCP로 연결하면 Claude가 부동산 실거래가, 국민연금 사업장 정보 같은 공공 데이터를 자연어 질문만으로 직접 조회합니다. 이 가이드는 API 키 발급부터 Claude Desktop 연결, 동작 확인, 오류 해결까지 전 과정을 다룹니다. 준비물만 갖추면 약 15분이면 설정을 마칠 수 있습니다.

먼저 짚고 갈 점. “서울열린데이터광장(data.seoul.go.kr)” 전용으로 바로 설치할 수 있는 검증된 오픈소스 MCP 서버는 아직 공개돼 있지 않습니다. 그래서 이 가이드는 지금 실제로 동작하는 두 가지 서버 — 국토교통부 실거래가를 다루는 한국 부동산 MCP와 공공데이터포털(data.go.kr) 여러 API를 묶은 공공데이터포털 MCP 서버 모음 — 을 예시로 설치 절차를 설명합니다. 여기서 익히는 클론·환경 변수·Claude Desktop 설정 방식은 앞으로 등장할 서울 전용 서버를 포함해 모든 MCP 서버에 그대로 적용됩니다.

공공 API를 MCP로 연결하면 무엇이 달라지나요?

공공데이터포털과 서울열린데이터광장은 수많은 공공 API를 무료로 제공합니다. 하지만 이를 활용하려면 HTTP 요청 코드를 직접 작성하거나, API 문서를 뒤적이며 파라미터를 손수 조합해야 했습니다.

MCP(Model Context Protocol)는 이 과정을 없애줍니다. Claude 같은 AI 어시스턴트가 MCP 서버를 통해 공공 API를 직접 호출하고 결과를 해석합니다. “서울 강남구 아파트 최근 실거래가 알려줘”라고 물으면, Claude가 스스로 API를 호출해 데이터를 가져와 정리해주는 방식입니다.

항목	MCP 연결 전	MCP 연결 후
데이터 조회 방법	직접 HTTP 코드 작성	자연어 프롬프트
API 문서 참조	필수	불필요
응답 파싱	개발자가 직접 처리	Claude가 해석
활용 가능 사용자	개발자 위주	누구나

준비물

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

Node.js 18 이상 — nodejs.org에서 설치 (한국 부동산 MCP 등 Node 기반 서버용)
Git — 저장소 클론에 필요
Claude Desktop 앱 — claude.ai/download에서 설치
공공데이터포털(data.go.kr) 계정 — 부동산·국민연금 등 국토부/정부 API 키 발급용 (무료)
(선택) uvx — 공공데이터포털 MCP 서버 모음을 클론 없이 실행할 때 사용
(선택) 서울열린데이터광장 계정 — 서울시 데이터셋을 직접 다루는 서버를 추가할 때 (무료)

데이터 흐름 이해

설치에 앞서 전체 구조를 파악해두면 디버깅이 훨씬 쉬워집니다. 어떤 공공 API를 쓰든 흐름은 동일합니다.

[Claude Desktop / Claude Code]
         │  MCP stdio 통신
         ▼
[공공데이터 MCP 서버] ── 환경 변수에서 API 키 로드
         │  HTTPS 요청
         ▼
[공공 API]   (data.go.kr / data.seoul.go.kr 등)
         │  JSON 응답
         ▼
[MCP 서버가 결과 파싱 → Claude로 전달]

Claude Desktop이 MCP 서버를 로컬 프로세스로 실행하고, 서버가 공공 API와 통신하는 구조입니다. API 키는 환경 변수로만 관리되어 Claude 본체에 직접 노출되지 않습니다.

단계별 설치 방법

아래 5단계를 순서대로 따라 하세요. 예시는 한국 부동산 MCP를 기준으로 하며, 끝에서 공공데이터포털 MCP 서버 모음을 쓰는 더 간단한 경로도 안내합니다.

1단계: API 키 발급

활용할 데이터 출처에 따라 키 발급처가 다릅니다.

공공데이터포털(국토부 실거래가·국민연금 등)

data.go.kr에 회원가입 후 로그인합니다.
활용할 API 페이지(예: 부동산 실거래가 API)에서 활용신청을 합니다.
마이페이지에서 발급된 인증키(API 키)를 복사해 안전한 곳에 보관합니다.

공공데이터포털은 API별로 활용신청이 필요하며, 신청 후 실제 사용 가능까지 수 분이 걸리는 경우가 있습니다.

서울열린데이터광장(서울시 데이터셋)

서울시 데이터를 직접 다루는 서버를 추가할 경우에만 필요합니다.

data.seoul.go.kr에 접속해 회원가입합니다.
로그인 후 개발자 센터 → 인증키 신청에서 사용 목적을 입력하고 신청하면 즉시 인증키가 발급됩니다.
인증키 하나로 서울열린데이터광장의 모든 Open API에 접근할 수 있습니다. 단, 일부 데이터셋은 해당 페이지에서 별도 활용신청을 완료해야 데이터가 반환됩니다.

2단계: MCP 서버 저장소 클론 및 의존성 설치

한국 부동산 MCP를 예시로 합니다. 저장소를 클론하고 의존성을 설치합니다.

git clone https://github.com/tae0y/real-estate-mcp
cd real-estate-mcp
npm install

공공데이터포털 MCP 서버 모음을 쓴다면 클론·설치 없이 uvx로 바로 실행할 수 있습니다(3·4단계에서 다시 등장합니다).

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

서울열린데이터광장 전용 MCP 서버는 커뮤니티에서 새로 등록될 수 있습니다. 최신 목록은 공공데이터 카테고리에서 확인하세요.

3단계: 환경 변수 설정

발급받은 API 키를 MCP 서버가 읽을 수 있도록 설정합니다. 저장소가 .env 파일을 지원한다면 프로젝트 루트에 파일을 생성합니다.

# .env 파일 예시 (저장소 루트에 생성)
DATA_GO_KR_API_KEY=여기에_발급받은_공공데이터포털_API_키_입력

.env 파일은 절대 Git에 커밋하지 마세요. .gitignore에 .env가 포함돼 있는지 반드시 확인하세요.

API 키를 Claude Desktop 설정 파일의 env 항목에 직접 입력하는 방법도 있으며, 4단계에서 설명합니다. 어느 한 가지 방법만 사용하면 됩니다.

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

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

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

텍스트 편집기로 설정 파일을 열고 mcpServers 항목에 아래 형식으로 추가합니다.

{
  "mcpServers": {
    "real-estate-mcp": {
      "command": "node",
      "args": ["/절대경로/real-estate-mcp/index.js"],
      "env": {
        "DATA_GO_KR_API_KEY": "여기에_발급받은_API_키_입력"
      }
    }
  }
}

/절대경로/real-estate-mcp/ 부분은 실제로 저장소를 클론한 경로로 바꾸세요. macOS에서는 ~/ 대신 /Users/사용자명/ 형식의 절대 경로를 사용해야 합니다.

기존에 다른 MCP 서버가 이미 등록되어 있다면 mcpServers 객체 안에 나란히 추가하면 됩니다. 항목 사이의 쉼표를 빠뜨리지 않도록 주의하세요.

{
  "mcpServers": {
    "기존-서버": { "command": "...", "args": [] },
    "real-estate-mcp": {
      "command": "node",
      "args": ["/절대경로/real-estate-mcp/index.js"],
      "env": {
        "DATA_GO_KR_API_KEY": "여기에_발급받은_API_키_입력"
      }
    }
  }
}

공공데이터포털 MCP 서버 모음은 command를 uvx로 지정하는 방식으로 등록합니다(아래 “함께 활용하면 좋은 서버” 참고).

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

설정 파일을 저장한 뒤 Claude Desktop을 완전히 종료하고 다시 실행합니다. macOS에서는 독(Dock)뿐 아니라 메뉴바 트레이에서도 완전히 종료해야 설정이 반영됩니다.

정상적으로 연결됐다면 Claude에게 아래처럼 질문해보세요.

“서울 강남구 아파트 최근 실거래가 조회해줘” (한국 부동산 MCP)
“올해 서울 오피스텔 매매 동향 알려줘” (한국 부동산 MCP)
“국민연금 사업장 가입 현황 조회해줘” (공공데이터포털 MCP 서버 모음)

Claude가 MCP 도구를 호출해 데이터를 가져오는 것을 확인할 수 있습니다.

흔한 오류와 해결 방법

설치 과정에서 자주 마주치는 오류와 해결책을 정리했습니다.

”Server disconnected” 또는 서버가 연결되지 않는 경우

설정 파일의 args 경로가 잘못됐거나 node 명령을 찾지 못한 경우에 발생합니다. node의 절대 경로를 확인합니다.

# node 실행 경로 확인
which node
# 출력 예: /usr/local/bin/node

확인한 절대 경로를 설정 파일의 "command" 값으로 사용해보세요. 예를 들어 "command": "/usr/local/bin/node"처럼 지정하면 PATH 환경 변수 문제를 우회할 수 있습니다.

API 키 인증 실패 (401 오류)

설정 파일 env 항목의 키가 발급받은 키와 정확히 일치하는지 확인하세요(앞뒤 공백·줄바꿈이 섞이지 않았는지도 확인). 공공데이터포털이나 서울열린데이터광장에서 해당 API에 대한 활용신청을 완료했는지도 체크해야 합니다. 신청 후 실제 사용 가능까지 수 분이 걸리는 경우가 있습니다.

Claude Desktop 설정 파일 JSON 오류

설정 파일은 순수 JSON 형식이라 쉼표 하나, 중괄호 하나가 어긋나도 서버 전체가 실행되지 않습니다. JSONLint 같은 온라인 도구에 설정 내용을 붙여넣어 유효성을 검사해보세요.

응답은 오지만 데이터가 빈 경우

공공 API 일부는 특정 조건(날짜 범위, 지역 코드 등) 없이는 빈 결과를 반환합니다. 해당 API 페이지의 테스트 요청(미리보기) 기능을 먼저 이용해 올바른 파라미터 조합을 확인하세요.

설치 전 빠른 점검 체크리스트

연결이 안 될 때 아래 항목을 순서대로 확인하면 대부분의 문제가 잡힙니다.

Node.js 18 이상이 설치돼 있고 which node 경로를 설정에 반영했는가
npm install이 오류 없이 끝났는가 (Node 기반 서버)
args 경로가 ~/가 아닌 절대 경로인가
env의 API 키가 발급 키와 정확히 일치하고 공백이 없는가
해당 API에 대한 활용신청이 승인됐는가
설정 파일이 JSONLint 통과하는 유효한 JSON인가
Claude Desktop을 트레이까지 완전히 종료 후 재시작했는가

함께 활용하면 좋은 공공데이터 MCP 서버

국내 공공 데이터를 AI에 연결하는 MCP 서버들입니다. 전체 목록은 공공데이터 카테고리에서 확인할 수 있습니다.

한국 부동산 MCP

한국 부동산 MCP는 국토교통부 실거래가 공공데이터를 활용해 아파트·오피스텔·빌라 실거래가를 조회하고 매수 시나리오를 분석합니다. GitHub 저장소는 github.com/tae0y/real-estate-mcp이며, API 키는 공공데이터포털에서 발급받습니다. 서울 부동산 데이터를 다루기에 가장 직접적인 선택지입니다.

공공데이터포털 MCP 서버 모음

공공데이터포털 MCP 서버 모음은 data.go.kr API를 AI에 연결하는 여러 서버를 묶은 모음입니다. 국민연금공단 사업장 가입 API, 국세청 사업자등록 진위 확인 API, 조달청 나라장터 API, 금융감독원 기업재무정보 API 등을 지원합니다. uvx로 클론 없이 바로 실행할 수 있습니다.

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

API 키는 data.go.kr에서 발급받습니다.

표준국어대사전 MCP 서버

표준국어대사전 MCP 서버는 국립국어원 표준국어대사전 데이터를 로컬 SQLite로 변환해 Claude에서 단어를 검색합니다. API 키가 필요 없어 가장 간단하게 설치할 수 있어, MCP 연결을 처음 연습해보기에 좋습니다. GitHub 저장소는 github.com/dahlia/ko-stdict-mcp에서 확인하세요.

자주 묻는 질문

서울열린데이터광장 전용 MCP 서버가 있나요?

이 글을 쓰는 시점 기준으로 서울열린데이터광장(data.seoul.go.kr)만을 위한 검증된 오픈소스 MCP 서버는 아직 공개돼 있지 않습니다. 다만 서울 부동산 실거래가는 국토교통부 데이터를 쓰는 한국 부동산 MCP로 조회할 수 있습니다. 서울 전용 서버가 등록되면 공공데이터 카테고리에서 확인할 수 있으며, 이 글의 설정 방식이 그대로 적용됩니다.

공공데이터 API 키는 유료인가요?

아니요. 공공데이터포털(data.go.kr)과 서울열린데이터광장(data.seoul.go.kr) 모두 회원가입 후 무료로 발급됩니다. 공공데이터포털은 API별 활용신청이 필요하고, 서울열린데이터광장은 인증키가 즉시 발급되되 일부 데이터셋만 별도 활용신청이 필요합니다.

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

네. MCP 프로토콜을 지원하는 Claude Code, Cursor, Zed 등 어느 클라이언트에서도 동일한 mcpServers 설정 방식으로 연결할 수 있습니다.

MCP로 조회할 수 있는 데이터 종류는 무엇인가요?

이 가이드의 서버 기준으로는 부동산 실거래가(국토부), 국민연금 사업장 가입, 사업자등록 진위 확인, 나라장터, 기업재무정보 등을 조회할 수 있습니다. 활용할 MCP 서버가 어떤 API를 호출하느냐에 따라 조회 가능한 데이터가 결정됩니다.

Windows에서도 같은 방법으로 설치할 수 있나요?

네. Node.js와 Git이 설치된 Windows 환경에서도 동일한 절차로 설치할 수 있습니다. 설정 파일 경로만 %APPDATA%\Claude\claude_desktop_config.json으로 적용하세요.

API 응답이 느리거나 타임아웃이 날 때는 어떻게 하나요?

공공 API는 서버 점검 시간대에 응답이 지연될 수 있습니다. 각 데이터 제공처(공공데이터포털·서울열린데이터광장)의 공지사항에서 점검 일정을 확인하고, MCP 서버에 타임아웃 옵션이 있다면 늘려보세요.

MCP 서버가 실행 중인데 Claude가 도구를 인식하지 못합니다.

Claude Desktop을 완전히 종료(트레이 아이콘까지 확인) 후 재시작하세요. 설정 파일 JSON에 쉼표 누락이나 따옴표 오류가 없는지 확인하고, 터미널에서 서버를 직접 실행해 오류 메시지를 확인하는 방법도 효과적입니다.

다음 단계

설정을 마쳤다면 활용 범위를 더 넓혀보세요.

더 많은 공공 MCP 서버 탐색: 공공데이터 카테고리에서 국내 공공 데이터를 다루는 서버를 찾아볼 수 있습니다.
전체 MCP 서버 목록 보기: MCP모아 서버 목록에서 국내외 MCP 서버를 검색하세요.
직접 개발한 MCP 서버 등록: 서울열린데이터광장 등 특정 공공 API를 다루는 MCP 서버를 만들었다면 MCP모아에 등록해 커뮤니티와 공유해보세요. 이 분야는 아직 빈자리가 많습니다.

공공데이터를 AI 어시스턴트에 연결하면 데이터 조회 방식이 근본적으로 달라집니다. 복잡한 API 문서를 읽지 않아도, 코드를 짜지 않아도 원하는 데이터를 자연어로 바로 얻을 수 있습니다. 오늘 설치를 마쳤다면, 평소 궁금했던 공공 데이터를 Claude에게 직접 물어보세요.