El motor bajo tu IA
El LLM propone. El motor entrega el veredicto.
Toda IA que escribe FHIR® es probabilística por diseño. El cumplimiento no puede serlo. Conecta tu agente vía Model Context Protocol y deja que un motor determinístico —no el LLM— dicte si tu recurso cumple CL Core: mismo recurso, misma versión del IG, mismo OperationOutcome. El veredicto reproducible que la Ley 21.719 te va a exigir, sobre la capa en la que se construye FHIR en Chile.
La validación no la decide el LLM.
01
Reproducible contra una versión publicada
El motor carga la versión exacta de hl7.fhir.cl.clcore publicada por HL7® Chile. Una validación de hoy es reproducible mañana — un LLM no lo garantiza.
02
Auditable bajo Ley 21.719
Cada OperationOutcome queda atado a perfil, ruta FHIRPath y versión del IG. Listo para presentar como evidencia técnica frente al MINSAL o a la futura Agencia de Protección de Datos Personales.
03
Terminología desde fuentes oficiales
Los códigos provienen de los CodeSystems oficiales cargados en Fhiron: TFC, DEIS, comunas del decreto 817, SNOMED CT Edición Español y v3-ActCode. El LLM no propone códigos que no estén publicados.
Cómo se conecta.
- 01
Instala el conector
Ejecuta `npx @fhiron/mcp-connector init` en tu proyecto. El instalador detecta automáticamente Claude Code, Cursor o cualquier cliente MCP estándar y registra la configuración.
- 02
Conecta tu API key de Fhiron
Pega tu API key (`fhrn_...`) en la variable de entorno `FHIRON_API_KEY`. Cada validación contra el motor consume del cupo mensual de tu plan; el linter local no consume cuota.
- 03
Deja que el agente trabaje
Pídele a tu agente de IA que genere un recurso FHIR. Cuando llama a `fhir.validate`, el motor Fhiron responde con un OperationOutcome determinístico contra CL Core. El agente lo lee y corrige hasta que el recurso es válido.
Instalación.
# instala y registra el conector con tu cliente MCP npx @fhiron/mcp-connector init # expón tu API key (gratis con plan Free, 100 validaciones / mes) export FHIRON_API_KEY="fhrn_..." # probar contra el motor npx @fhiron/mcp-connector ping
Compatible con Claude Code, Cursor, Continue y cualquier cliente MCP estándar. Más detalle en docs.fhiron.cl/mcp/instalacion.
Herramientas del conector.
El cliente MCP las descubre automáticamente. Las que corren localmente no consumen del cupo mensual de validaciones.
fhir.validateValida un recurso FHIR contra los perfiles CL Core. Devuelve un OperationOutcome con errores en español, severity y ruta FHIRPath del campo que falla.
fhir.terminology.searchBusca códigos en los CodeSystems oficiales cargados en Fhiron: TFC, DEIS, comunas del decreto 817, SNOMED CT Edición Español, v3-ActCode y otros. Sin alucinaciones — solo terminología publicada.
fhir.quick-fixSugiere correcciones automáticas para errores comunes: meta.profile faltante, bindings de terminología incorrectos, cardinalidades, expresiones FHIRPath.
fhir.examplesRecetas listas para CL Core: Encounter ambulatorio con v3-ActCode, MedicationRequest con TFC/ATC, DiagnosticReport con LOINC, Coverage Fonasa con previsión EIS.
fhir.lintLintea archivos FHIR (JSON/XML) en tu editor antes de hacer commit. Cero llamadas a la API mientras el linter corre local — solo consume cuota cuando ejecutas validate.
fhir.profile-lookupDevuelve la StructureDefinition de cualquier perfil CL Core publicado por HL7® Chile, con cardinalidades, slicing y bindings completos.
Preguntas frecuentes.
¿Por qué validar con un motor determinístico y no con el LLM?
Un LLM puede proponer un recurso FHIR plausible, pero no es la fuente de verdad de los perfiles CL Core. Bajo la Ley 21.719 sobre Protección de Datos Personales (vigente desde diciembre de 2026), las decisiones automatizadas sobre datos clínicos deben ser auditables y trazables. Fhiron separa propuesta (LLM) de validación (motor determinístico), de modo que cada decisión queda registrada contra una versión específica de CL Core publicada por HL7® Chile.
¿Con qué clientes MCP funciona?
Con cualquier cliente que implemente la especificación Model Context Protocol: Claude Code, Cursor, Continue, IDEs y agentes propios. El conector se publica como `@fhiron/mcp-connector` en npm y expone los tools estándar listados en docs.fhiron.cl/mcp/tools.
¿Las herramientas del MCP consumen mi cupo de validaciones?
Solo `fhir.validate` consume del cupo mensual de tu plan, porque ejecuta el motor contra el servidor de Fhiron. El linter, las búsquedas de terminología, los ejemplos y los quick-fix corren local y no descuentan cuota.
¿Mis datos clínicos salen de mi entorno cuando uso el MCP?
Cuando llamas a `fhir.validate`, el recurso se envía al motor Fhiron, se valida contra CL Core y se descarta. No queda almacenado. Solo guardamos metadatos técnicos (timestamp, perfil, resultado agregado). Los datos clínicos reales nunca se persisten — es la arquitectura stateless gateway descrita en docs.fhiron.cl/conceptos/stateless-gateway.
¿Cómo se versiona CL Core en el motor?
El motor Fhiron carga la versión de `hl7.fhir.cl.clcore` publicada oficialmente en hl7chile.cl. Cada release del paquete queda etiquetado en los logs de validación, de modo que un OperationOutcome de hoy es reproducible mañana contra la misma versión exacta del IG.
¿Puedo usar el MCP sin agente de IA, solo desde mi editor?
Sí. El linter funciona standalone: detecta errores CL Core en archivos `.json` y `.xml` mientras escribes, igual que un linter de TypeScript. El agente de IA es opcional — el conector está pensado para builders, no solo para flujos con LLM.
Empieza con 100 validaciones gratis.
Sin tarjeta de crédito. El conector MCP funciona con el plan Free — el cupo se comparte con Bridge.
Marcas registradas
FHIR® es marca registrada de Health Level Seven International (HL7®). El uso de la marca FHIR® en esta página y en la plataforma Fhiron no constituye respaldo (endorsement) por parte de HL7®. Model Context Protocol es una especificación abierta publicada por Anthropic.