환자를 꾸며내지 않는 커넥터입니다.
stdio 전용입니다. TypeScript 빌드 후 로컬 커넥터를 추가하세요:
name: smart-fhir
command: node
args: dist/index.jsnpm install
npm run build이 env를 추가하세요(기본값이며 비밀값은 아닙니다):
FHIR_ISS = https://launch.smarthealthit.org/v/r4/fhir
FHIR_VERSION = R4
FHIR_AUTH_MODE = open
FHIR_WRITE = off
FHIR_AUDIT_PATH = ./audit/audit.jsonl저장소에 비밀값을 넣지 마세요. 공개 HTTP 포트를 열지 마세요. TCP를 바인딩하지 마세요.
npx -y tsx src/index.tspackage.json의 스크립트를 참고하세요: install, build, test, prove.
Related MCP server: smart-mcp-server
도구는 네 가지입니다. create / update / delete는 없습니다.
도구 | 동작 |
| GET |
|
|
| GET |
| GET |
resourceType 허용 목록: Patient | Observation | Condition | MedicationRequest | Encounter. 그 외에는 → { ok: false, error: "resourceType not in v1 allowlist" }.
FHIR_VERSION는 R4여야 합니다. 그 외 값이면 시작을 거부합니다.
항목 | URL | 읽는 방법 |
FHIR index(현재 바라보는 페이지는 R5 5.0.0) | 공식 인덱스만. | |
FHIR R4 (v1) | FHIR Release 4, 4.0.1. Resource 리소스 모델. | |
SMART App Launch 2.2.0 (STU 2.2) | 현재 발행된 SMART IG. FHIR R4 기반. | |
App launch + authorization | Discovery, standalone/EHR launch, PKCE, token. App Launch(code+PKCE)는 v1 범위 밖. | |
Backend Services | client_credentials + private-key JWT. 구현 되어 있으며, env가 설정된 경우에만 사용. |
ISS 허용 목록 (끝나는 슬래시는 제거되며, 그 외 값은 거부됩니다):
https://launch.smarthealthit.org/v/r4/fhir (기본값)
https://r4.smarthealthit.org
https://hapi.fhir.org/baseR4
FHIR_ISS를 허용 목록에 있는 다른 base로 설정하면 다른 ISS를 가리킬 수 있습니다. 새 ISS는 먼저 검토가 필요합니다. 검토와 실제 client_id가 없으면 운영 중인 EHR을 가리키지 마세요.
FHIR_AUTH_MODE | 동작 |
| Discovery 후 Authorization 없이 FHIR GET. Discovery 404는 open 모드에서는 치명적이지 않음(로그로 남기고 계속). FHIR 401/403 → |
| Discovery는 동일하게 수행함. Authorization Bearer 토큰을 붙여 FHIR GET. |
|
|
App Launch(code+PKCE)는 범위 밖입니다. FHIR_REDIRECT_URI는 reserved 되어 있으며 아직 사용하지 않습니다.
인증 실패 형태: { ok: false, http_status, guide?, error? }. 합성 Patient는 반환하지 않습니다.
FHIR_WRITE 기본값은 off입니다. v1은 누가 on을 설정해도 쓰기 도구가 없습니다. 쓰기 통신은 FHIR에 AuditEvent를 POST하지 않습니다.
이름 | 기본값 | 설명 |
FHIR_ISS | default launcher R4 | 반드시 allowlisted 유지 |
FHIR_VERSION | R4 | 다른 값은 거부 |
FHIR_AUTH_MODE | open | open / bearer / Backend_jwt |
FHIR_WRITE | off | v1에서는 쓰기(write)는 항상 off |
FHIR_AUDIT_PATH |
| Append-only JSONL; 로컬에서는 |
FHIR_ACCESS_TOKEN | 미설정 | Bearer 전용 |
FHIR_CLIENT_ID | 미설정 | Backend Services용 |
SMART_CLIENT_ID | 미설정 | FHIR_CLIENT_ID의 별칭 |
FHIR_PRIVATE_KEY_PEM | 미설정 | Backend Services JWT 용 |
FHIR_JWKS_URL | 미설정 | EHR가 JWKS를 원할 경우에 사용 |
FHIR_SCOPE | five system/*. 못한 types |
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Securely access and manage FHIR healthcare data stored in Medplum.
Hosted MCP endpoint with realistic fake data for prototyping agents. 12 tools, no setup.
Guardrailed FHIR access for AI agents: PHI redaction, audit trail, step-up auth, tenant isolation
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/swami8791/smart-fhir-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server