必须配置mcp server插件才能让codex访问外部资源；需先验证codex基础运行正常，再依次添加openaideveloperdocs、手动配置filesystem、设置npx镜像源、安全配置figma mcp。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让 Codex 能访问 Figma 设计稿、读取本地文件、调用数据库或查询 OpenAI 官方文档，必须配置 MCP Server 插件——它不是可选功能，而是打通外部上下文的唯一通道。不配好 MCP，Codex 就只能看到当前项目里的代码，对外部世界完全“失明”。
确认 Codex 已安装并能正常运行
打开终端，执行 codex --version。输出版本号（如 v1.4.2）且无报错，说明基础环境就绪。若提示 command not found，请先全局安装：npm install -g @openai/codex。
进入任意项目目录，运行 codex 启动会话。输入“你好”，收到响应即代表 CLI 可用。这一步跳过会导致后续所有 MCP 配置无法验证。
添加官方示例 MCP：OpenAI 开发者文档服务
这是最轻量、最可靠的入门方式，不依赖本地启动服务，直接验证 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 安全读写本地项目文件。它不能通过命令行一键添加，必须手写配置。
打开用户级配置文件：C:\Users\{用户名}\.codex\config.toml（Windows）或 ~/.codex/config.toml（macOS/Linux）。
在文件末尾新增以下 TOML 块：
[mcp_servers.filesystem]command = ["npx", "-y", "@anthropic/mcp-server-stdio"]env = { MCP_SERVER_ROOT = "./" }
这一步的关键是 【MCP_SERVER_ROOT 必须设为相对路径 ./，设成绝对路径（如 C:/project）会导致权限拒绝】。Codex 的 filesystem MCP 默认只允许操作当前工作目录及其子目录。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
保存文件后，重启 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、GitHub 等）都将无法加载，且错误信息不明确，极易误判为配置错误。
配置 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 就会调用该服务拉取设计数据。
