언어 모델을 의료 기록에 연결하기 전에 세 가지 질문이 생깁니다. 모델이 무엇을 보는지, 누가 허락했는지, 그리고 무언가를 다시 작성하려고 할 때 어떤 일이 발생하는지입니다. Anpheros Platform은 API에서 이 세 가지 질문에 모두 답하므로, 여러분이 구축하는 어시스턴트(또는 사용자가 이미 가지고 있는 어시스턴트)는 자체 규칙을 만들지 않고도 기록을 처리할 수 있습니다. 이 가이드에서는 컨텍스트 API, MCP 서버 및 제안 흐름에 대해 다룹니다.
개발자를 위한 기술 버전: AI 의료 어시스턴트 · MCP 서버는 developers.anpheros.com에서 요청, 응답 및 제한 사항과 함께 제공됩니다. 이 페이지는 일반 사용자를 위한 버전입니다.
모델이 보는 것: 컨텍스트 API
POST /v1/context는 여러분이 설정한 토큰 예산 내에서 환자에 대한 AI 준비 요약을 생성합니다. 각 항목에는 author_type(환자, 의료진, 기기, 가져오기, 파생)과 출처가 포함되어 있어 모델이 검사 결과와 자가 보고 증상, 의사의 진단을 추측과 구분할 수 있습니다. 예산은 포함될 항목의 우선순위를 결정합니다. 먼저 활성 문제, 현재 복용 중인 약물, 알레르기, 최근 검사 결과가 포함되고 그 다음 나머지가 포함됩니다. 레이블이 지정된 섹션을 받거나, format: "text"를 사용하면 프롬프트에 바로 사용할 수 있는 렌더링된 블록과 포함되지 않은 항목의 이름을 나열하는 omitted 목록을 받게 됩니다.
curl -X POST "$BASE/v1/context" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"patient": "'$PID'", "budget_tokens": 2000, "task": "pre-visit summary", "format": "text"}'
동일한 출처 레이블은 나중에 방어 가능한 출력의 근거가 됩니다. 어시스턴트의 요약은 각 진술이 어디에서 왔는지 명시할 수 있습니다.
누가 허락했는지: 설정이 아닌 동의
위 호출의 토큰은 OAuth 2.1 with PKCE를 통해 개인이 선택한 범위와 기간으로 제공됩니다. AI 애플리케이션은 다른 애플리케이션과 마찬가지로 등록되고, 마찬가지로 요청하며, 개인의 "연결" 목록에 표시됩니다. 취소는 다음 요청 시 중지됩니다. 프로젝트 키만으로는 프로젝트가 생성한 환자만 볼 수 있으며, 동의를 대신할 수 없습니다.
다시 작성하기: 쓰기가 아닌 제안
AI 에이전트로 등록된 애플리케이션이 개인의 동의 하에 수행한 쓰기는 보류됩니다. 플랫폼은 이를 검증하고, 제안 ID와 함께 202 Accepted로 응답하며, 아무것도 변경하지 않습니다. 개인은 제안 내용, 제안의 내용 및 어떤 어시스턴트가 보냈는지 확인하고 수락하거나 거부합니다. 수락된 제안은 보낸 그대로 작성되며, HL7의 AI 투명성 지침에 따라 AI 작성으로 표시됩니다. 기록을 볼 수 있는 프로젝트는 얇은 proposal.created 웹훅을 받습니다.
이것은 어시스턴트가 "새로운 약물에 대해 언급하신 것을 보았는데, 추가해 드릴까요?"와 같이 유용하게 사용될 수 있도록 하지만, 기록의 작성자가 되는 일은 결코 없도록 하는 규칙입니다.
MCP 서버
Model Context Protocol을 사용하는 어시스턴트는 https://platform.anpheros.com/mcp(스트리밍 가능한 HTTP)에 직접 연결됩니다. 개인은 OAuth를 통해 자신의 기록에 연결하고, 개발자는 30명의 합성 환자에 대한 샌드박스 키로 연결할 수 있습니다. 도구는 API에서 예상할 수 있는 것들입니다.
list_patients,get_patient_context,get_patient_summary(국제 환자 요약),get_timelineget_health_patterns,get_pattern_evidence,get_series,compare_periods(무엇이 변경되었고 무엇이 반복되는지, 증거 포함; 진단 아님)search_fhir,read_fhir_resource,get_provenance,lookup_codevalidate_fhir_resource,create_fhir_resource,create_patient,import_lab_reportsandbox_status,reset_sandbox
서버는 MCP 레지스트리에 com.anpheros/fhir로 등록되어 있습니다. Claude, ChatGPT 및 기타 클라이언트에 대한 설정은 developers.anpheros.com/guides/mcp에서 확인할 수 있습니다.
개인 모델 및 EU 거주
플랫폼은 여러분을 대신하여 모델을 호출하지 않습니다. 컨텍스트를 제공하고 제안을 수락합니다. 어떤 모델이 컨텍스트를 읽을지는 여러분의 결정입니다. 호스팅된 API, 개인 배포, 병원 자체 하드웨어의 모델 등입니다. 기록 자체는 EU에 유지되며, europe-west4의 Cloud Run에서 모든 액세스에 대한 출처 및 감사 기록이 유지됩니다.
해당되지 않는 것
플랫폼은 진단하거나 치료를 권장하지 않으며, 컨텍스트 API는 임상 의사 결정 지원이 아닙니다. 모델에게 레이블이 지정된 사실을 동의 하에 제공합니다. 모델이 말하는 내용은 배포하는 사람의 책임입니다.
자주 묻는 질문
ChatGPT 또는 Claude를 환자 기록에 연결할 수 있나요?
예, MCP 서버를 통해 개인의 동의 하에 자신의 기록에 연결할 수 있습니다. 개발을 위해 샌드박스 키를 사용하면 어시스턴트가 30명의 합성 환자에 액세스할 수 있습니다.
AI가 기록에 작성하나요?
개인이 승인하는 제안으로만 가능합니다. AI 에이전트가 보내는 내용은 해당 승인 없이는 적용되지 않으며, 수락된 항목은 AI 작성으로 표시됩니다.
모델이 너무 많은 것을 보지 못하도록 어떻게 막을 수 있나요?
세 가지 방법이 있습니다. 개인이 부여하는 범위, 해당 범위에 대한 카테고리 필터, 그리고 컨텍스트 호출의 토큰 예산입니다. 토큰 예산은 임상적 관련성에 따라 항목을 정렬하고 예산에 도달하면 중지됩니다.
내 앱에 건강 챗봇을 위한 API가 있나요?
예. 앱은 OAuth를 통해 개인의 동의를 얻고, 컨텍스트 API를 호출하고, 결과를 선택한 모델로 보내고, 모델이 항목을 제안하면 쓰기로 제출합니다. 플랫폼은 이를 제안으로 전환합니다. TypeScript 및 Dart SDK는 이러한 호출을 지원합니다.
데이터는 어디에서 처리되나요?
기록은 EU에 저장되고 제공됩니다. 모델이 실행되는 위치는 여러분이 결정합니다. 플랫폼은 기록 데이터를 모델 자체로 보내지 않습니다.
건강 기록을 항상 소지하세요
Anpheros Daily는 증상, 검사 결과, 복용 중인 약 및 문서를 표준 형식으로 한곳에 모아 관리합니다. 기본 플랜은 무료입니다.