> ## 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.

# Instalación

> Wizard interactivo y configuración manual para el MCP connector.

## Wizard interactivo

```bash theme={null}
npx -y @fhiron/mcp-connector init
```

El wizard detecta el editor (Claude Desktop, Claude Code, Cursor, Continue.dev, Windsurf, Gemini Code Assist, Grok-Studio, JetBrains AI, ChatGPT con MCP connector), escribe la configuración con merge no destructivo (preserva otros `mcpServers` existentes) y verifica el handshake con el servidor. Desde v0.7.0 el servidor también entrega `instructions` con el operating contract del agente. Ver [Skill CL Core](/mcp/skill-cl-core#cómo-se-activa).

<Tip>
  Obtén una API key en [fhiron.cl/registro](https://fhiron.cl/registro). El plan Free incluye 100 validaciones por mes. Las tools offline no consumen cuota.
</Tip>

## Configuración manual por IDE

<Tabs>
  <Tab title="Claude Desktop">
    Archivo: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)

    ```json theme={null}
    {
      "mcpServers": {
        "fhiron": {
          "command": "npx",
          "args": ["-y", "@fhiron/mcp-connector", "--key", "TU_API_KEY"]
        }
      }
    }
    ```

    Reinicia Claude Desktop completamente (no basta con cerrar la ventana).
  </Tab>

  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add fhiron \
      -- npx -y @fhiron/mcp-connector --key TU_API_KEY
    ```

    O manual en `~/.claude.json` siguiendo el formato estándar MCP.
  </Tab>

  <Tab title="Cursor">
    Global: `~/.cursor/mcp.json`
    Por proyecto: `<repo>/.cursor/mcp.json`

    ```json theme={null}
    {
      "mcpServers": {
        "fhiron": {
          "command": "npx",
          "args": ["-y", "@fhiron/mcp-connector", "--key", "TU_API_KEY"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="Windsurf">
    Archivo: `~/.codeium/windsurf/mcp_config.json`

    ```json theme={null}
    {
      "mcpServers": {
        "fhiron": {
          "command": "npx",
          "args": ["-y", "@fhiron/mcp-connector", "--key", "TU_API_KEY"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="Antigravity">
    Archivo: `<repo>/.antigravity/mcp.json`

    ```json theme={null}
    {
      "mcpServers": {
        "fhiron": {
          "command": "npx",
          "args": ["-y", "@fhiron/mcp-connector", "--key", "TU_API_KEY"]
        }
      }
    }
    ```
  </Tab>
</Tabs>

## Modo bilingüe

```bash theme={null}
# 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
```

<Note>
  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.
</Note>

## Verificar la instalación

```bash theme={null}
# 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 10 tools declaradas (`fhiron_validate_file` lee `.json` por path, read-only, máx 5 MB).
* `init` hace merge no destructivo sobre la configuración existente.