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

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

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

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

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.