---
title: "Adicione um servidor MCP ao Claude Code e ao Codex"
description: "Execute claude mcp add --transport http no Claude Code ou codex mcp add --url no Codex e depois faça login. Testamos os dois com o servidor MCP do LogBrew."
canonical: "https://logbrew.co/pt-BR/guides/mcp-server-claude-code-codex"
last_updated: "2026-11-10"
---

# Adicione um servidor MCP ao Claude Code e ao Codex

Execute `claude mcp add --transport http` no Claude Code ou `codex mcp add --url` no Codex e depois faça login. Testamos os dois com o servidor MCP do LogBrew.

Testado em 10 de novembro de 2026 com Claude Code 2.1.319 e Codex CLI 0.167.0

Por [Furkan Erday](https://github.com/furkanerday). Furkan Erday é o fundador do LogBrew. Ele desenvolve o LogBrew com Claude Code e Codex todos os dias.

Canonical: https://logbrew.co/pt-BR/guides/mcp-server-claude-code-codex

## 1 servidor MCP, 2 agentes

Servidor MCP do LogBrew `https://logbrew.co/mcp`

Ferramentas `search` `execute`

|  | Claude Code | Codex |
| --- | --- | --- |
|  | `claude mcp add --transport http` | `codex mcp add --url` |
| Salvo em | `~/.claude.json` | `~/.codex/config.toml` |
| Antes do login | `Needs authentication` | `Not logged in` |

## Claude Code

### Adicione o servidor

Execute isto na pasta do seu projeto. O Claude Code adiciona o servidor só para este projeto e o salva em `~/.claude.json`.

```bash
claude mcp add --transport http logbrew https://logbrew.co/mcp
```

Saída

```text
Added HTTP MCP server logbrew with URL: https://logbrew.co/mcp to local config
```

### Compartilhe ou use em todo lugar

`--scope project` grava `.mcp.json` na raiz do projeto, e assim a sua equipe recebe o servidor pelo Git. `--scope user` adiciona o servidor a todos os seus projetos.

```bash
claude mcp add --transport http logbrew --scope user https://logbrew.co/mcp
```

Saída

```text
Added HTTP MCP server logbrew with URL: https://logbrew.co/mcp to user config
```

### Confira o servidor

O Claude Code verifica cada servidor que lista. Antes do login, um servidor que usa OAuth mostra `Needs authentication`. Um servidor do `.mcp.json` mostra `Pending approval` até você aprová-lo em uma sessão.

```bash
claude mcp list
```

Saída

```text
Checking MCP server health…

logbrew: https://logbrew.co/mcp (HTTP) - ! Needs authentication
```

### Faça login

Digite `/mcp` em uma sessão, escolha o servidor e aprove o acesso no navegador. No terminal, `claude mcp login logbrew` faz o mesmo. Por SSH, adicione `--no-browser`.

```bash
/mcp
```

## Codex

### Adicione o servidor

O Codex grava uma tabela `[mcp_servers.logbrew]` em `~/.codex/config.toml`. Se o servidor usa OAuth, o Codex já começa o login e abre o navegador.

```bash
codex mcp add logbrew --url https://logbrew.co/mcp
```

Saída

```text
Added global MCP server 'logbrew'.
Detected OAuth support. Starting OAuth flow…
```

### Faça login depois ou por SSH

Se você fechar a aba do navegador, faça login depois com este comando. Por SSH, adicione `--no-browser`, abra a URL exibida em outro computador e cole a URL de redirecionamento completa no terminal.

```bash
codex mcp login logbrew
```

### Confira o servidor

Antes do login, a coluna `Auth` mostra `Not logged in`. Digite `/mcp` em uma sessão aberta do Codex para ver seus servidores ativos.

```bash
codex mcp list
```

Saída

```text
Name     Url                     Bearer Token Env Var  Status   Auth
logbrew  https://logbrew.co/mcp  -                     enabled  Not logged in
```

## O que vimos no teste

Executamos cada comando desta página no macOS, com pastas de configuração descartáveis definidas por `CLAUDE_CONFIG_DIR` e `CODEX_HOME`, então nenhuma configuração real mudou.

No Claude Code, cada `claude mcp add` mostrou o arquivo que alterou. Depois, `claude mcp list` mostrou `Needs authentication` para o servidor novo e `Pending approval` para o do `.mcp.json`.

No Codex, `codex mcp add` mostrou `Detected OAuth support. Starting OAuth flow…` e depois uma URL de login. Tínhamos bloqueado o navegador para o teste, então o Codex pediu para copiarmos a URL à mão. Conte com uma aba do navegador quando adicionar um servidor que usa OAuth.

Nos 2 agentes, paramos antes da tela de consentimento. Os passos de login desta página seguem a documentação do Claude Code e do Codex.

## Corrija invalid transport em mcp_servers

O Codex para com `invalid transport` em `mcp_servers.logbrew` quando uma tabela de servidor não tem `url` nem `command`. Recebemos exatamente esse erro com uma tabela `[mcp_servers.logbrew]` vazia.

Dê a cada tabela 1 dos 2. Use `url` para um servidor remoto e `command` para um local. Uma tabela com os 2 também falha, com `url is not supported for stdio`. Uma linha `type = "http"` no estilo do Claude não atrapalha, porque o Codex a ignora.

O relato #40715 mostra a mesma mensagem no app desktop do ChatGPT no Windows, para uma entrada `mcp_servers.codex_app` que o usuário nunca escreveu. Em 26 de agosto de 2026, um engenheiro da OpenAI escreveu que a equipe estava trabalhando em uma correção. O relato continua aberto.

Saída

```text
Error: failed to load bootstrap configuration

Caused by:
    invalid transport
    in `mcp_servers.logbrew`
```

## Limite ferramentas e tempos de espera no Codex

`enabled_tools` mantém só as ferramentas que você listar, e `disabled_tools` remove ferramentas depois disso. `startup_timeout_sec` e `tool_timeout_sec` têm padrão de 10 e 60 segundos. O servidor do LogBrew tem 2 ferramentas, `search` e `execute`. `codex mcp get logbrew` mostrou cada valor que definimos.

```bash
[mcp_servers.logbrew]
url = "https://logbrew.co/mcp"
enabled_tools = ["search", "execute"]
startup_timeout_sec = 20
```

## Edite a configuração do Claude Code à mão

Este é o `.mcp.json` que `--scope project` gravou no nosso teste. O Claude Code pede que cada pessoa aprove o servidor na primeira vez que ele inicia nesse projeto.

```bash
{
  "mcpServers": {
    "logbrew": {
      "type": "http",
      "url": "https://logbrew.co/mcp"
    }
  }
}
```

## Perguntas frequentes

### O Claude Code aceita servidores MCP remotos?

Sim. Use `--transport http` com a URL do servidor. Quando o servidor usa OAuth, o Claude Code faz o seu login por `/mcp` ou `claude mcp login`.

### Onde o Claude Code guarda os servidores MCP?

Servidores locais e de usuário ficam em `~/.claude.json`. Servidores de projeto ficam em `.mcp.json` na raiz do projeto.

### Onde o Codex guarda os servidores MCP?

Em `~/.codex/config.toml`, ou em `.codex/config.toml` em um projeto em que você confia.

### Como remover um servidor MCP?

Execute `claude mcp remove logbrew` ou `codex mcp remove logbrew`. No Claude Code, execute `claude mcp logout logbrew` antes se você também quiser revogar o token.

## Deixe o seu agente ler os erros de produção

O servidor MCP do LogBrew dá ao Claude Code, ao Codex e a qualquer outro cliente MCP os erros, logs e traces dos projetos que você aprovar. Ele só lê, a menos que você permita mais. Comece no plano gratuito generoso, sem cartão.

[Conectar seu agente](https://logbrew.co/pt-BR/agents)

## Fontes

- [Claude Code docs, Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp)
- [Codex docs, Model Context Protocol](https://learn.chatgpt.com/docs/extend/mcp?surface=cli)
- [openai/codex#40715](https://github.com/openai/codex/issues/40715)

## Mais guias para agentes de programação com IA

- [Use AGENTS.md no Claude Code e no Codex](https://logbrew.co/pt-BR/guides/agents-md)
- [Corrija o erro 529 overloaded e o erro 429 de rate limit do Claude](https://logbrew.co/pt-BR/guides/claude-overloaded-rate-limit-error)
- [Como corrigir erros no Claude Code, no Codex e no JavaScript do navegador](https://logbrew.co/pt-BR/guides)