---
title: "OpenAI Codex CLI MCP 配置：文件路径、键和示例 · DotsAgent"
description: "从 OpenAI 向 OpenAI Codex CLI 添加 MCP 服务器：了解配置文件位置、顶层键和格式、远程 OAuth 支持，以及配置示例。"
url: https://dotsagent.io/zh/mcp/clients/codex-cli
---

OpenAI

# 向 OpenAI Codex CLI 添加 MCP 服务器

Codex 在 config.toml 中管理服务器，每个服务器对应一个 [mcp_servers.<name>] 表；也可使用 codex mcp add 添加。

- **macOS**: `~/.codex/config.toml`
- **Windows**: `~/.codex/config.toml`
- **Linux**: `~/.codex/config.toml`
- **项目文件**: `.codex/config.toml (trusted projects only)`
- **顶层键**: `mcp_servers`
- **格式**: toml
- **远程服务器的 OAuth**: 

## 配置示例

此示例按该客户端所需的格式，添加 GitHub 托管的服务器和作为本地服务器的 Playwright。

`.codex/config.toml`

```
[mcp_servers.github]
url = "https://api.githubcopilot.com/mcp/"

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]
```

`shell`

```
codex mcp add github --url https://api.githubcopilot.com/mcp/
codex mcp add playwright -- npx @playwright/mcp@latest
```

## 注意事项和特殊情况

- Codex CLI、Codex IDE 扩展和 ChatGPT 桌面应用读取的是同一个 config.toml。
- 只有在受信任的项目中，才会读取项目的 .codex/config.toml。
- env_vars 按名称转发 shell 中的变量；bearer_token_env_var 会将变量中的 token 发送到远程服务器。
- 每个服务器都可以设置 startup_timeout_sec、tool_timeout_sec、enabled_tools 和 disabled_tools。
- 运行 codex mcp login <name> 可进行 OAuth 登录；支持 CIMD 和动态注册。

[生成 OpenAI Codex CLI 配置 →](https://dotsagent.io/zh/mcp/config#client=codex-cli)

## 其他客户端

[Claude Desktop](https://dotsagent.io/zh/mcp/clients/claude-desktop)

[Claude Code](https://dotsagent.io/zh/mcp/clients/claude-code)

[Cursor](https://dotsagent.io/zh/mcp/clients/cursor)

[VS Code (GitHub Copilot)](https://dotsagent.io/zh/mcp/clients/vscode-copilot)

[Windsurf / Devin Desktop](https://dotsagent.io/zh/mcp/clients/windsurf)

[Zed](https://dotsagent.io/zh/mcp/clients/zed)

[Gemini CLI](https://dotsagent.io/zh/mcp/clients/gemini-cli)

[ChatGPT](https://dotsagent.io/zh/mcp/clients/chatgpt)

[OpenClaw](https://dotsagent.io/zh/mcp/clients/openclaw)

[Cline](https://dotsagent.io/zh/mcp/clients/cline)

[Continue](https://dotsagent.io/zh/mcp/clients/continue)

[JetBrains AI Assistant](https://dotsagent.io/zh/mcp/clients/jetbrains-ai)

## 来源

1. [developers.openai.com](https://developers.openai.com/codex/mcp)/codex/mcp

为 AI agent 开发者提供的独立参考资料。与此处提及的任何厂商均无关联。

© 2026 DotsAgent · 事实核查日期：2026年10月1日