Skip to main content
Fhiron expone su motor de validación a través de tres canales hermanos, no de canales en competencia:
SurfaceCuándo usarloPaquete
MCPConversación y razonamiento dentro de un agente (Claude Code, Cursor, Continue.dev, Gemini Code Assist, Grok-Studio, JetBrains AI).@fhiron/mcp-connector
CLIAutomatización en CI/CD, pre-commit hooks, sanity checks en terminal, headless servers donde no hay agente.@fhiron/cli
SDKValidación embebida en el runtime de tu aplicación (Node/TypeScript), en el camino crítico antes de persistir o reenviar.@fhiron/sdk
API RESTIntegración programática directa desde cualquier lenguaje (Python, Go, lo que sea).https://fhiron.cl/api/validate
Los tres consumen la misma API, descuentan la misma cuota del tenant y usan el mismo motor (CL Core v1.9.4 + perfiles MINSAL). La elección depende de dónde estás parado cuando necesitas validar, no de qué tipo de developer eres.

Qué hace el CLI

fhiron init      # crea fhiron.config.json en tu proyecto
fhiron login     # autentica vía device-code (browser)
fhiron lint      # linter local, sin red, sin cuota
fhiron validate  # valida contra el servidor de Fhiron (descuenta cuota)
fhiron status    # plan, cuota usada, FHIR Score
Cinco comandos. Zero dependencies de runtime (el linter de CL Core viene embebido). Mismo motor que el MCP connector.

Caso de uso típico — gate de merge

El cliente abre un PR que toca recursos FHIR. GitHub corre 4 líneas de YAML que llaman al CLI. Si los recursos rompen CL Core 1.9.4, el check queda rojo y el merge se bloquea. Sin Postman, sin curl manual, sin reviews humanos buscando errores de namespace.
- run: npx @fhiron/cli lint  "fhir/**/*.json"
- run: npx @fhiron/cli validate "fhir/**/*.json"
  env:
    FHIRON_API_KEY: ${{ secrets.FHIRON_API_KEY }}
Ver Validate para más casos.

Próximo paso

Empieza por la instalación — toma menos de un minuto.