Ganter Lab
Entrar Baixar

Conectar um cliente

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

Ver como Markdown

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

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)

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

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

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

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

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.