codex需通过mcp协议接入外部工具才能实现读文件、查数据库等能力。先确认node.js≥16、git可用，再全局安装codex-cli；配置mcp服务有三种方式：命令行添加、手动编辑config.toml或用mcp-router；最后验证服务注册、进程存活及调用连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让Codex不只是写代码、改Bug，还能自动读取本地文件、查SQLite数据库、抓取网页数据、调用Blender建模——这些能力必须通过MCP协议接入外部工具才能实现，而不是靠提示词或插件开关。
确认环境与基础依赖
先检查 Node.js 版本是否 ≥16：终端执行 node -v，输出如 v18.20.2 即可；若低于16，升级后再继续。
确保 Git 可用：运行 git --version，有响应即达标。这两项是绝大多数 MCP Server 启动的前提，缺一不可。
全局安装 codex-cli：执行 npm install -g codex-cli。这一步失败通常是因为 npm 权限问题或镜像源超时——国内用户请先配置淘宝镜像：npm config set registry https://registry.npmmirror.com。
三种配置方式任选其一
方法一：命令行一键添加（推荐新手）
直接运行：codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp。这条命令会自动生成服务定义并写入 ~/.codex/config.toml。
方法二：手动编辑配置文件
打开 ~/.codex/config.toml，在文件末尾新增如下 TOML 块：
[mcp_servers.docs]
command = "npx -y @openai/mcp-server-openapi"
args = ["--url", "https://developers.openai.com/openapi.json"]
env = { NODE_OPTIONS = "--max-old-space-size=4096" }
【注意：command 字段必须写完整可执行路径或带 npx 的命令，不能只写包名】
方法三：用 MCP Router CLI 统一管理
先安装：npm install -g @mcp/router，再执行：mcp-router init → mcp-router add filesystem --type local → mcp-router export-to-codex。最后按提示将生成的配置块粘贴进 ~/.codex/config.toml。
验证与启动服务
第一步：检查服务是否注册成功
启动 Codex CLI 后，在会话中输入 /mcp list，应看到类似以下输出：
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
docs (openapi) — ready
filesystem (local) — ready
第二步：单独测试服务进程是否存活
回到终端，手动运行配置中定义的 command，例如：npx -y @openai/mcp-server-openapi --url https://developers.openai.com/openapi.json。如果立即退出或报 Cannot find module，说明依赖未装全或路径错误，需先解决再回 Codex。
第三步：在对话中触发调用
输入：@docs search "streaming response"。Codex 会向 docs 服务发起请求，返回匹配的 OpenAI API 文档片段。若返回 tool not found 或超时，说明服务虽注册但未真正连通。
第四步：排查常见断层点
① 客户端支持：确认你用的是 Codex CLI v0.12+ 或 VS Code 插件 v1.8+，旧版本不解析 mcp_servers 配置块；
② 配置位置：项目级配置需放在 .codex/config.toml（当前目录下），全局配置必须是 ~/.codex/config.toml；
③ 权限隔离：Linux/macOS 下若用 sudo codex 启动，它读取的是 root 用户的 ~/.codex/config.toml，而非你当前用户的。
跨工具协同实操
要让 Codex 同时调用文件系统和 SQLite，只需在 config.toml 中并列定义两个服务：
[mcp_servers.filesystem]
command = "npx -y @mcp/server-filesystem"
args = ["--root", "/Users/you/project"]
[mcp_servers.sqlite]
command = "npx -y @mcp/server-sqlite"
args = ["--db", "./dev.db"]
然后在一次会话中连续使用：@filesystem ls src/ → @sqlite SELECT * FROM users LIMIT 3。两个服务互不干扰，Codex 自动路由到对应进程。
若需让 Claude Code 也复用同一套服务，只需把上述 TOML 块翻译成 JSON 格式，填入其 settings.json 的 "mcpServers" 字段——协议相同，仅配置语法不同。
