Skip to main content

​
1. Obtener una API key

Crea una cuenta en fhiron.cl/registro. El plan Free incluye 100 validaciones por mes. Las herramientas del MCP que corren offline no consumen cuota.

​
2. Validar un recurso

El ejemplo de abajo envía un Encounter que el desarrollador armó copiando un payload de un EHR en inglés: usó "status": "complete" (intuición de inglés general) en vez del código del ValueSet EncounterStatus que exige FHIR R4. Es uno de los errores más frecuentes al migrar un HIS hacia FHIR. 
curl -X POST https://fhiron.cl/api/validate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: TU_API_KEY" \
  -d '{
    "resourceType": "Encounter",
    "status": "complete",
    "class": {
      "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
      "code": "AMB"
    },
    "subject": { "reference": "Patient/example" },
    "period": { "start": "2026-05-11T09:00:00-04:00" }
  }'
La respuesta es un OperationOutcome con el issue cl-enc-04: 
{
  "resourceType": "OperationOutcome",
  "issue": [{
    "severity": "error",
    "code": "invalid",
    "details": {
      "text": "Encounter.status='complete' no pertenece al ValueSet EncounterStatus (binding required). Códigos válidos: planned · arrived · triaged · in-progress · onleave · finished · cancelled · entered-in-error · unknown."
    },
    "expression": ["Encounter.status"],
    "diagnostics": "{\"code\":\"cl-enc-04\",\"why\":\"Binding required al ValueSet http://hl7.org/fhir/ValueSet/encounter-status — no admite códigos custom.\",\"quickFix\":{\"jsonPointer\":\"/status\",\"replacement\":\"finished\"}}"
  }]
}
El diagnostics.quickFix lleva un parche RFC 6901 que fhiron_apply_fix o tu código pueden aplicar de forma idempotente.

​
3. Conectar el MCP al editor

npx -y @fhiron/mcp-connector init
El comando detecta el editor (Claude Desktop, Claude Code, Cursor, Windsurf, Antigravity), escribe la configuración con merge no destructivo y verifica el handshake. Más detalle en MCP: Instalación.

​
Siguiente

API reference

Endpoint, headers, rate limits.

Tools fhiron_*

Validación, lint, quickFix, búsqueda en catálogos.

Errores

Códigos cl-* con why, profileUrl y quickFix.

CL Core v1.9.4

Recursos cubiertos del IG.