# Conectar un cliente

> Configuración lista para copiar de Claude, Codex, Gemini CLI, GitHub Copilot y cualquier otro cliente MCP.

La tarjeta **Conectar un cliente** le guía por cada cliente admitido con fragmentos listos para copiar que ya llevan el puerto que usted configuró (los ejemplos de abajo usan el de fábrica, 18181). Todos los clientes locales se conectan directamente al endpoint, sin túnel.

## Claude {#claude}

Claude Chat (aplicación de escritorio) y Claude Code (CLI o aplicación de escritorio) se configuran por separado; conectar uno no conecta el otro.

- **Claude Chat (aplicación de escritorio)**: la vía más sencilla. El **paquete MCP (`.mcpb`)** de un clic viene con la aplicación: pulse **Instalar en Claude Desktop** (o **Guardar como…** para conservar el archivo) y confirme el diálogo de instalación en Claude Desktop. El paquete lleva un pequeño puente local que va del transporte stdio de Claude al endpoint HTTP de esta estación; el runtime de Node que necesita viene con Claude Desktop. Si cambió el puerto, ponga en el diálogo de instalación el endpoint que corresponda.
- **Claude Code (CLI o aplicación de escritorio)**: un solo comando de terminal:

```
claude mcp add --transport http ganterlab http://127.0.0.1:18181/mcp
```

## Codex (CLI / IDE) {#codex-cli--ide}

Codex se conecta directamente al endpoint loopback como servidor Streamable HTTP. Su comando `codex mcp add` solo cubre servidores stdio, así que la forma HTTP va en `~/.codex/config.toml`:

```
[mcp_servers.ganterlab]
url = "http://127.0.0.1:18181/mcp"
```

## Gemini CLI {#gemini-cli}

La CLI de Gemini se conecta con su tipo de servidor `httpUrl` en `~/.gemini/settings.json`. (El chat web de Gemini no tiene ninguna vía local sin túnel, así que solo se ofrece la CLI.)

```
{
  "mcpServers": {
    "ganterlab": {
      "httpUrl": "http://127.0.0.1:18181/mcp"
    }
  }
}
```

## GitHub Copilot {#github-copilot}

Dos vías, con dos claves de primer nivel distintas:

- **VS Code**: añada el servidor a `.vscode/mcp.json` (o ejecute "MCP: Open User Configuration" desde la paleta de comandos) y luego habilítelo en el selector de herramientas de Copilot Chat:

```
{
  "servers": {
    "ganterlab": {
      "type": "http",
      "url": "http://127.0.0.1:18181/mcp"
    }
  }
}
```

- **CLI**: la misma forma de servidor bajo `mcpServers` en `~/.copilot/mcp-config.json` (o ejecute `/mcp add` dentro de la CLI y elija el tipo de servidor HTTP).

## Los clientes encaminados por la nube no se admiten {#cloud-routed-clients-are-not-supported}

Los conectores de ChatGPT, el chat web de Gemini y cualquier otra cosa que alcance la estación desde internet no pueden usar este endpoint, y la página no ofrece ninguna configuración para ellos. El endpoint rechaza toda petición cuya cabecera `Host` no sea local, antes del apretón de manos de la sesión, así que un túnel no ayuda: un túnel reenvía su propio host público, que es exactamente lo que se rechaza. La estación no se publica en la red para los agentes, y no hay ningún interruptor que la publique.

## Cualquier otro cliente MCP {#any-other-mcp-client}

Cualquier cliente que se ejecute en este ordenador y acepte la URL de un servidor MCP por HTTP puede usar la estación: apúntelo al endpoint que muestra la página.