응급실 현황 API를 Claude에 연결하기 — 공공 의료 데이터 MCP 연동 가이드

공공데이터포털(data.go.kr)의 응급의료 현황 API를 MCP 서버로 연결하면, Claude에서 “지금 서울 응급실 병상 있어?”처럼 자연어로 전국 응급실 현황을 조회할 수 있습니다. 다만 한 가지 먼저 알아둘 점이 있습니다. 응급실 현황만 단독으로 래핑한 공식 MCP 패키지는 아직 없습니다. 그래서 이 가이드는 막연히 “패키지를 설치하세요”라고 하지 않고, 현실적으로 가능한 두 가지 경로를 명확히 비교한 뒤 각각의 설정 과정을 단계별로 안내합니다.

시작 전에 — 두 가지 연결 경로

응급실 API를 Claude에 붙이는 길은 크게 두 갈래입니다. 본인 상황에 맞는 쪽을 먼저 정하세요.

경로	적합한 경우	장점	단점
A. 공공데이터 MCP 모음 활용	코딩 없이 빠르게 시작하고 싶을 때	별도 개발 불필요, uvx 한 줄로 설치	모음에 포함된 API 범위 내에서만 사용
B. 직접 MCP 서버 구현	응급실 API를 정확히 원하는 형태로 노출하고 싶을 때	응답 가공·파라미터를 자유롭게 제어	Node.js/Python 코드 작성 필요

응급실 현황 API를 단독으로 제공하는 공식 npm·PyPI 패키지는 알려져 있지 않습니다. 경로 A는 공공데이터포털 MCP 서버 모음(data-go-mcp-servers)이 지원하는 API 목록 안에서 동작하므로, 모음의 README에서 응급의료 관련 도구 제공 여부를 먼저 확인하는 것이 좋습니다. 모음에 없거나 응답 형태를 직접 다루고 싶다면 경로 B로 가세요.

왜 응급실 데이터를 Claude에 연결할까요?

응급실 현황은 시간이 촉박한 상황에서 가장 빠르게 접근해야 하는 정보입니다. 보건복지부 중앙응급의료센터(NEMC)는 전국 응급의료기관의 가용 병상 수, 진료 가능 여부, 위치를 API로 공개하지만, 포털을 직접 방문하거나 API를 수동 호출하는 방식은 번거롭습니다.

MCP(Model Context Protocol)로 이 API를 Claude에 연결하면 다음이 가능해집니다.

• “지금 서울 서초구에서 소아과 진료 가능한 응급실이 어디야?”처럼 자연어로 질의
• 여러 병원 데이터를 한 번에 비교·요약
• 다른 공공 API(약국 현황 등)와 결합한 복합 질의

개발자뿐 아니라 비개발자도 자연어만으로 공공 데이터를 활용할 수 있다는 점이 MCP의 핵심 가치입니다.

데이터 흐름 구조

[Claude Desktop / Claude Code]
          |
          | MCP 프로토콜 (stdio / SSE)
          v
   [응급실 현황 MCP 서버]
          |
          | HTTPS REST API 호출
          v
[data.go.kr 응급의료 현황 API]
   (보건복지부 공공데이터)

Claude가 자연어 질의를 보내면 MCP 서버가 이를 API 파라미터로 변환해 공공데이터포털에 요청하고, 응답 JSON을 Claude가 이해할 수 있는 형태로 반환합니다.

준비물

항목	설명	경로
공공데이터포털 계정	data.go.kr 회원가입 (무료)	A·B 공통
응급의료 현황 API 인증키	포털에서 활용신청 후 발급	A·B 공통
Claude Desktop 또는 Claude Code	MCP 클라이언트	A·B 공통
uvx (uv 패키지 매니저)	경로 A의 uvx 방식 설치 시	주로 A
Node.js 18+ 또는 Python 3.10+	MCP 서버 실행 환경	주로 B (A는 서버 방식에 따라)
Git	저장소 클론용	주로 B

1단계 — 공공데이터포털 API 키 발급 (공통)

data.go.kr에 접속해 로그인합니다. 검색창에 “응급의료기관 현황” 또는 “응급실 실시간 가용병상” 을 검색하면 보건복지부가 제공하는 API 목록이 나옵니다.

원하는 API 상세 페이지에서 활용신청 버튼을 누르고 활용 목적을 간단히 기재하면, 즉시 또는 1~2 영업일 내에 일반 인증키(서비스 키) 가 마이페이지에 발급됩니다. 발급된 인증키는 다음 단계에서 환경 변수로 사용하므로 안전한 곳에 복사해 두세요.

인증키는 URL 인코딩된 형태와 일반(Decoding) 형태 두 가지로 제공될 수 있습니다. 환경 변수에는 마이페이지의 일반 인증키를 사용하세요.

이제 본인이 정한 경로에 따라 2단계로 넘어갑니다.

---

경로 A — 공공데이터 MCP 모음으로 빠르게 연결

코드를 작성하지 않고 시작하려면 공공데이터포털 MCP 서버 모음(data-go-mcp-servers)을 사용합니다. data.go.kr의 여러 API를 MCP 도구로 묶어 제공하므로, 응급의료 관련 도구가 포함되어 있다면 설정만으로 바로 쓸 수 있습니다.

A-2단계 — uvx 설치 환경 준비

이 모음은 API별로 패키지가 나뉜 구조라, uvx(uv 패키지 매니저)로 필요한 도구만 골라 실행하는 방식이 가장 간단합니다. 별도의 가상환경 설정 없이 명령 한 줄로 서버를 띄울 수 있습니다.

uv가 설치되어 있지 않다면 먼저 설치합니다.

# uv 설치 (macOS/Linux)
curl -LsSf https://astral.sh/uv/install.sh | sh

설치 후 터미널을 재시작해야 uvx가 PATH에 잡힙니다. uv --version으로 설치 여부를 확인하세요.

A-3단계 — 사용할 패키지명 확인

모음은 API별로 패키지가 분리되어 있습니다. 예를 들어 국민연금 사업장 가입 API는 다음과 같은 형태로 실행합니다.

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

위는 패키지 명명 규칙을 보여주는 예시일 뿐, 응급의료용 패키지가 아닙니다. 응급의료 API에 해당하는 정확한 패키지명(또는 직접 클론·실행 명령)은 공식 저장소 github.com/Koomook/data-go-mcp-servers의 README에서 확인하세요. 소스를 직접 받아 실행하려면 다음처럼 클론합니다.

git clone https://github.com/Koomook/data-go-mcp-servers

A-4단계 — Claude Desktop 설정

Claude Desktop 설정 파일에 모음 서버를 등록합니다. command·args는 README에서 확인한 값(uvx 방식이면 아래와 같은 형태)을 사용하고, 환경 변수에 1단계에서 받은 인증키를 넣습니다.

{
  "mcpServers": {
    "data-go-mcp": {
      "command": "uvx",
      "args": ["<README에서 확인한 패키지명>@latest"],
      "env": {
        "DATA_GO_KR_API_KEY": "여기에_발급받은_인증키_입력"
      }
    }
  }
}

이후는 공통 단계인 Claude Desktop 재시작 및 테스트로 이동하세요.

---

경로 B — MCP 서버 직접 구현

응급실 API를 원하는 형태로 노출하고 싶다면 직접 MCP 서버를 만듭니다. MCP 공식 SDK를 쓰면 수십 줄의 코드로 REST API를 MCP 도구로 노출할 수 있습니다.

B-2단계 — 프로젝트 초기화

# Node.js 기반 MCP 서버 프로젝트 초기화 예시
mkdir emergency-mcp && cd emergency-mcp
npm init -y
npm install @modelcontextprotocol/sdk node-fetch

서버 내부에서는 1단계에서 발급한 인증키로 data.go.kr 응급의료 현황 API를 호출하고, 응답 JSON을 MCP 도구의 결과로 반환하도록 구현합니다. 필수 파라미터와 응답 필드는 활용신청한 API의 명세서를 기준으로 작성하세요.

B-3단계 — 환경 변수 설정

인증키를 환경 변수로 등록합니다. 프로젝트 루트에 .env 파일로 관리하는 것을 권장합니다.

# .env 파일 예시
DATA_GO_KR_API_KEY=여기에_발급받은_인증키_입력

셸 환경에 직접 설정하려면 아래 명령을 사용합니다.

export DATA_GO_KR_API_KEY="여기에_발급받은_인증키_입력"

인증키를 소스 코드나 Git 저장소에 직접 포함하지 마세요. .gitignore에 .env를 추가해 두는 것이 좋습니다.

B-4단계 — Claude Desktop 설정

직접 구현한 Node.js 서버를 등록하는 예시입니다.

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

args의 경로는 반드시 절대 경로로 입력하세요. 상대 경로를 쓰면 Claude Desktop이 서버를 찾지 못할 수 있습니다.

---

Claude Desktop 설정 파일 위치 (공통)

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

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

파일이 없으면 새로 만들고, 이미 다른 서버가 있다면 mcpServers 안에 항목만 추가하면 됩니다.

Claude Desktop 외에 Cursor, Zed처럼 MCP를 지원하는 다른 클라이언트에도 동일한 방식으로 연동할 수 있습니다. 설정 파일 형식이 클라이언트마다 조금씩 다르므로 각 클라이언트의 MCP 설정 문서를 참고하세요.

Claude Desktop 재시작 및 테스트 (공통)

설정 파일을 저장한 뒤 Claude Desktop을 완전히 종료하고 다시 실행합니다. macOS에서는 “Claude → Quit Claude”를 선택하거나 Dock에서 우클릭 후 종료합니다. 앱이 시작될 때 mcpServers에 등록된 서버를 자동으로 기동합니다.

채팅창 하단의 도구 아이콘(망치 모양)에 등록한 도구가 나타나면 연결에 성공한 것입니다. 다음 질문으로 동작을 확인하세요.

현재 서울 지역 응급실 병상 현황을 알려줘.

조금 더 좁혀서 물어볼 수도 있습니다.

서울 강남구 응급실 중 현재 가용 병상이 있는 곳을 알려줘.

경기도 성남시 응급의료기관 목록과 연락처를 정리해 줘.

Claude가 MCP 서버를 통해 API를 호출하고 결과를 표나 목록으로 정리해 답변하면 연동이 완료된 것입니다.

연결 확인 체크리스트

연동이 안 될 때 아래를 순서대로 점검하세요.

• claude_desktop_config.json이 유효한 JSON인가? (콤마·중괄호 누락 확인)
• command·args 값에 오탈자가 없는가? (경로 B는 절대 경로인가?)
• (경로 A) uvx가 PATH에 잡히는가? uv --version으로 확인
• DATA_GO_KR_API_KEY에 일반 인증키가 정확히 들어갔는가?
• data.go.kr에서 해당 API의 활용신청 상태가 “승인”인가?
• Claude Desktop을 완전히 종료 후 재시작했는가?

흔한 오류와 해결 방법

오류 상황	원인	해결 방법
도구가 목록에 나타나지 않음	JSON 문법 오류 또는 경로 오탈자	설정 파일을 JSON 검사기(예: jsonlint.com)로 확인, 경로를 절대값으로 재입력
API 호출 실패 (401/403)	인증키 미설정 또는 오탈자, 활용신청 미승인	환경 변수 이름·값과 활용신청 상태를 다시 확인
API 호출 실패 (429 Too Many Requests)	일일 호출 한도 초과	다음 날 재시도 또는 포털에서 한도 상향 신청
uvx 명령을 찾을 수 없음	uv 미설치 또는 PATH 미등록	uv --version으로 확인, 설치 후 터미널 재시작
서버가 즉시 종료됨	의존 패키지 미설치	npm install 재실행 후 오류 로그 확인
응답 데이터가 빈 값 또는 오래됨	API 파라미터 오류 또는 갱신 주기·서버 지연	명세서에서 필수 파라미터·갱신 주기 확인, 실시간성이 중요하면 응급의료포털(e-gen.or.kr) 공식 API도 함께 검토

오류 발생 시 터미널에서 서버 명령을 직접 실행하면 스택 트레이스를 확인할 수 있어 원인 파악이 빠릅니다.

# 직접 구현한 서버를 터미널에서 실행해 오류 확인 (경로 B)
node /절대경로/emergency-mcp/index.js

관련 공공 데이터 MCP 서버

응급실 현황 외에도 한국 공공데이터를 AI에 연결하는 MCP 서버가 있습니다.

• 공공데이터포털 MCP 서버 모음 — 국민연금, 조달청, 금융감독원 등 다양한 공공 API를 MCP로 제공합니다.
• 한국 부동산 MCP — 국토교통부 실거래가 데이터를 Claude에서 바로 조회합니다.
• 표준국어대사전 MCP 서버 — 국립국어원 사전 데이터를 로컬 SQLite로 변환해 MCP로 검색합니다.

공공데이터 카테고리의 더 많은 서버는 /category/public-data에서, 전체 서버는 서버 디렉토리에서 탐색할 수 있습니다.

자주 묻는 질문

응급실 MCP 서버가 공식 패키지로 배포되어 있나요?

현재 응급실 현황 API만 단독으로 제공하는 공식 npm·PyPI 패키지는 알려져 있지 않습니다. 그래서 이 가이드는 공공데이터포털 MCP 서버 모음을 uvx로 활용하는 경로 A와, MCP 공식 SDK로 직접 구현하는 경로 B를 함께 안내합니다.

경로 A와 경로 B 중 무엇을 골라야 하나요?

코딩 없이 빠르게 시작하고 모음이 지원하는 API 범위면 충분하다면 경로 A가 낫습니다. 응급실 API의 응답 형태나 파라미터를 직접 제어하고 싶거나 모음에 해당 API가 없다면 경로 B로 구현하세요.

MCP가 없으면 응급실 API를 AI에 연동할 수 없나요?

MCP 없이도 API를 직접 호출하는 코드를 작성할 수 있지만, MCP를 사용하면 Claude가 자연어 질문만으로 실시간 데이터를 조회할 수 있어 훨씬 편리합니다. 경로 A는 코딩 없이도 연동이 가능합니다.

API 키 발급에 얼마나 걸리나요?

신청 즉시 또는 1~2 영업일 안에 인증키가 발급됩니다. 일부 API는 담당 기관의 승인 절차가 필요해 최대 3영업일이 걸릴 수 있습니다.

응급실 현황 API는 실시간 데이터인가요? 얼마나 자주 갱신되나요?

보건복지부가 제공하는 응급의료 현황 API는 전국 응급의료기관의 병상 가용 정보를 주기적으로 갱신합니다. 보통 수십 분~1시간 단위로 갱신되지만 기관마다 다를 수 있으니, 활용신청한 API의 명세서에서 정확한 업데이트 간격을 확인하세요.

Claude Code와 Claude Desktop 중 어디에 설정해야 하나요?

두 클라이언트 모두 MCP를 지원합니다. Claude Desktop은 claude_desktop_config.json을, Claude Code는 프로젝트 루트의 .mcp.json 또는 설정 커맨드로 서버를 등록합니다. 개인 탐색·조회 목적이라면 Claude Desktop이, 개발 워크플로우 통합이라면 Claude Code가 편리합니다. Cursor, Zed 등 다른 MCP 지원 클라이언트도 같은 방식으로 연동할 수 있습니다.

API 호출 비용이 발생하나요?

공공데이터포털의 응급의료 현황 API는 무료로 제공됩니다. 다만 일별 호출 횟수 제한이 있을 수 있으므로 API 상세 페이지에서 트래픽 정책을 확인하세요.

API 키를 설정 파일에 평문으로 넣어도 안전한가요?

로컬 개발 환경에서는 일반적으로 허용되지만, 공용 PC나 팀 저장소에는 .env 또는 환경 변수로 분리해 관리하는 것이 안전합니다. 키가 유출되면 즉시 data.go.kr 마이페이지에서 재발급하세요.

응급실 외 다른 공공 의료 데이터도 MCP로 연동할 수 있나요?

네, 건강보험심사평가원(HIRA), 질병관리청 등 다양한 의료 공공 API가 data.go.kr을 통해 제공됩니다. 공공데이터포털 MCP 서버 모음을 활용하면 약국 현황, 의료기관 정보 등 여러 API를 하나의 MCP 환경에서 관리할 수 있습니다.

MCP 서버 설정 후 Claude가 도구를 인식하지 못하면 어떻게 하나요?

claude_desktop_config.json의 JSON 문법 오류, 명령어 경로 오탈자, API 키 누락이 가장 흔한 원인입니다. 위의 연결 확인 체크리스트를 점검하고, 터미널에서 서버 명령을 직접 실행해 오류 메시지를 확인한 뒤 Claude Desktop을 완전히 종료 후 재시작하세요.

다음 단계

응급실 현황 연동에 성공했다면 다른 공공 의료 데이터로 확장해 보세요. 약국 현황, 의료기관 정보, 응급의료통계 등을 같은 방식으로 MCP 서버에 추가할 수 있습니다.

직접 구현한 MCP 서버가 있다면 MCP모아에 등록해 한국 개발자 커뮤니티와 공유해 주세요. 더 많은 공공데이터 활용 사례는 가이드 목록에서 확인할 수 있습니다.