의료 마이데이터 MCP 연동 — 건강정보고속도로 API를 Claude에 연결하기

건강정보고속도로(myhealthway.go.kr)가 제공하는 의료 마이데이터 API를 MCP(Model Context Protocol)로 Claude에 연결하면, 진료 기록·투약 이력·검진 결과 같은 개인 의료 데이터를 AI 대화 안에서 직접 조회하고 분석할 수 있습니다. 이 글은 API 키 발급부터 Claude Desktop 설정 완료까지 전 과정을 단계별로 안내합니다. 민감 정보 취급 주의사항과 흔한 오류 해결법도 함께 다룹니다.

왜 의료 마이데이터를 MCP로 연결해야 하나요?

우리나라는 2022년 마이데이터 제도 시행 이후 건강정보고속도로를 통해 국민이 자신의 진료·처방·검진 데이터를 직접 내려받거나 제3자 서비스에 전달할 수 있게 됐습니다. 그런데 이 데이터를 실제로 활용하려면 복잡한 API 호출 코드를 작성하거나 별도 앱을 설치해야 했습니다.

MCP를 사용하면 이 과정이 크게 단순해집니다. Claude 채팅창에서 “지난 1년간 내 혈당 수치 추이를 보여줘” 또는 “투약 중인 약물 목록을 정리해 줘” 같은 자연어 질문만으로 API를 호출하고 결과를 즉시 분석받을 수 있습니다. 코드를 직접 다루지 않아도 됩니다.

[데이터 흐름]

사용자 (Claude Desktop)
       │
       ▼ 자연어 질문
  Claude (LLM)
       │
       ▼ MCP 도구 호출 (stdio)
  의료 마이데이터 MCP 서버 (로컬)
       │
       ▼ HTTPS API 요청 + API 키
  건강정보고속도로 API (myhealthway.go.kr)
       │
       ▼ JSON 응답
  MCP 서버 → Claude → 사용자 답변

이 흐름에서 중요한 점은 MCP 서버가 로컬 머신에서 실행된다는 것입니다. 의료 데이터가 Anthropic 서버를 거치지 않고 로컬에서 직접 API를 호출하므로, 불필요한 외부 전송 경로가 최소화됩니다.

준비물

시작하기 전에 아래 항목을 확인하세요.

항목	설명	필수 여부
건강정보고속도로 계정	myhealthway.go.kr 회원가입	필수
API 키	개발자 포털에서 발급	필수
Claude Desktop	Anthropic 공식 데스크톱 앱	필수
Node.js 18 이상 또는 Python 3.10 이상	MCP 서버 실행 환경	서버 구현체에 따라
Git	저장소 클론용	권장

단계별 연동 방법

1단계: 건강정보고속도로 API 키 발급

myhealthway.go.kr 개발자 포털에 접속해 회원가입을 완료합니다. 이후 API 사용 신청 메뉴에서 활용 목적을 기재하고 승인을 기다립니다. 개인 연구·개발 목적의 테스트 신청은 포털 공지에 따라 처리 기간이 다를 수 있으므로, 신청 후 이메일 알림을 확인하세요.

API 키 발급이 완료되면 마이페이지에서 클라이언트 ID와 클라이언트 시크릿을 확인할 수 있습니다.

주의: API 키를 코드에 직접 하드코딩하거나 GitHub 공개 저장소에 올리지 마세요. 반드시 환경변수나 .env 파일로 관리하고, .gitignore에 .env를 추가해야 합니다.

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

현재 건강정보고속도로 API를 직접 지원하는 MCP 서버는 개발 초기 단계에 있습니다. GitHub에서 관련 저장소를 검색하거나, 공공데이터 MCP 생태계의 패턴을 참고해 직접 구축할 수 있습니다. 아래는 일반적인 stdio 방식 MCP 서버를 클론하고 설치하는 흐름입니다.

# 저장소 클론 (실제 저장소 URL은 GitHub에서 확인)
git clone https://github.com/<저장소-경로>/myhealthway-mcp
cd myhealthway-mcp

# Node.js 기반인 경우
npm install

# Python 기반인 경우
pip install -r requirements.txt

참고: 설치 명령은 사용하는 MCP 서버 구현체에 따라 다릅니다. 반드시 해당 저장소의 README를 먼저 확인하세요. 존재하지 않는 패키지명을 임의로 실행하면 오류가 발생합니다.

3단계: 환경변수 설정

프로젝트 루트에 .env 파일을 만들고 발급받은 API 키를 입력합니다.

# .env 파일 예시
MYHEALTHWAY_CLIENT_ID=여기에_클라이언트_ID_입력
MYHEALTHWAY_CLIENT_SECRET=여기에_클라이언트_시크릿_입력
MYHEALTHWAY_API_BASE_URL=https://api.myhealthway.go.kr

.gitignore 파일에 .env가 포함되어 있는지 확인합니다.

echo ".env" >> .gitignore

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

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

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

설정 파일을 열고 mcpServers 항목에 아래와 같이 서버를 추가합니다. Node.js 기반 서버를 예로 들면 다음과 같습니다.

{
  "mcpServers": {
    "myhealthway": {
      "command": "node",
      "args": ["/절대경로/myhealthway-mcp/index.js"],
      "env": {
        "MYHEALTHWAY_CLIENT_ID": "여기에_클라이언트_ID",
        "MYHEALTHWAY_CLIENT_SECRET": "여기에_클라이언트_시크릿",
        "MYHEALTHWAY_API_BASE_URL": "https://api.myhealthway.go.kr"
      }
    }
  }
}

Python 기반 서버라면 command를 python으로, args를 ["/절대경로/myhealthway-mcp/server.py"]로 변경합니다. 경로는 반드시 절대경로로 입력해야 합니다.

5단계: Claude Desktop 재시작 및 테스트

설정 파일을 저장한 뒤 Claude Desktop을 완전히 종료하고 다시 실행합니다. 채팅 인터페이스 하단에 MCP 도구 아이콘이 표시되면 연결에 성공한 것입니다.

다음과 같은 메시지로 테스트해 보세요.

내 최근 건강검진 결과를 요약해 줘.

또는

지난 6개월간 처방받은 약물 목록을 보여줘.

정상적으로 응답이 오면 연동이 완료된 것입니다.

흔한 오류와 해결 방법

오류: “MCP server failed to start”

Claude Desktop 로그에서 이 오류가 보이면 대부분 다음 중 하나가 원인입니다.

절대경로 오류: args에 입력한 파일 경로가 실제 위치와 다릅니다. ls 명령으로 파일이 존재하는지 확인하세요.
Node.js 버전 불일치: node --version으로 18 이상인지 확인합니다.
의존성 미설치: npm install을 다시 실행해 보세요.

오류: API 인증 실패 (401 Unauthorized)

.env 파일의 API 키가 정확한지 재확인합니다.
Claude Desktop 설정 파일의 env 항목과 실제 발급된 키가 일치하는지 비교합니다.
API 키 사용 승인이 아직 처리 중일 수 있습니다. 건강정보고속도로 포털 마이페이지에서 승인 상태를 확인하세요.

오류: 응답이 오지만 데이터가 없음

조회하려는 데이터가 실제로 건강정보고속도로에 연동되어 있는지 포털 웹사이트에서 먼저 확인합니다. 의료기관에 따라 데이터 연동 여부가 다를 수 있습니다.
API 엔드포인트 URL이 최신 버전과 일치하는지 공식 문서에서 확인합니다.

한국 공공 의료·데이터 MCP 생태계

의료 마이데이터 외에도 한국 공공데이터를 Claude에 연결하는 MCP 서버들이 점차 늘어나고 있습니다. 아래는 함께 활용하면 유용한 관련 서버들입니다.

서버	연결 API	특징
한국 부동산 MCP	국토교통부 실거래가, 청약홈, 온비드	아파트·오피스텔 실거래가 조회 및 매수 시나리오 분석
공공데이터포털 MCP 서버 모음	data.go.kr 다수 API	국민연금, 국세청, 조달청, 금감원 등 광범위한 공공데이터
표준국어대사전 MCP	국립국어원 표준국어대사전	로컬 SQLite 기반, API 키 불필요

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

보안과 개인정보 고려사항

의료 데이터는 민감 정보입니다. MCP를 통해 연동할 때 반드시 아래 사항을 지켜주세요.

로컬 실행 원칙: MCP 서버는 로컬 머신에서 실행하고, 의료 데이터를 외부 MCP 프록시 서버로 중계하지 않습니다.

API 키 보안: API 키를 코드에 직접 포함하거나 공개 저장소에 올리지 않습니다.

Claude 사용 정책: Claude에 전달된 대화는 Anthropic 이용약관에 따라 처리됩니다. 업무용·기관용은 Claude for Work 또는 API 직접 연동을 검토하세요.

데이터 최소 수집: 필요한 항목만 쿼리하고, 불필요하게 전체 의료 기록을 한꺼번에 요청하지 않습니다.

자주 묻는 질문

건강정보고속도로 API는 누구나 사용할 수 있나요?

건강정보고속도로 API는 개인이 자신의 의료 마이데이터를 조회하거나, 공식 승인을 받은 기관·개발자가 활용할 수 있습니다. 개발 목적의 테스트 계정은 myhealthway.go.kr 개발자 포털에서 신청 가능합니다.

MCP 서버를 로컬에서만 실행해야 하나요?

현재 의료 마이데이터 관련 MCP 서버 구현체는 대부분 stdio 방식의 로컬 실행을 기본으로 합니다. 보안 정책상 민감한 의료 정보를 외부 서버로 중계하지 않고 로컬에서 처리하는 것이 권장됩니다.

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

MCP 프로토콜을 지원하는 클라이언트라면 모두 사용 가능합니다. Cursor, Windsurf 등 MCP 호환 에디터와 AI 도구에서 동일한 설정 방식으로 연결할 수 있습니다.

의료 데이터를 AI에 연결하면 개인정보 문제가 없나요?

MCP는 로컬 stdio 방식으로 동작하므로 데이터가 AI 제공사 서버로 직접 전송되지 않습니다. 다만 Claude에 전달된 대화 내용은 Anthropic 정책에 따라 처리되므로, 민감한 의료 정보를 다룰 때는 Claude for Work(기업용) 또는 API 직접 연동을 검토하시기 바랍니다.

API 키가 없어도 테스트할 수 있나요?

건강정보고속도로 개발자 포털에서 테스트용 샌드박스 환경을 제공할 수 있으나, 실제 제공 여부와 범위는 포털 공지를 직접 확인해야 합니다. 공식 문서(myhealthway.go.kr)에서 최신 정보를 확인하세요.

다른 한국 공공데이터 API도 MCP로 연결할 수 있나요?

네. 공공데이터포털(data.go.kr)의 다양한 API를 MCP로 연결하는 서버 모음이 이미 존재합니다. 국토교통부 실거래가, 국민연금, 금융감독원 데이터 등을 활용하는 방법은 관련 서버 페이지를 참고하세요.

다음 단계

의료 마이데이터 MCP 연동을 완료했다면, 이어서 아래 활용법을 시도해 보세요.

건강 데이터 시각화: Claude에게 데이터를 요청한 뒤 마크다운 표나 Python 코드로 차트를 생성하도록 요청합니다.
복약 관리 자동화: 투약 이력과 처방 정보를 결합해 복약 일정을 정리하고 상호작용 가능성을 확인합니다.
다른 공공데이터 연동 확장: 공공데이터 카테고리에서 건강보험·국민연금 데이터를 추가로 연결해 종합적인 개인 데이터 허브를 구성합니다.

더 많은 한국 MCP 서버는 MCP모아 서버 목록에서 확인하고, 직접 개발한 MCP 서버가 있다면 등록 신청도 환영합니다.