最近在折腾把最新的 Codex CLI/App 接入 GPT-5.5 的时候,估计不少朋友都遇到过同一个让人抓狂的 Bug:明明环境都配好了,MCP(Model Context Protocol)死活就是识别不到,一调用就卡壳,或者直接报错说没装任何 MCP 工具。

跑了一段时间的日志分析,终于把问题给“破案”了。简单来说,这不是你的姿势不对,纯粹是兼容性问题。这里分享一下排查思路和那个立竿见影的临时解决办法。

问题现象

当你使用 Codex 的较新版本(通常是 0.120.0 以上,比如 0.139 或最新的 0.142.2)尝试连接 GPT-5.5 时,会出现以下症状:

  • 无法列出资源:运行 MCP 的 list resources 或 templates 指令时直接失败。
  • 假装没装工具:明明配置了 MCP 服务器,Codex 却声称“没检测到任何 MCP 插件”。
  • 进程卡死:调试时发现请求发出后,Codex App 或 CLI 就卡在那里不动,像是死机了一样。

深度分析:根因在哪?

Telegraph 报错截图显示 GPT-5.5 MCP 调用失败,包含禁用 search_tool 的临时解决提示

截图来源:Telegraph (any的破事让any自己解决)

经过排查,省流结论就是:GPT-5.5 目前还不支持新版 Codex 引入的 supports_search_tool 特性。

新版 Codex 在与模型交互时,默认会声明它支持搜索工具(search_tool)。这是一个为了增强模型联网或文件检索能力的新特性。然而,当这个声明发给 GPT-5.5 时,模型似乎没有正确响应或者无法处理这个特定的参数,导致握手阶段出现问题。Codex 就像个愣头青一样,因为没收到预期的响应流,就误以为 MCP 环境坏了,于是直接崩溃摆烂,告诉你“我没看到 MCP”。

实操解决:禁用 search_tool

既然 GPT-5.5 吃不下这个新特性,那我们就把这个特性的开关关掉。这虽然是个“临时办法”,但在官方修复之前,它是最稳妥的救急方案。

操作核心逻辑:

在你的 Codex 配置文件或启动参数中,找到关于 MCP 或工具能力的设置项,将 supports_search_tool 设为 false,或者干脆移除相关配置。

具体步骤参考(视具体版本而定):

  1. 打开 Codex 的配置文件(通常在用户目录下的 .codex 或类似路径)。
  2. 寻找 mcptools 相关的配置段落。
  3. 添加或修改以下配置,明确告知 Codex 不要启用搜索工具支持:
    # 示例配置片段
    mcp:
      supports_search_tool: false
    
  4. 保存配置并重启 Codex App 或 CLI 服务。

验证结果

搞定这一步后,再次尝试让 GPT-5.5 调用 MCP。你会发现之前“找不到工具”的错误瞬间消失,Codex 能够正常识别并列出所有的 Resources 和 Templates,工作流终于又能顺畅地跑起来了。

总结

这本质上是新旧版本迭代过程中的兼容性阵痛。GPT-5.5 的更新虽然强大,但在某些边缘协议的支持上明显滞后于 Codex 的开发节奏。在等待上游(不管是模型方还是 Codex 方)彻底修复这个兼容性 Bug 之前,“禁用 search_tool”这个手动降级方案,能让你马上回血,继续丝滑地 Coding。

标签: none

评论已关闭