必须通过CLI命令动态注册MCP服务：先验证codex --version可用，再用codex mcp add添加stdio或HTTP类型服务器，最后用codex mcp list和codex exec验证连接与调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Linux环境下让Codex动态接入外部MCP服务，必须绕过静态配置的限制，直接通过CLI命令实时注册服务器，否则每次修改config.toml都要重启Codex且无法验证连接状态。
确认Codex已安装并可执行
在终端中运行codex --version，输出版本号（如v2.8.3）即表示CLI可用。若提示command not found，说明Node.js未正确安装或npm全局bin路径未加入$PATH，需先修复环境再继续。
执行codex mcp list，观察是否返回空列表或报错No MCP servers configured——这是正常初始状态，证明MCP模块已加载但尚未挂载任何服务。
使用codex mcp add动态添加stdio类型服务器
方法一：本地文件系统服务（推荐新手验证）
第一步：确保目标目录存在且有读写权限，例如/home/user/myproject/docs；【若目录不存在或权限不足，npx启动会静默失败，后续调用工具时直接报“connection refused”】
第二步：执行以下命令一次性注册文件系统MCP服务：
codex mcp add filesystem --type stdio --command npx --args "-y,@modelcontextprotocol/server-filesystem,./docs" --cwd "/home/user/myproject"
这一步会自动写入~/.codex/config.toml的[mcp_servers.filesystem]区块，并跳过手动编辑配置文件的出错风险。注意--cwd必须是绝对路径，相对路径会导致服务器启动后找不到工作目录。
配置 OpenClaw 多提供商认证与 OpenAI Codex OAuth 备用方案，实现自动模型切换，适用于多 OpenAI Codex 账户设置。
添加HTTP类型MCP服务（需带认证头）
方法二：对接私有文档API
运行命令：codex mcp add docs --type http --url "https://docs.example.com/mcp" --header "Authorization: Bearer abc123"
该命令会在配置中生成[mcp_servers.docs]块，并将http_headers设为指定键值对。注意Bearer token必须紧贴:后无空格，否则服务端校验失败返回401。
如果API域名未备案或证书不可信，Codex默认拒绝HTTPS连接；此时需额外添加--insecure参数，但【此操作会跳过SSL证书验证，仅限测试环境使用】。
验证新挂载服务是否生效
执行codex mcp list，确认输出中包含filesystem和docs两行，状态列为active而非inactive。
接着运行codex mcp tools --server filesystem，应列出read_file、list_directory等工具名；若返回空或报错Failed to fetch tools，说明stdio服务器进程未成功启动，需检查npx是否被防火墙拦截或磁盘空间不足。
最后用codex exec --tool read_file --arg path="./README.md"测试真实调用——这步会触发Codex向刚挂载的filesystem服务器发起请求并返回文件内容，成功即代表动态挂载完成。
