서울 공공데이터 MCP 설치법 — 서울시 API를 AI 어시스턴트에 연결하기

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

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

서울 공공데이터 MCP를 설치하면 Claude가 서울시 실시간 버스 위치, 공원·주차장 현황, 문화 행사 일정 등 서울열린데이터광장의 API 데이터를 자연어 질문만으로 직접 조회할 수 있습니다. 이 가이드는 API 키 발급부터 Claude Desktop 연결, 동작 확인까지 전 과정을 단계별로 설명합니다. 준비물만 갖추면 약 15분이면 설정을 마칠 수 있습니다.

왜 서울 공공데이터를 MCP로 연결해야 할까요?

서울시는 서울열린데이터광장을 통해 1,000개 이상의 공공 API를 무료로 제공합니다. 하지만 이를 활용하려면 HTTP 요청 코드를 직접 작성하거나, API 문서를 뒤적이며 파라미터를 손수 조합해야 했습니다.

MCP(Model Context Protocol)를 사용하면 달라집니다. Claude 같은 AI 어시스턴트가 MCP 서버를 통해 공공 API를 직접 호출하고 결과를 해석해줍니다. “지금 광화문 근처 주차장 빈자리 알려줘”라고 물으면, Claude가 스스로 API를 호출해 실시간 데이터를 가져오는 방식입니다.

아래 표는 MCP 연결 전후 차이를 정리한 것입니다.

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

준비물

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

Node.js 18 이상 — nodejs.org에서 설치
Git — 저장소 클론에 필요
Claude Desktop 앱 — claude.ai/download에서 설치
서울열린데이터광장 계정 — API 키 발급용 (무료)

서울시 부동산 실거래가 같은 국토교통부 데이터를 함께 활용하려면 공공데이터포털(data.go.kr) 계정도 필요합니다.

데이터 흐름 이해

설치에 앞서 전체 구조를 파악해두면 디버깅이 훨씬 쉬워집니다.

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

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

단계별 설치 방법

1단계: 서울열린데이터광장 API 키 발급

data.seoul.go.kr에 접속해 회원가입합니다.
로그인 후 상단 메뉴 개발자 센터 → 인증키 신청으로 이동합니다.
사용 목적을 간단히 입력하고 신청하면 즉시 인증키가 발급됩니다.
발급된 인증키(API 키)를 복사해 안전한 곳에 보관하세요.

인증키 하나로 서울열린데이터광장의 모든 Open API에 접근할 수 있습니다. 단, 일부 데이터셋은 해당 페이지에서 별도 ‘활용신청’을 완료해야 데이터가 반환됩니다.

국토교통부 실거래가나 공공데이터포털 데이터를 함께 이용하려면 data.go.kr에서도 별도로 API 키를 발급받아야 합니다.

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

서울 공공데이터를 MCP로 활용할 수 있는 대표적인 오픈소스 서버로는 공공데이터포털 MCP 서버 모음과 한국 부동산 MCP가 있습니다.

**한국 부동산 MCP (국토교통부 실거래가)**를 예시로 설명합니다. 저장소를 클론하고 의존성을 설치합니다.

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

공공데이터포털 MCP 서버 모음은 uvx를 사용해 별도 클론 없이 바로 실행할 수 있습니다.

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_키_입력"
      }
    }
  }
}

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

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

정상적으로 연결됐다면 Claude에게 아래처럼 질문해볼 수 있습니다.

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

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

흔한 오류와 해결 방법

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

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

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

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

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

API 키 인증 실패 (401 오류)

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

Claude Desktop 설정 파일 JSON 오류

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

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

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

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

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

한국 부동산 MCP

한국 부동산 MCP는 국토교통부 실거래가 공공데이터를 활용해 아파트·오피스텔·빌라 실거래가를 조회하고 매수 시나리오를 분석합니다. GitHub 저장소는 https://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 키가 필요 없어 가장 간단하게 설치할 수 있습니다. GitHub 저장소는 https://github.com/dahlia/ko-stdict-mcp에서 확인하세요.

자주 묻는 질문

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

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

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

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

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

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

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

네. Node.js와 Git이 설치된 Windows 환경에서도 동일한 절차로 설치할 수 있습니다. Claude Desktop 설정 파일 경로만 운영체제에 맞게 적용하면 됩니다.

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

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

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

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

다음 단계

서울 공공데이터 MCP 설정을 마쳤다면 활용 범위를 더 넓혀보세요.

더 많은 공공 MCP 서버 탐색: 공공데이터 카테고리에서 국내 공공 데이터를 다루는 서버를 찾아볼 수 있습니다.
전체 MCP 서버 목록 보기: MCP모아 서버 목록에서 국내외 MCP 서버를 검색하세요.
직접 개발한 MCP 서버 등록: 서울시 외 다른 지역 공공 API나 특수 목적 MCP 서버를 만들었다면 MCP모아에 등록해 커뮤니티와 공유해보세요.

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