AI 에이전트에 의무기록 연결하기

MCP(Model Context Protocol)를 사용하여 AI 어시스턴트가 내 의무기록에 안전하게 접근할 수 있도록 설정합니다.

English Version

개요

**MCP(Model Context Protocol)**는 AI 에이전트가 외부 데이터 소스에 접근할 수 있도록 하는 개방형 표준입니다. Persly MCP를 사용하면 AI 어시스턴트가 내 의무기록(검사 결과, 건강검진 증명서, 외래 진료 기록 등)에 안전하게 접근할 수 있습니다.

지원되는 AI 클라이언트:

• Claude (Claude.ai, Claude Desktop, Claude Code, Claude Mobile)
• ChatGPT
• Cursor, VS Code, Windsurf, Zed, JetBrains

사전 준비

• Persly 계정 (persly.ai)
• 완료된 의무기록 신청 (상태: 완료)
• MCP를 지원하는 AI 클라이언트

빠른 시작

Claude Code로 가장 빠르게 시작할 수 있습니다:

claude mcp add --transport http persly-mcp https://mcp.persly.ai/mcp

Claude에게 의무기록 목록을 요청하면, 브라우저를 통해 인증 후 데이터를 반환합니다.

사용 가능한 도구

예시 — list_medical_data

완료된 모든 의무기록의 요약을 반환합니다:

[
  {
    "id": 12345,
    "type": "CERTIFICATE",
    "date": "2026-03-15",
    "hospitalName": "서울대학교병원",
    "summary": "일반 건강검진 증명서"
  },
  {
    "id": 12346,
    "type": "MEDICAL_RECORD",
    "date": "2026-02-20",
    "hospitalName": "삼성서울병원",
    "summary": "외래 진료 기록 - 내과"
  }
]

예시 — get_medical_record

특정 기록의 마크다운 콘텐츠를 포함한 상세 정보를 반환합니다:

[
  {
    "id": 12345,
    "type": "CERTIFICATE",
    "date": "2026-03-15",
    "hospitalName": "서울대학교병원",
    "summary": "일반 건강검진 증명서",
    "markdown": "# 건강검진 증명서\n\n**환자**: ...\n**일자**: 2026-03-15\n...",
    "pageStart": 1,
    "pageEnd": 2
  }
]

인증 및 보안

Persly MCP는 OAuth 2.1 + PKCE 인증을 사용합니다:

• 브라우저 기반 로그인 — 브라우저를 통해 인증하며, API 키가 필요하지 않습니다
• 사용자 범위 데이터 — 본인의 의무기록에만 접근 가능합니다
• 완료된 기록만 — 상태가 완료(COMPLETED)인 기록만 접근 가능합니다
• 리프레시 토큰 — 반복적인 로그인 없이 세션이 유지됩니다
• HTTPS 전용 — 모든 통신이 암호화됩니다

문제 해결