Ein Connector, der keinen Patienten erfindet.
Installation · Tools · So funktioniert’s · Grenzen
Nur stdio. Nach dem TypeScript-Build einen lokalen Connector hinzufügen:
name: smart-fhir
command: node
args: dist/index.jsnpm install
npm run buildUmgebung dafür (Standardwerte, keine Secrets):
FHIR_ISS = https://launch.smarthealthit.org/v/r4/fhir
FHIR_VERSION = R4
FHIR_AUTH_MODE = open
FHIR_WRITE = off
FHIR_AUDIT_PATH = ./audit/audit.jsonlLege keine Secret-Werte ins Repository ab. Kein öffentlicher HTTP-Port. Kein TCP-Bind.
npx -y tsx src/index.tsSiehe Skripte in package.json: install, build, test, prove.
Related MCP server: smart-mcp-server
Vier Tools. Kein create / update / delete.
Tool | Funktion |
| GET |
|
|
| GET |
| GET |
resourceType-Allowlist: Patient | Observation | Condition | MedicationRequest | Encounter. Alles andere → { ok: false, error: "resourceType not in v1 allowlist" }.
FHIR_VERSION muss R4 sein. Alles andere verweigert den Start.
Thema | URL | Wie einzuordnen |
FHIR-Index (veröffentlichte Seite ist R5 5.0.0) | Nur offizieller Index. Nicht implementiert. | |
FHIR R4 (v1) | FHIR Release 4, 4.0.1. Ressourcenmodell. | |
SMART App Launch 2.2.0 (STU 2.2) | Aktuell veröfentlichter SMART IG. Basierend auf FHIR R4. | |
App Launch + Autorisierung | Discovery, Standalone-/EHR-Launch, PKCE, Token. App Launch (code+PKCE) ist in v1 nicht enthalten. | |
Backend Services | client_credentials + Private-Key-JWT. Implementiert; nur verwendet, wenn die Umgebung entsprechend gesetzt ist. |
ISS-Zulassung (abschließender Schrägstrich wird entfernt, alles andere wird abgelehnt):
https://sandbox.smarthealthit.org/v/r4/fhir (Standard)
https://r4.smarthealthit.org
https://hapi.fhir.org/baseR4
Setze FHIR_ISS auf eine andere zugelassene Basis, um auf eine andere ISS zu zeigen. Eine neue ISS muss zuerst geprüft werden. Weisen Sie dieses nicht auf eine Live-EHR ohne diese Prüfung und eine echte client_id.
FHIR_AUTH_MODE | Verhalten |
| Discovery, dann FHIR GET ohne |
| Gleiche Discovery. FHIR GET mit Authorization-Bearer-Token. |
| Nur wenn sowohl |
App Launch (code+PKCE) ist nicht enthalten. FHIR_REDIRECT_URI ist reserviert und ungenutzt.
Fehlerfall Authentifizierung: { ok: false, http_status, issue?, error? }. Niemals eine synthetische Patientenseite.
FHIR_WRITE ist standardmäßig off. v1 hat keine Schreib-Tools, selbst wenn jemand on setzt. Schreibvorgänge senden kein AuditEvent per POST an FHIR.
Name | Standardwert | Hinweise |
| Standard-Launcher R4 | Muss in der Zulassungsliste bleiben |
|
| Alles andere ablehnen |
|
|
|
|
| Schreibzugriffe bleiben in v1 aus |
|
| Nur Append Datei JSONL; lokal |
| nicht gesetzt | Nur für Bearer |
| nicht gesetzt | Backend Services |
| nicht gesetzt | Alias für |
| nicht gesetzt | Backend Services JWT |
| nicht gesetzt | Reserviert, falls eine EHR JWKS verwenden will |
| fünf | Überschreibung im JWT-Modus |
| nicht gesetzt | Reserviert für später. App Launch |
Auditzeilen: ts, tool, iss, mode, resourceType, id?, http_status, entry_count?. Kein Ressourcenrumpf, kein Token, kein PEM, keine Name/MRN-Abfragewerte.
R5 / R4B als Standard. Zusätzliche Resourcentypen. CRUD. Bulk. App-Launch (Browser/PKCE).
Echte EHR / echte PHI. Produktionsbereitstellung. Öffentliches Binding oder Streamable HTTP.
momentum / fhirhydrant / Atrium / Pinecone / Medplum.
Kein Medizinprodukt. Stellt keine Diagnosen, behandelt nichts und speichert keine PHI.
Keine PHI. Keine Live-EHR.
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