展开知识库目录

Codex 安装 MCP:配置、授权和第一次只读调用

配置位置、字段和支持的传输会变化,实际安装必须按 OpenAI 当前官方文档。

先把问题看准

Codex 接 MCP 先备份配置并限定作用域

配置位置、字段和支持的传输会变化,实际安装必须按 OpenAI 当前官方文档。方法上先记录客户端版本、审查 Server、备份现有配置,再用最小权限完成工具发现和一次只读调用。

第 1 步

确认版本和作用域

记录 Codex 版本、系统、Shell、项目或用户范围,以及实际读取的配置位置。

记录 Client、Server、配置位置、传输方式、认证范围、工具列表和一次真实调用结果。

第 2 步

审查 Server

确认官方来源、启动或远程端点、依赖、凭证、工具副作用和卸载方式。

确认“审查 Server”已经有可回查结果,再进入“备份并写配置”;依据仍然来自猜测时,把缺口单列并停在当前步骤。

第 3 步

备份并写配置

只添加当前 Server 所需字段,敏感值通过受控环境或授权流程注入,不粘进仓库和截图。

确认“备份并写配置”已经有可回查结果,再进入“验证工具发现”;依据仍然来自猜测时,把缺口单列并停在当前步骤。

第 4 步

验证工具发现

重启或重新加载后查看工具列表;为空时先查配置是否被读取和 Server 日志。

确认“验证工具发现”已经有可回查结果,再进入“运行只读测试”;依据仍然来自猜测时,把缺口单列并停在当前步骤。

第 5 步

运行只读测试

读取一个测试资源,保存参数、结果和日志;发送、创建、修改、删除或部署留到人工确认。

先用只读、小范围请求验证连接;涉及写入、删除、付款或外发时必须重新确认对象与权限。 完成后把证据归入“配置记录、工具列表和只读结果”。

完成后应能在“配置记录、工具列表和只读结果”中找到与这一步对应的记录;仍需靠猜测补全,就停在这里。

做到这里就可以停

配置可用要由三类证据证明

客户端确实读取配置、目标工具出现在列表、只读调用返回预期资源。只看到 Server 进程启动不能证明 Codex 已连接。

进一步核对

参考资料与核对入口