# Conectar um cliente

> Configuração pronta para copiar, para Claude, Codex, Gemini CLI, GitHub Copilot e qualquer outro cliente MCP.

O cartão **Conectar um cliente** te leva por cada cliente suportado, com trechos prontos
para copiar que já carregam a porta que você configurou (os exemplos abaixo usam o padrão,
18181). Todos os clientes locais conectam diretamente ao endpoint, sem túnel.

## Claude {#claude}

O Claude Chat (aplicativo de desktop) e o Claude Code (CLI e aplicativo de desktop) têm configurações separadas;
conectar um não conecta o outro.

- **Claude Chat (aplicativo de desktop)**: o caminho mais simples. O **pacote MCP
  (`.mcpb`)** de um clique vem com a aplicação: pressione **Instalar no Claude Desktop** (ou **Salvar como…**
  para guardar o arquivo) e confirme o diálogo de instalação no Claude Desktop. O pacote carrega
  uma ponte local minúscula do transporte stdio do Claude até o endpoint HTTP desta estação; o
  runtime Node de que ela precisa vem com o Claude Desktop. Se você mudou a porta, ajuste o
  endpoint no diálogo de instalação para acompanhar.
- **Claude Code (CLI e aplicativo de desktop)**: um comando de terminal:

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

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

O Codex conecta diretamente ao endpoint de loopback como servidor Streamable HTTP. O
comando `codex mcp add` dele cobre apenas servidores stdio, então a forma HTTP vai em
`~/.codex/config.toml`:

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

## Gemini CLI {#gemini-cli}

O Gemini CLI conecta pelo tipo de servidor `httpUrl` dele, em `~/.gemini/settings.json`.
(O chat web do Gemini não tem caminho local sem túnel, então só a CLI é oferecida.)

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

## GitHub Copilot {#github-copilot}

Dois caminhos, com duas chaves de topo diferentes:

- **VS Code**: acrescente o servidor em `.vscode/mcp.json` (ou execute "MCP: Open User
  Configuration" na paleta de comandos) e depois habilite-o no seletor de ferramentas do
  Copilot Chat:

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

- **CLI**: o mesmo formato de servidor sob `mcpServers`, em `~/.copilot/mcp-config.json`
  (ou execute `/mcp add` dentro da CLI e escolha o tipo de servidor HTTP).

## Clientes roteados pela nuvem não são suportados {#cloud-routed-clients-are-not-supported}

Os conectores do ChatGPT, o chat web do Gemini e qualquer outra coisa que alcance a estação a partir
da internet não conseguem usar este endpoint, e a página não oferece configuração para eles. O endpoint
recusa qualquer requisição cujo cabeçalho `Host` não seja local, antes do handshake da sessão, então um
túnel não ajuda: um túnel encaminha o host público dele, que é exatamente o que é
recusado. A estação não é publicada na rede para agentes, e não existe interruptor
que faça isso.

## Qualquer outro cliente MCP {#any-other-mcp-client}

Qualquer cliente que rode neste computador e receba uma URL de servidor MCP em HTTP consegue usar a
estação: aponte-o para o endpoint mostrado na página.