Collegare un client

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

La scheda Collega un client ti 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: premi Installa in Claude Desktop (oppure Salva con nome... per conservare il file) e 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 hai cambiato la porta, 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: aggiungi il server a .vscode/mcp.json (oppure esegui "MCP: Open User Configuration" dalla tavolozza dei comandi), poi abilitalo 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 esegui /mcp add dentro la CLI e scegli 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.

Qualunque altro client MCP

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