# Collegare un client

> Configurazione pronta da copiare per Claude, Codex, Gemini CLI, GitHub Copilot e qualunque altro client MCP.

La scheda **Collega un client** guida attraverso ogni client supportato con frammenti
pronti da copiare che portano già la porta configurata (gli esempi qui sotto usano quella
predefinita, 18181). Tutti i client locali si collegano direttamente all'endpoint, senza
tunnel.

## Claude {#claude}

Claude Chat (Desktop App) e Claude Code (CLI/Desktop App) hanno configurazioni distinte:
collegare l'uno non collega l'altro.

- **Claude Chat (Desktop App)**, il percorso più semplice. Il **pacchetto MCP (`.mcpb`)** a
  un clic viene fornito con l'applicazione: si preme **Installa in Claude Desktop** (oppure
  **Salva con nome…** per conservare il file) e si conferma la finestra di installazione in
  Claude Desktop. Il pacchetto porta un piccolo ponte locale dal trasporto stdio di Claude
  all'endpoint HTTP di questa stazione; il runtime Node che gli serve arriva con Claude
  Desktop. Se la porta è stata cambiata, si imposta l'endpoint nella finestra di installazione in
  modo che corrisponda.
- **Claude Code (CLI/Desktop App)**, un solo comando da terminale:

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

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

Codex si collega direttamente all'endpoint di loopback come server Streamable HTTP. Il suo
comando `codex mcp add` copre solo i server stdio, quindi la forma HTTP va in
`~/.codex/config.toml`:

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

## Gemini CLI {#gemini-cli}

La Gemini CLI si collega con il tipo di server `httpUrl` in `~/.gemini/settings.json`. (La
chat web di Gemini non ha un percorso locale senza tunnel, quindi si offre solo la CLI.)

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

## GitHub Copilot {#github-copilot}

Due strade, con due chiavi di primo livello diverse:

- **VS Code**: si aggiunge il server a `.vscode/mcp.json` (oppure si esegue "MCP: Open User
  Configuration" dalla tavolozza dei comandi), poi lo si abilita nel selettore di strumenti di
  Copilot Chat:

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

- **CLI**: la stessa forma di server sotto `mcpServers` in `~/.copilot/mcp-config.json`
  (oppure si esegue `/mcp add` dentro la CLI e si sceglie il tipo di server HTTP).

## I client instradati dal cloud non sono supportati {#cloud-routed-clients-are-not-supported}

I connettori di ChatGPT, la chat web di Gemini e qualunque altro strumento che raggiunga la
stazione da internet non possono usare questo endpoint, e la pagina non offre alcuna
configurazione per loro. L'endpoint rifiuta ogni richiesta la cui intestazione `Host` non
sia locale, prima dell'accordo di sessione, quindi un tunnel non aiuta: un tunnel inoltra il
proprio host pubblico, che è esattamente ciò che viene rifiutato. La stazione non viene
pubblicata in rete per gli agenti, e non esiste alcun interruttore che lo consenta.

## Qualsiasi altro client MCP {#any-other-mcp-client}

Qualunque client che giri su questo computer e accetti l'URL di un server MCP HTTP può usare
la stazione: basta puntarlo all'endpoint mostrato nella pagina.