Codex mcp这样配置,终于能用了

November 28, 2025·zeiki

一个月前第一次上手Codex,一个稍微有点复杂的重构任务居然一次执行就通过了,比之前用起Augment、Cursor爽太多了。但是付费开了会员发现一个问题,MCP一直配置有问题。

我的很多数据库操作,用习惯了MCP之后,实在是用不惯比较传统的数据库推送操作,但是Codex 的mcp配置为了和claude争话语权,用的是.toml文件,当时很多mcp默认的语法都是claude的json语法,其实都是语法都比较简单,转换下也还好。

但是即使完全没有语法问题,配置之后,还是没法用,多数时候说无法解析识别、后来我直接绝对路径node,结果显示time out,还是不行。

这东西,卡了我小一个月,虽然搁手,但耐不住它其他方面确实香,特别是做代码重构,提升代码质量上。

昨天无意间给 augment 配置context 7文件,发现居然有适配codex的版本,关键是给了几种无法配置的解决办法,今天正好分享下:

image.png


https://github.com/upstash/context7



在 Windows 上,一些用户可能会遇到默认配置下的请求超时错误。在这种情况下,请使用 Node.js 的完整路径和已安装的包显式配置 MCP 服务器:

[mcp_servers.context7]

command = "cmd"

args = [

    "/c",

    "npx",

    "-y",

    "@upstash/context7-mcp",

    "--api-key",

    "YOUR_API_KEY"

]

env = { SystemRoot="C:\\Windows" }

startup_timeout_ms = 20_000



⚠️ MacOS 注意事项

在 MacOS 上,一些用户可能会遇到与 Windows 类似的请求超时错误,这也可以通过指定 Node.js 的完整路径和已安装的包来解决:



[mcp_servers.context7]

command = "/Users/yourname/.nvm/versions/node/v22.14.0/bin/node"  # Node.js full path

args = ["/Users/yourname/.nvm/versions/node/v22.14.0/lib/node_modules/@upstash/context7-mcp/dist/index.js",

  "--transport",

  "stdio",

  "--api-key",

  "YOUR_API_KEY"

]

然后问题自然就解决了,我主力用Windows比较多,之前也尝试moc os配置过,也是失败,估计用后面mac的配置方法也可以解决,我的windows配置是用前面的方法解决的。 直接复制粘贴对应的样例,然后让AI转写之前配置在claude cursor等地方的mcp.json文件即可,转写之后,粘贴到codex的config.toml文件中,一切都解决了。

image.png

如果你也遇到和我一样的问题,使用上面的方法,应该可以顺利解决。

我是邬轼,持续分享AI出海领域的一些实操经验,如果对你有帮助,可以点个关注~

wx:y1711380273(欢迎交流~