---
title: "在 Claude Code 和 Codex 中添加 MCP 服务器"
description: "在 Claude Code 中运行 claude mcp add --transport http，在 Codex 中运行 codex mcp add --url，然后登录。我们用 LogBrew MCP 服务器测试了这两种方式。"
canonical: "https://logbrew.co/zh-Hans/guides/mcp-server-claude-code-codex"
last_updated: "2026-11-10"
---

# 在 Claude Code 和 Codex 中添加 MCP 服务器

在 Claude Code 中运行 `claude mcp add --transport http`，在 Codex 中运行 `codex mcp add --url`，然后登录。我们用 LogBrew MCP 服务器测试了这两种方式。

2026年11月10日 用 Claude Code 2.1.319和Codex CLI 0.167.0 实测

作者 [Furkan Erday](https://github.com/furkanerday). Furkan Erday 是 LogBrew 的创始人，每天用 Claude Code 和 Codex 开发 LogBrew。

Canonical: https://logbrew.co/zh-Hans/guides/mcp-server-claude-code-codex

## 1 个 MCP 服务器，2 个智能体

LogBrew MCP 服务器 `https://logbrew.co/mcp`

工具 `search` `execute`

|  | Claude Code | Codex |
| --- | --- | --- |
|  | `claude mcp add --transport http` | `codex mcp add --url` |
| 保存位置 | `~/.claude.json` | `~/.codex/config.toml` |
| 登录前 | `Needs authentication` | `Not logged in` |

## Claude Code

### 添加服务器

在项目文件夹中运行这条命令。Claude Code 只为当前项目添加该服务器，并保存在 `~/.claude.json` 中。

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

输出

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

### 共享给团队或全局使用

`--scope project` 会在项目根目录写入 `.mcp.json`，团队成员通过 Git 就能拿到这个服务器。`--scope user` 会把它添加到你的所有项目。

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

输出

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

### 检查服务器

Claude Code 会检查列出的每个服务器。登录前，使用 OAuth 的服务器显示 `Needs authentication`。来自 `.mcp.json` 的服务器在你于会话中批准之前显示 `Pending approval`。

```bash
claude mcp list
```

输出

```text
Checking MCP server health…

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

### 登录

在会话中输入 `/mcp`，选择服务器，然后在浏览器中授权访问。在终端里运行 `claude mcp login logbrew` 效果相同。通过 SSH 使用时加上 `--no-browser`。

```bash
/mcp
```

## Codex

### 添加服务器

Codex 会在 `~/.codex/config.toml` 中写入 `[mcp_servers.logbrew]` 表。如果服务器使用 OAuth，Codex 会立即开始登录并打开浏览器。

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

输出

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

### 稍后登录或通过 SSH 登录

如果你关闭了浏览器标签页，之后可以用这条命令登录。通过 SSH 使用时，加上 `--no-browser`，在另一台电脑上打开输出的 URL，再把完整的重定向 URL 粘贴回终端。

```bash
codex mcp login logbrew
```

### 检查服务器

登录前，`Auth` 列显示 `Not logged in`。在打开的 Codex 会话中输入 `/mcp`，可以查看当前启用的服务器。

```bash
codex mcp list
```

输出

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

## 我们实测看到的结果

我们在 macOS 上运行了本页的每条命令，并用 `CLAUDE_CONFIG_DIR` 和 `CODEX_HOME` 指向临时配置文件夹，真实配置没有任何改动。

在 Claude Code 中，每次运行 `claude mcp add` 都会输出它修改的文件。随后 `claude mcp list` 对新服务器显示 `Needs authentication`，对 `.mcp.json` 中的服务器显示 `Pending approval`。

在 Codex 中，`codex mcp add` 输出了 `Detected OAuth support. Starting OAuth flow…`，随后输出了一个登录 URL。测试时我们禁止了打开浏览器，所以 Codex 让我们手动复制这个 URL。添加使用 OAuth 的服务器时，会弹出一个浏览器标签页。

在两个智能体中，我们都停在了授权同意页面之前。本页的登录步骤依据 Claude Code 和 Codex 的文档。

## 修复 mcp_servers 中的 invalid transport 错误

如果某个服务器表既没有 `url` 也没有 `command`，Codex 会在 `mcp_servers.logbrew` 处报 `invalid transport` 并停止。我们用一个空的 `[mcp_servers.logbrew]` 表复现了这个错误。

每个表只能设置这 2 项中的 1 项。远程服务器用 `url`，本地服务器用 `command`。两项都写同样会失败，报错为 `url is not supported for stdio`。Claude 风格的 `type = "http"` 这一行没有影响，因为 Codex 会忽略它。

反馈 #40715 显示，Windows 上的 ChatGPT 桌面应用也出现了同样的报错，涉及一个用户从未写过的 `mcp_servers.codex_app` 条目。2026 年 8 月 26 日，一位 OpenAI 工程师表示团队正在修复。这个反馈目前仍未关闭。

输出

```text
Error: failed to load bootstrap configuration

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

## 在 Codex 中限制工具和等待时间

`enabled_tools` 只保留你列出的工具，`disabled_tools` 再从中移除工具。`startup_timeout_sec` 和 `tool_timeout_sec` 的默认值分别是 10 秒和 60 秒。LogBrew 服务器有 2 个工具，`search` 和 `execute`。`codex mcp get logbrew` 显示了我们设置的每个值。

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

## 手动编辑 Claude Code 配置

这是测试中 `--scope project` 写入的 `.mcp.json`。在该项目中首次启动时，Claude Code 会请每个人批准这个服务器。

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

## 常见问题

### Claude Code 支持远程 MCP 服务器吗？

支持。使用 `--transport http` 并填写服务器 URL。如果服务器使用 OAuth，Claude Code 会通过 `/mcp` 或 `claude mcp login` 让你登录。

### Claude Code 把 MCP 服务器保存在哪里？

本地和用户级服务器保存在 `~/.claude.json`。项目级服务器保存在项目根目录的 `.mcp.json`。

### Codex 把 MCP 服务器保存在哪里？

保存在 `~/.codex/config.toml`，受信任的项目也可以用 `.codex/config.toml`。

### 如何移除 MCP 服务器？

运行 `claude mcp remove logbrew` 或 `codex mcp remove logbrew`。在 Claude Code 中，如果还想撤销令牌，先运行 `claude mcp logout logbrew`。

## 让智能体读取生产环境错误

LogBrew MCP 服务器把你批准的项目中的错误、日志和链路提供给 Claude Code、Codex 以及其他任何 MCP 客户端。除非你授予更多权限，它只能读取。免费额度充足，无需绑卡。

[连接你的智能体](https://logbrew.co/zh-Hans/agents)

## 参考来源

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

## 更多 AI 编程智能体指南

- [在 Claude Code 和 Codex 中使用 AGENTS.md](https://logbrew.co/zh-Hans/guides/agents-md)
- [解决 Claude overloaded 529 错误和 rate limit 429 错误](https://logbrew.co/zh-Hans/guides/claude-overloaded-rate-limit-error)
- [修复 Claude Code、Codex 和浏览器 JavaScript 中的错误](https://logbrew.co/zh-Hans/guides)