> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fhiron.cl/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP connector

> Conector npm que expone Inspect a editores con soporte Model Context Protocol.

`@fhiron/mcp-connector` expone la validación FHIR® de Inspect al editor vía [Model Context Protocol](https://modelcontextprotocol.io). El agente puede validar recursos contra **CL Core v1.9.4**, consultar catálogos chilenos (DEIS · TFC · CIE-10) y aplicar `quickFix` sin salir del editor.

[![npm](https://img.shields.io/npm/v/@fhiron/mcp-connector.svg)](https://www.npmjs.com/package/@fhiron/mcp-connector)
[![MCP](https://img.shields.io/badge/MCP-2025--03--26-purple.svg)](https://modelcontextprotocol.io)
[![CL Core](https://img.shields.io/badge/CL%20Core-v1.9.4-blue.svg)](https://hl7chile.cl/fhir/ig/clcore/)

## Capacidades

<CardGroup cols={2}>
  <Card title="10 herramientas fhiron_*" icon="wrench" href="/mcp/tools">
    Agrupadas en Validar, Explorar y Reparar. El comportamiento del agente lo gobierna la [skill CL Core](/mcp/skill-cl-core) embebida.
  </Card>

  <Card title="Resources MCP" icon="folder-tree" href="/mcp/resources-prompts">
    Catálogos chilenos, ejemplos CL Core y mini-docs como recursos consultables.
  </Card>

  <Card title="Reglas locales" icon="ruler" href="/mcp/reglas-locales">
    35+ reglas `cl-*` para los 13 recursos más usados. Corren offline, sin cuota.
  </Card>

  <Card title="Modo bilingüe" icon="language" href="/mcp/instalacion#modo-bilingüe">
    Español por defecto. Inglés vía `--lang en`.
  </Card>
</CardGroup>

## Flujo

```mermaid theme={null}
sequenceDiagram
    autonumber
    participant Dev as Developer
    participant Agente as Agente IA
    participant MCP as @fhiron/mcp-connector
    participant Motor as Motor de validación

    Dev->>Agente: "Arma una MedicationRequest para paracetamol 500 mg cada 8 h"
    activate Agente

    Note over Agente,MCP: Tools offline · sin cuota
    Agente->>MCP: fhiron_search_terminology<br/>("tfc", "paracetamol 500 mg comprimido")
    MCP-->>Agente: TFC 005749 + ATC N02BE01

    Agente->>MCP: fhiron_get_example<br/>("MedicationRequest")
    MCP-->>Agente: scaffold CL Core

    Agente->>MCP: fhiron_lint(borrador)
    MCP-->>Agente: cl-medreq-02 (falta intent) + quickFix

    Agente->>MCP: fhiron_apply_fix<br/>(/intent → "order")
    MCP-->>Agente: MedicationRequest corregido

    Note over Agente,Motor: Validación completa · 1 crédito
    Agente->>MCP: fhiron_validate(MedicationRequest)
    MCP->>Motor: HTTPS · CL Core v1.9.4
    activate Motor
    Motor-->>MCP: OperationOutcome (válido)
    deactivate Motor
    MCP-->>Agente: ✓ válido contra MedicationRequest + binding ATC

    Agente->>Dev: Receta generada y validada
    deactivate Agente
```

El agente compone el recurso. La validación contra CL Core la decide el motor, no el modelo. Las tools offline (`fhiron_lint`, `fhiron_apply_fix`, `fhiron_get_example`, `fhiron_search_terminology`, `fhiron_explain_code`, `fhiron_score_endpoint`) no consumen cuota: corren dentro del connector. `fhiron_validate`, `fhiron_validate_file`, `fhiron_validate_bundle` y `fhiron_compare_profiles` llaman al motor.

## Compatibilidad

* **Spec MCP:** `2025-03-26` con annotations. Negocia con clientes en `2024-11-05`.
* **Capabilities:** `tools`, `resources`, `prompts`, `logging`.
* **Instructions field:** desde v0.7.0 el servidor entrega operating contract bilingüe en `initialize`. Ver [Skill CL Core](/mcp/skill-cl-core).
* **Clientes verificados:** Claude Code, Claude Desktop, Cursor, Continue.dev, Windsurf, Gemini Code Assist, Grok-Studio, JetBrains AI, ChatGPT con MCP connector.
* **Runtime:** Node.js ≥ 18. Zero dependencies en runtime.

## Otros canales

El MCP es uno de tres canales hermanos sobre el mismo motor — elige según dónde estés parado:

<CardGroup cols={3}>
  <Card title="MCP" icon="brain" href="/mcp/overview">
    Conversación dentro del agente (Claude Code, Cursor, Continue.dev, Gemini, Grok, JetBrains).
  </Card>

  <Card title="CLI" icon="terminal" href="/cli/overview">
    Automatización en CI, pre-commit hooks, sanity checks en terminal.
  </Card>

  <Card title="API REST" icon="code" href="/inspect/api">
    Integración programática desde tu backend (Node, Python, Go).
  </Card>
</CardGroup>

Misma API, misma cuota, mismo CL Core.

## Siguiente

<CardGroup cols={2}>
  <Card title="Instalación" icon="rocket" href="/mcp/instalacion">
    Wizard `init` y configuración manual por editor.
  </Card>

  <Card title="Tools" icon="list" href="/mcp/tools">
    Las 10 herramientas agrupadas en Validar / Explorar / Reparar.
  </Card>
</CardGroup>