Skip to main content

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.

Wizard interactivo

npx -y @fhiron/mcp-connector init
El wizard detecta el editor (Claude Desktop, Cursor, Antigravity, Windsurf, Claude Code), escribe la configuración con merge no destructivo (preserva otros mcpServers existentes) y verifica el handshake con el servidor.
Obtén una API key en fhiron.cl/registro. El plan Free incluye 100 validaciones por mes. Las tools offline no consumen cuota.

Configuración manual por IDE

Archivo: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
{
  "mcpServers": {
    "fhiron": {
      "command": "npx",
      "args": ["-y", "@fhiron/mcp-connector", "--key", "TU_API_KEY"]
    }
  }
}
Reinicia Claude Desktop completamente (no basta con cerrar la ventana).

Modo bilingüe

# Por defecto: español
npx -y @fhiron/mcp-connector --key K

# Inglés
npx -y @fhiron/mcp-connector --key K --lang en

# Vía variable de entorno
FHIRON_LANG=en npx -y @fhiron/mcp-connector --key K
El idioma afecta las descripciones de tools, los summary de respuesta y los errores de red. Los mensajes pedagógicos de las reglas CL Core (why, suggestion) se mantienen en español, ya que son específicos del IG chileno.

Verificar la instalación

# Versión instalada
npx -y @fhiron/mcp-connector --version

# MCP Inspector oficial (debug)
FHIRON_API_KEY=tu_key npx -y @modelcontextprotocol/inspector \
  npx -y @fhiron/mcp-connector

Seguridad

  • La API key se pasa como argumento o como variable de entorno FHIRON_API_KEY. El conector no la persiste en disco. La excepción es el wizard init, que la escribe en el archivo de configuración del editor.
  • El tráfico va por HTTPS a https://fhiron.cl/api/validate con header X-API-Key.
  • El conector no expone filesystem ni shell. Solo las 7 tools declaradas.
  • init hace merge no destructivo sobre la configuración existente.