Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

AI 에이전트용 FHIR MCP 서버

Claude Code, Cursor, VS Code 또는 Claude Desktop을 MCP를 통해 HL7 FHIR R4 API에 연결: 기록 읽기용 20가지 도구, AI 준비 컨텍스트, 쓰기, 실험실 가져오기 및 샌드박스 재설정, 30명의 합성 환자 대상, 무료.

Anpheros FHIR는 AI 에이전트(Claude, Claude Code, Cursor, VS Code, Claude Desktop)가 HL7 FHIR R4 건강 데이터 API와 연동할 수 있도록 하는 원격 MCP 서버입니다. 두 가지 방식으로 연결할 수 있습니다.

무료 샌드박스 키 사용 시: 개발자용입니다. 에이전트는 환자 목록을 조회하고, FHIR 형식 또는 출처 정보가 포함된 AI 준비 컨텍스트로 레코드를 읽고, 관찰 항목을 작성하고, 실험실 보고서를 가져오고, 테스트 데이터를 초기화할 수 있습니다. 이 모든 작업은 현실적인 이력을 가진 30명의 합성 환자를 대상으로 합니다.
OAuth 사용 시: 개인 및 해당 개인의 레코드용입니다. 어시스턴트가 자체 등록하고, 개인이 Anpheros 동의 화면에서 로그인하여 승인하면, 어시스턴트는 선택된 기간 동안 해당 레코드 하나만 읽을 수 있습니다. 개인이 더 많은 권한을 허용하지 않는 한 읽기 전용입니다.

서버 주소: https://platform.anpheros.com/mcp (스트리밍 가능한 HTTP, 상태 비저장).

OAuth로 연결하기 (Claude 및 기타 어시스턴트)

https://platform.anpheros.com/mcp을 사용자 지정 커넥터로 추가합니다 (Claude: Settings → Connectors → Add custom connector). 다른 설정은 필요하지 않습니다. 어시스턴트가 인증 서버를 검색하고, 자체 등록하며, Anpheros 동의 화면을 엽니다. 여기서 사용자는 AI 어시스턴트임을 인지하고, 읽는 내용이 어시스턴트를 운영하는 회사로 전송된다는 점, 읽을 수 있는 항목, 기간, 선택 후 돌아갈 위치를 확인합니다. 요청된 내용이 더 많고 허용된 경우가 아니라면 접근은 읽기 전용이며, 사용자는 언제든지 이를 철회할 수 있습니다.

비공개 베타 기간 동안 OAuth 연결은 샌드박스 레코드를 사용합니다. 실제 레코드에 대한 연결은 개인정보처리방침 업데이트 후 열립니다.

샌드박스 키로 연결하기 (개발자)

Google로 platform.anpheros.com/dashboard에 로그인하고 Get a sandbox key를 선택합니다. sk_test_… 키와 30명의 합성 환자가 포함된 프로젝트를 받게 됩니다.
키를 환경 변수(예: ANPHEROS_KEY)에 넣고 도구에 서버를 추가합니다.

Claude Code

claude mcp add --transport http anpheros-fhir https://platform.anpheros.com/mcp --header "Authorization: Bearer $ANPHEROS_KEY"

Cursor (프로젝트 내 ~/.cursor/mcp.json 또는 .cursor/mcp.json)

{
  "mcpServers": {
    "anpheros-fhir": {
      "url": "https://platform.anpheros.com/mcp",
      "headers": { "Authorization": "Bearer ${env:ANPHEROS_KEY}" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "anpheros-fhir": {
      "type": "http",
      "url": "https://platform.anpheros.com/mcp",
      "headers": { "Authorization": "Bearer ${env:ANPHEROS_KEY}" }
    }
  }
}

Claude Desktop (claude_desktop_config.json, mcp-remote 브릿지를 통해)

{
  "mcpServers": {
    "anpheros-fhir": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://platform.anpheros.com/mcp", "--header", "Authorization: Bearer ${ANPHEROS_KEY}"],
      "env": { "ANPHEROS_KEY": "sk_test_…" }
    }
  }
}

그런 다음 에이전트에게 다음과 같이 질문합니다: "샌드박스 환자 목록을 보여주고, 당뇨병 환자를 선택한 다음, 그녀의 지난 6개월간 HbA1c 수치를 요약해 줘."

도구

도구	기능
`list_patients`	프로젝트의 환자: 30개의 합성 페르소나 및 사용자가 생성한 모든 환자
`get_patient_context`	토큰 예산 내에서 한 명의 환자에 대한 AI 준비 컨텍스트. 각 항목은 출처와 함께 레이블이 지정됩니다.
`get_patient_summary`	요청한 언어로 된 국제 환자 요약 (FHIR `$summary`)
`get_timeline`	리소스 유형 전반에 걸쳐 날짜 순서로 된 기록
`get_health_patterns`	베타: 변경된 사항과 반복되는 사항. 각 소견은 기간, 증거 및 제한 사항을 포함합니다. 진단은 제외됩니다 (가이드)
`get_pattern_evidence`	베타: 하나의 소견 뒤에 있는 모든 리소스
`get_series`	베타: 하루에 하나의 값으로 측정된 단일 측정값과 데이터 품질
`compare_periods`	베타: 선택한 두 기간의 단일 측정값
`search_fhir`	번들을 반환하는 표준 FHIR R4 검색
`read_fhir_resource`	단일 리소스 또는 해당 리소스의 이전 버전
`get_provenance`	리소스를 작성한 사람, 작성 시기 및 출처 시스템
`lookup_code`	텍스트 또는 코드로 LOINC 코드 (의약품의 경우 `search_health_terms` 사용)
`search_health_terms`	20개 언어로 된 증상, 질환 및 치료법의 공개 카탈로그. 이름, 동의어, 브랜드 또는 코드로 검색 가능 (가이드)
`get_health_term`	코드, 이름, MedlinePlus 요약, 출처 링크 및 인용된 EMA / FDA 적응증이 포함된 단일 카탈로그 항목
`validate_fhir_resource`	리소스를 저장하지 않고 확인
`create_fhir_resource`	리소스를 검증한 후 작성
`create_patient`	프로젝트에 새로 생성된 가상 환자
`import_lab_report`	CSV, HL7 v2 ORU^R01 또는 JSON 실험실 보고서를 실험실 관찰로 변환
`sandbox_status`	오늘 사용된 항목, 환자, 저장소, 재설정 기록
`reset_sandbox`	30개의 합성 환자를 복원합니다 (확인 요청)

읽기 도구는 읽기 전용으로 표시되고 재설정은 파괴적인 작업으로 표시되므로 위험한 작업 전에 클라이언트가 요청할 수 있습니다. 서버는 합성 환자 목록을 리소스로 제공하며, 임상의 요약, 실험실 CSV 가져오기, API 기반 통합 구축의 세 가지 프롬프트를 제공합니다.

동작 방식

API와 동일한 규칙. 모든 도구는 귀하의 키를 사용하여 공개 API를 호출합니다. 동일한 범위, 속도 제한, 유효성 검사 및 감사가 적용됩니다. 읽기 전용 키는 쓰기를 수행할 수 없습니다.
출처 추적. 에이전트가 작성하는 모든 내용은 출처 urn:anpheros:mcp과 함께 기록되므로 에이전트에서 비롯된 내용을 항상 알 수 있습니다.
환자 데이터는 데이터일 뿐입니다. 도구 결과에는 기록 콘텐츠가 지침으로 절대 사용되어서는 안 된다는 메모가 포함되어 있어, 의료 기록을 통한 프롬프트 주입을 기본적인 방지책으로 막습니다.
동의하에 하나의 기록. 프로덕션 API 키(sk_live_…)는 프로젝트의 모든 환자에게 접근할 수 있으므로 거부됩니다. 실제 기록은 해당 개인이 승인한 후 OAuth를 통해서만 어시스턴트에게 전달되며, 모든 읽기 작업은 해당 개인의 액세스 기록에 로깅됩니다.
표준 검색. 자격 증명 없이 서버는 401 응답과 함께 OAuth로 보호되는 리소스 메타데이터(RFC 9728)를 가리키는 WWW-Authenticate 헤더를 반환합니다. 어시스턴트는 동적 클라이언트 등록(RFC 7591) 및 PKCE를 통해 등록합니다. 등록은 루프백 주소, 알려진 편집기의 앱 스킴 및 알려진 AI 어시스턴트의 콜백 도메인만 허용합니다.

자주 묻는 질문

MCP 서버란 무엇인가요?

MCP(Model Context Protocol)는 AI 에이전트 및 코딩 도우미가 외부 도구를 호출하는 개방형 프로토콜입니다. FHIR용 MCP 서버를 사용하면 데이터를 채팅에 붙여넣는 대신 에이전트가 건강 기록을 직접 읽고 쓸 수 있습니다.

무료인가요?

예. MCP 서버는 무료 샌드박스에서 작동합니다. 프로젝트당 30명의 합성 환자, 하루 최대 10,000번의 쓰기, 카드 불필요.

도우미가 실제 환자의 기록을 읽을 수 있나요?

OAuth를 통해서만 가능하며, 해당 개인이 선택한 기간 동안 동의 화면에서 도우미를 승인한 후에만 자신의 기록(또는 자신이 돌보는 사람의 기록)을 읽을 수 있습니다. 비공개 베타 기간 동안 OAuth 연결은 샌드박스 기록을 사용합니다.

어떤 FHIR 버전을 사용하나요?

HL7 FHIR R4 (4.0.1)로, International Patient Summary와 동일한 API이며 동일한 데이터의 REST 뷰를 제공합니다. https://platform.anpheros.com/fhir/R4,과 동일합니다.

ChatGPT와 작동하나요?

ChatGPT 커넥터는 서버에서 지원하는 동적 클라이언트 등록을 사용하는 OAuth를 사용하며, 콜백 도메인이 허용됩니다. 공식 MCP SDK 클라이언트로 흐름을 테스트했습니다. ChatGPT 연결에 실패하면 [email protected]으로 문의하십시오. Claude Code, Cursor 및 VS Code도 샌드박스 키로 작동합니다.