Skip to main content

​
Qué es

El MCP no solo expone tools y resources, también entrega comportamiento al agente. Desde initialize, el servidor devuelve un campo instructions (spec MCP 2024-11-05) con el operating contract que el cliente inyecta como system-level guidance del LLM. Adicionalmente, expone 17 recursos descubribles bajo el URI agent-skill://fhiron-cl/... con el detalle profundo: playbooks por intent, referencia canónica de perfiles, catálogo de códigos de error y ejemplos reproducibles end-to-end. Todo viene de fábrica al conectar el MCP. No requiere copiar archivos al filesystem ni instalar plugins extra. Funciona idéntico en cualquier cliente MCP-compatible.

​
Por qué importa

Los LLM tienden a equivocarse de tool. Sin guidance, suelen llamar fhiron_validate (1 crédito) cuando fhiron_lint (gratis) habría detectado el problema. O presentan errores en formato libre, sin citar el perfil que falla. O inventan terminología cuando el catálogo no tiene match. La skill cierra ese hueco: el LLM arranca sabiendo qué tool usar para qué intent, cómo presentar issues, cuándo aplicar quickFix automático, y cuál es la política de canonical-only. La diferencia se nota desde el primer turn.

​
Cómo se activa

Cualquier cliente MCP-compatible que conecte el servidor lee instructions automáticamente al iniciar la sesión: Para instalar el MCP:
El wizard registra el servidor en el config del cliente y obtiene una API key del plan gratis (1.000 validaciones/mes).

​
Operating contract (5 reglas que rigen al agente)

  1. Canonical-only. Toda URL citada viene de hl7.fhir.cl.clcore, hl7.fhir.r4.core, hl7.terminology.r4 o hl7.fhir.cl.minsal.eis. Si algo no está en estos paquetes, el agente lo dice explícito y no inventa.
  2. Errores en español neutro chileno (tuteo, sin voseo). Los nombres técnicos quedan en inglés. Cada issue cita el StructureDefinition.url que falla.
  3. quickFix antes que explicación. Si el issue trae fix mecánico, el agente propone aplicarlo antes de explicar la causa.
  4. Selección de tools consciente de costos. Tools gratis offline primero; escala a tools de pago solo cuando el resultado offline no alcanza. Antes de cada llamada con costo, anuncia el costo.
  5. Disciplina HL7®/FHIR®. Primera mención por turn con el símbolo registrado; las siguientes sin. Identificadores técnicos nunca lo llevan.

​
Routing por intent

​
Recursos descubribles (resources/list)

El MCP expone 17 documentos bajo agent-skill://fhiron-cl/ que el agente puede leer bajo demanda:

​
Ejemplo de turn

Desarrollador pega:
Agente (con la skill activa):
Detecté un Patient. Corro fhiron_lint primero (offline, gratis). Encontré 3 issues:
  • cl-run-01: identifier[0].value contiene puntos. CL Core CorePacienteCl normaliza el RUN sin puntos: 11111111-1. quickFix disponible.
  • cl-narrative-02: falta text.div. FHIR® R4 dom-6 lo recomienda. quickFix agrega narrativa mínima.
  • cl-patient-04: gender ausente. CorePacienteCl lo recomienda (male · female · other · unknown). quickFix → "unknown"; edítalo si conoces el dato.
¿Aplico los 3 quickFix automáticos (offline, gratis) o prefieres revisarlos uno por uno antes?

​
Capabilities cubiertas

  • 8 perfiles CL Core 1.9.4 (CorePacienteCl, CorePrestadorCl, CoreOrganizacionCl, EncounterCL, CoreDiagnosticoCl, CoreAlergiaIntCl, CoreMedicamentoCl, ImmunizationCL).
  • 6 perfiles MISSING (Procedure, MedicationRequest, Coverage, Observation laboratorio/signos vitales, Composition). La skill aplica recomendaciones sobre R4 base hasta que HL7® Chile los publique.
  • 60+ códigos cl-* documentados con severity, profile, quickFix.
  • Catálogos chilenos: comunas (decreto 817), DEIS, ATC, SNOMED CT, CIE-10, LOINC, CVX, v3-ActCode, CSTipoIdentificador, CSPrevision (MINSAL EIS).

​
Versionado

La skill se versiona junto al MCP. Cada release de @fhiron/mcp-connector lleva la skill embebida actualizada. Los clientes obtienen actualizaciones con npm update.

​
Out of scope

HL7® v2, CDA, DICOM. Composición de recursos (el desarrollador escribe el FHIR®; el MCP valida).