smart-fhir

Un conector que no inventa un paciente.

Instalación · Herramientas · Cómo funciona · Límites

Instalación

Solo stdio. Después de la compilación de TypeScript, añade un conector local:

name: smart-fhir
command: node
args: dist/index.js

npm install
npm run build

Variables de entorno para ello (valores por defecto, no secretos):

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

No pongas valores secretos en el repositorio. Sin puerto HTTP público. No hagas bind de TCP.

Atajo matutino (mismo entorno)

npx -y tsx src/index.ts

Consulta los scripts de package.json: install, build, test, prove.

Related MCP server: smart-mcp-server

Herramientas

Cuatro herramientas. Sin create / update / delete.

Lista permitida de resourceType: Patient | Observation | Condition | MedicationRequest | Encounter.

Cualquier otra cosa → { ok: false, error: "ERR_NOT_IN_ALLOWED" }.

Cómo funciona

FHIR_VERSION debe ser R4. Cualquier otro valor impide que the conectorse inice.

Wait need to make sure row descriptions align. The table was:

Need to translate. Keep row count.

Let's craft table:

Let's careful "Backend Services": In Spanish "Servicios backend" but keep as "Backend Services" as official. The phrase "client_credentials + private-key JWT" as code? Not code but parameters. We can say "client_credentials + JWT con clave privada. Implementado; no se usa salvo que se configure la variable de entorno."

ISS lista permitida (barra final retirada / cualquier otra cosa rechazada):

• https://launch.smarthealthit.org/v/r4/fhir (default)

• https://r4.smarthealthit.org

• https://hapi.fhir.org/baseR4

Establece FHIR_ISS a otra base permitida para apuntar a un ISS posterior. Un ISS nuevo necesita revisión previa. No lo apuntes a un EHR en producción sin esa revisión más un client_id real.

Wait the original open row says "Discover, then FHIR GET without Authorization." I'm currently translating "sin autorización" etc. Let's craft coherent:

Let's create:

Then paragraph "App Launch (code+PKCE) está fuera. FHIR_REDIRECT_URI queda reservado y nonusado." OK.

"Error shape: { ok doesn't include http_status? }" OK.

Need to preserve "Auth failure shape" text. Spanish: "La forma de error de autenticación es: { ok: false, http_status, issue?, error? }. Nunca un paciente sintético." Good.

Now provide the table for env variables. Let's craft.

Need translate "default launcher R4" -> "lanzador R4 por defecto". "Reject anything else" -> "rechaza cualquier otro valor". "Writes stay off in v1" -> "las escrituras permanecen desactivadas en v1". "Append-only JSONL; set ./audit/audit.jsonl locally" -> "JSONL solo añadir; define ./audit/audit.jsonl". "Bearer only" -> "Solo bearer". "Reserved if an EHR wants JWKS" -> "Reservado si un EHR quiere JWKS". "five system/*.rs types" -> "cinco tipos system/*.rs". "JWT mode override" -> "anulación (override) en modo JWT". "Reserved for future App Launch" -> "Reservado para App Launch futuro".

Important to preserve backslash in FHIR\_SCOPE default: "five system/*.rs" maybe original says "five system/*.rs" in code? Actually in the prompt table row is | FHIR\_SCOPE | " ..." Let's check the source:

"FHIR_SCOPE | -five system/*.rs types". There is backslash asterisk. We can reproduce as cinco system/\*.rs types with backslash. Let's do exactly: "Cinco system/*.rs". In a Markdown table, backslash can escape the asterisk? Actually inside table, backslash can affect. To faithfully preserve, use system/*.rs? Hmm. The original "system/*.rs" is likely a Markdown escape sequence to render *.rs as literal. To reproduce, keep system/\*.rs. We'll write "cinco tipos system/*.rs" in the table cell. Good.

Now after table: "The audit lines": "Línies de auditoría: ts, tool, iss, mode, resourceType, id?, hcia, settlement? No resource body..." Let's craft:

"Líneas de auditoría: ts, tool, istory, emission, resourceType, id?, http_status, entry confirm. No resource body, or token o PEM or name/MRN values." We'll make precise: "ts, tool, iss, mode, resourceType, id?, http_status, entry_count?. No body, no token, no PEM, no query values for nombre/MRN." Good.

Then limits section:

Límites

• R5 / R4B como predeterminado. Mapeo de tipos de recursos adicionales. CRUD. Bulk. App Launch en navegador/PKCE.

• Real EHR / real PHI. Despliegue en producción. Public bind o Streamable HTTP.

• momentum / fhirhydrant / Atrium / Pine / Medplum.

• No es un productomédico. No diagnostica, no trata, no almacena PHI.

Need maybe "muelle" not.

Now output whole final.

Let's ensure placeholders with nested no code fence. Final answer no code fence.

Double-check: The input title line "# smart-fhir" remains exactly. The "A connector that will not invent a patient." translated. The text under title.

Potential issue: "An empty search stays empty" image alt attribute "smart-fhir: smart_discover OK, empty Patient search stays empty, unknown id is 404" was not translated because attribute. Keep.

Should we translate "stdio" in "stdio only"? It's a product name. Keep.

Should translate "smart-fhir" not sentence? OK.

Let's produce the answer

smart-fhir

Un conector que no inventará un paciente.

Instalación · Herramientas · Cómo funciona · Límites

Instalación

Solo stdio. Después de la compilación de TypeScript, añade un conector local:

name: smart-fhir
command: node
args: dist/index.js

Habilita en la configuración:

npm install
npm run build

Variables de entorno para ello (valores por defecto, no secretos):

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

No pongas valores secretos en el repositorio. Sin puerto HTTP público. No hagas vinculación TCP.

Atajo matutino (mismo entorno)

npx -y tsx src/index.ts

Consulta los scripts de package.json: install, build, test, prove.

Herramientas

Cuatro herramientas. Sin create / update / delete.

Lista permitida de resourceType:Patient | Observation | Condition | MedicationRequest | Encounter. Cualquier otra cosa → { ok: false, error: "resourceType not in v2 allowlist" }.

Cómo funciona

FHIR_VERSION debe ser R4. Cualquier otro valor rechaza su inicio.

Lista permitida de ISS (se elimina el barra final; cualquier otra cosa es rechazada):

• https://launch.smarthealthit.org/v/r4/fhir (por defecto)

• https://r4.smarthealthit.org

• https://hapi.fhir.org/baseR4

Para apuntar a otro ISS, define FHIR_ISS con una base permitida. Un ISS nuevo requiere una revisión previa. No apuntes esto a un EHR en uso real sin esa revisión ni un client_id real.

App Launch (code+PKCE) está fuera. FHIR_REDIRECT_URI queda reservada y sin uso.

Errores de autenticación de la forma: { ok: false, http_status, issue?, error? }. Nunca un paciente sintético.

FHIR_WRITE por defecto off; v1 no tiene herramientas de escritura aunque alguien ponga on. Las escenas nunca envían POST AuditEvent a FHIR.

Let's start again for env table:

| Nombre | Por defecto | Notas | | FHIR_ISS | lanzador R4 por pror defecto | Debe seguir en la list a consciously | | FHIR_VERSION | R4 | Reecha donde rechla her value | | FHIR_AU_MOde | open | open / bearer / hmmte" | | FHIR_MUTIL | off | Escenas off en v1 | | FHIR_AUDITPATH | spawn {}"JSONL; set... | | FHIR_ACCES_TTOKEN | undefin | Open_Bearer | | FHIR_CLIENT_ID | un | Backend services | | SMART_CIENT_ID | un | alias ... etc

Let's output precisely.

Need avoid errors. Let's write:

Great.

Then paragraph "Líneas de atz" etc.

Now ensure "FHIR audits" etc.

Need ensure final is complete and correct.

Let's produce final now

smart-fhir

Un conector que no inventará un paciente.

Un conector que no inventará un paciente.

Aplica:

Un conector que no inventará un paciente.

Instalación

Solo stdio. Después de la compilación del TypeScript, agrega un conector local:

name: smart-fhir
command: node
args: dist/index.js

npm install
npm run build

Variables de entorno para eso (valores por defecto, no secretos):

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

No ponga valores secretos en el repositorio. Sin puerto HTTP público. No manejar TCP.

Inicio rápido (mismo entorno)

npx -y tsx src/index.ts

Consultas los scripts de package.json: install, build, test, prove.

Herramientas

Cuatro herramientas. No hay crear / actualizar / borrar.

Lista de resourceType: Client, Observation, Condition, MedicationRequest, Encounter. Cualquier otra cosa → { ok: false, error: "resourceType not in v1 allowlist" }.

Cómo funciona

FHIR_VERSION debe ser R4. Cualquier otra cosa rechaza el inicio.

Lista permitida de iss (se quita barra final, todo lo demás se rechaza):

• https://launch.smarthealthit.org/v/r4/fhir (configuración)

• https://r4.smarthealthit.org

• https://hapi.fhir.org/baseR4

Para redirigir a otro is: set FHIR_ISS a base permitida. Si un nuevo issa necesita revisión previa, no uses eso para un servidor real sin ese review más un client_id real.

| | Modalopen | Definir Miden | | take; | Comportamiento | | open (por defecto) | Descubre, luego GET FHIR sin Authorization. Un 404 en todo no es fatal; se registra y continúa. Un 401/403 FHIR → { ok:false,http_status, ... }. | | bearer | Mismo descubrimiento. GET FHIR con token Authorization Bearer. | | backend_jwt | Solo si existen FHIR_CLIENT_ID (o SMART_CLIENT_ID) y FHIR_PRIVATE_PEMKEY_PEM. SMART Backend Services JWT. Falta la variable → no arranca. No se inventan credenciales. |

App Launch (code+PKCE) está fuera. FHIR_REDIRECT_URI está reservada, sin uso.

El fallo de autenticación es: { ok: false, http_status, issue?, error? }. Nunca un paciente sintético.

FHIR_WRITE por defecto está off. v1 no tiene herramientas de escritura, although alguien ponga on. Escrituras nunca hacen POST AuditEvent a FHIRr.

Líneas de auditoría: ts, tool, iss, mode, resourceType, id?, entry_count?. No hay cuerpo de recurso ni token ni PEM ni valores de la consulta name/MRN.

Límites

• FHIR R5 / R4B como defecto; tipos de recurso extra. CRUD. Bulk. App Launch en navegador/PKCE.

• No se soporta EHR real / HIG, implementación en producción, bind público o Streamable HTTP.

• no asociados: momentum / fhirroolit / Atrium / Pinecone / Medplum.

• No es un dispositivo médico. No se usar en diagnóstico ni tratamiento; no almacena PHI.

No Contiene PHI. No para EMR reales.

smart-fhir

Un conector que no inventará un paciente.

Un conector que no inventará un paciente.

Instalación

Solo para stdio. Después de compilar TypeScript, agrega un conector local:

name: smart-fhir
command: node
args: dist/index.js

npm install
npm run build

Variables de entorno para eso (valores por defecto, no secretos):

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

No pongas valores secretos en el repositorio. No hagas HTTP público. No enlaces con puerto TCP.

Atajo matutino (mismo entorno)

npx -y tsx src/index.ts

Ver en los scripts de package.json: install, build, test, prove.

Herramientas

Cuatro herramientas. Sin operaciones de creación, actualización o eliminación.

Lista autorizada de resourceType: Patient, Observation, Condition, MedicationRequest, Encounter. Cualquier otra cosa → { ok: false, error: "resourceType not in v1 allowlist" }.

Cómo funciona

FHIR_VERSION debe ser R4. Cualquier otro valor rechazará el arranque.

Categoría de iss permitida (se elimina la barra final; otra cosa se rechaza):

• https://launch.smarhealthit.org/v/r4/fhir (predeterminado)

• https://r4.smarthealthit.org

• https://hapi.fhir.org/baseR4

Para apuntar a otro iss, define FHIR_ISS con una base permitida. Requiere revisión previa. No lo apuntes a un EHR real sin esa revisión además de un client_id real.

App Launch (code+PKCE) queda fuera de v1. FHIR_REDIC anda reservada y sin uso.

Error de autorización: { ok:false, http_status, issue?, error? } . Nunca devuelve un paciente sintético.

FHIR_WRITE* entdemo ofrece “no”. En v1 no hay herramientas de escritura, aunque alguien pida on. Ninguna escritura enviará ningún POST AuditEvent a FHIR.

Línes de auditor: ts, tool, iss, mode, resourceType, id?, http_status, body?. No imprime cuerpo, ni token, tampoco claves secretas. No muestra nombre/MRN.

Límites

• FHIR R4.4*R5 como R4 false.

• Implementación para servidores; sin publicar. *No para médicos, no Almacuna información PHI..

• ...