要让 Codex 真正发挥全部潜力，首先需要打通它的感知系统。简单来说，如果不配置 MCP Server，Codex 仅仅是一个“单机版”的代码辅助工具，只能看到当前项目中的代码，对外部世界一无所知。一旦正确配置了 MCP，它就能够直接访问 Figma 设计稿、读取本地文件、调用数据库、查询 OpenAI 官方文档——这才是它真正的用武之地。
以下是一套经过实战验证的配置流程，按照步骤操作即可。
确认 Codex 已安装并能正常运行
首先，确保 Codex 本身已经准备就绪。打开终端，输入 codex --version，如果能够看到版本号（例如 v1.4.2）且没有任何报错，说明基础环境没有问题。如果提示“command not found”，则需要先进行全局安装：npm install -g @openai/codex。
安装完成后，随便进入一个项目目录，运行 codex 启动会话。输入“你好”，如果能够收到回复，说明 CLI 可以正常工作。这一步不可跳过，否则所有后续配置都将无法验证。
添加官方示例 MCP：OpenAI 开发者文档服务
这是一个入门级的 MCP 配置，操作简单，不需要依赖本地服务启动，主要用来验证 MCP 通路是否畅通。
在终端中执行：codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp。
如果没有报错，说明已注册成功。这里有一个需要注意的细节：URL 必须完整，https:// 和末尾的 /mcp 缺一不可，少任何一个字符都无法连接到服务。
然后运行 codex mcp list 进行确认。输出中应该包含 openaiDeveloperDocs，状态显示为 active。如果显示 inactive 或者根本没有列出来，可能是配置没有写入 config.toml，或者是服务端无法访问。
手动编辑 config.toml 添加 filesystem MCP
filesystem 是另一个基础的 MCP 服务，主要作用是让 Codex 能够安全地读写本地项目文件。这个服务无法通过命令行一键添加，需要手动编写配置。
找到配置文件的位置：Windows 系统在 C:Users{用户名}.codexconfig.toml，macOS/Linux 系统在 ~/.codex/config.toml。
在文件末尾添加以下 TOML 配置：
[mcp_servers.filesystem]
command = ["npx", "-y", "@anthropic/mcp-server-stdio"]
env = { MCP_SERVER_ROOT = "./" }
关键在于 MCP_SERVER_ROOT 必须设置为相对路径 ./，如果写成绝对路径（例如 C:/project），Codex 会因为没有权限而拒绝访问。它的文件系统 MCP 默认只允许操作当前工作目录及其子目录。
保存文件后，重新启动 Codex CLI。再次运行 codex mcp list，应该能够看到 filesystem 的状态变为 active。
国内用户必做：配置 npx 镜像避免超时
许多第三方 MCP Server（例如 figma、github、database）都依赖 npx 来拉取 npm 包。国内直接连接 npmjs.org 经常超时，具体表现是 codex mcp list 返回为空或者长时间卡住。
解决方法很简单：设置国内镜像源。执行 npm config set registry https://registry.npmmirror.com。
验证方法：npm config get registry 应该返回 https://registry.npmmirror.com。
这一步如果不做，后面所有需要 npx 启动的 MCP 都将无法使用，而且报错信息往往不明确，很容易让人误以为是配置写错了。
配置 Figma MCP Server（含令牌安全处理）
如果你希望 Codex 能够直接解析 Figma 设计稿，甚至生成 React 组件，需要完成三个步骤：获取令牌 → 写入环境变量 → 配置 server。
第一步：登录 figma.com，进入 Settings → Security → Generate new token，建议命名为 codex-figma，复制完整的令牌（格式类似 figd_xxx...）。
第二步：将令牌存入系统环境变量。千万不要硬编码在 config.toml 中。Windows 系统使用 $env:FIGMA_TOKEN="figd_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"，macOS/Linux 系统使用 export FIGMA_TOKEN="figd_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"。
第三步：在 config.toml 中追加以下配置：
[mcp_servers.figma]
command = ["npx", "-y", "@anthropic/mcp-server-figma"]
env = { FIGMA_TOKEN = "$FIGMA_TOKEN" }
保存后重启 Codex，再次运行 codex mcp list，确认 figma 条目状态为 active。此时在会话中直接提问“根据当前 Figma 文件生成按钮组件”，Codex 就会调用这个服务去拉取设计数据。