Codex MCP 配置教程：接入官方文档、核对作用域与定位连接失败

保存配置基线，再添加一个 HTTP 端点

$codexConfigRoot = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $env:USERPROFILE '.codex' }
$codexConfigFile = Join-Path $codexConfigRoot 'config.toml'
if (Test-Path -LiteralPath $codexConfigFile) {
  $backupPath = $codexConfigFile + '.before-mcp-' + (Get-Date -Format 'yyyyMMdd-HHmmss-fff') + '-' + [guid]::NewGuid().ToString('N') + '.bak'
  Copy-Item -LiteralPath $codexConfigFile -Destination $backupPath
  Write-Output $backupPath
}

codex --version
codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
codex mcp list
codex mcp get openaiDeveloperDocs

[mcp_servers.openaiDeveloperDocs]
url = "https://developers.openai.com/mcp"

让同一个问题留下三段可回查证据

1. 01

   get 核对实际定义

   确认条目名称、HTTP URL 和启用状态与主线一致。若你编辑了项目配置，还应在项目中和项目外分别检查；不要从文件存在推断它已经被加载。

   这一步的证据是配置定义，尚不是一次成功的工具调用。
2. 02

   重开 Codex 会话，再用 /mcp 查看

   在 TUI 中输入 /mcp，找到本例 Server 和当前会话看到的工具。IDE 修改后按其界面重启扩展。记录不可用项给出的原始错误，而不是只截一个名称。

   这一步证明本会话发现了哪些能力；其他终端里的 list 不能替代它。
3. 03

   查询一个可以回查的具体问题

   输入：‘使用 openaiDeveloperDocs 查 Codex MCP 的 user 与 project 配置位置。返回两项路径、可信项目限制，以及对应官方文档 URL；找不到就说明，不要凭记忆补齐。’随后展开工具调用，核对确实使用了目标 Server、查询与结果相关，答案中的链接能回到原文。

   这是教学任务与预期核对方法，不是本站在读者设备完成后的成功记录。

对话里的‘只读’指令，不能证明系统权限隔离

本例 Server 按官方说明只提供文档能力。让模型回答‘能否用它改本地文件’，最多检查模型是否理解工具边界；不应拿删除真实 README 的请求做测试。即使它拒绝，也不能证明宿主的 Shell、文件工具或其他 Server 无权写入。

需要每次审阅 MCP 调用时，可在已有 Server 表中额外添加下面一行。它控制客户端审批，不改变外部账号权限。enabled_tools 可筛选实际发现的工具名，disabled_tools 再作排除；先看真实工具目录再填写，不复制猜测的名称。

default_tools_approval_mode = "prompt"

只有你需要本地 Server 时，才走 stdio 这条支线

Codex 官方文档以 Context7 展示 stdio。它由第三方维护，可能下载执行 npm 包，且本地进程仍可联网。本例用于看清 command/args，不是主线必装项；运行前先完成安装前审查。下面遵循官方示例使用未固定版本的包，正式长期使用应换成已审查的确切版本。

codex mcp add context7 -- npx -y @upstash/context7-mcp

codex mcp add context7 -- cmd.exe /d /c npx.cmd -y @upstash/context7-mcp

[mcp_servers.context7]
command = "cmd.exe"
args = ["/d", "/c", "npx.cmd", "-y", "@upstash/context7-mcp"]

是哪一段失败，就检查哪一段

本地删除、会话重载和提供方撤权分别处理

本例无 OAuth 授权，remove 后核对定义与新会话工具均不再出现即可。若手工放在项目配置中，删除对应表并检查用户层是否还存在同名条目；不要删除其他 Server。若可见定义变化与预期不符，先查配置层，不要整体恢复旧备份覆盖期间的新修改。

其他采用 OAuth 的 Server 可用 codex mcp logout 名称清除本地凭证，但这不等于提供方已经撤销授权或使所有访问令牌立即失效。完整撤权还应在提供方账户撤销应用访问，并按其令牌生命周期核对；本地命令不能替你证明服务端状态。

codex mcp remove openaiDeveloperDocs
codex mcp list

# 在重新打开的 Codex TUI 内输入：
/mcp

资料与核对范围

资料核对日：2026-10-10。以下来源支持协议与配置说明；文中的命令、练习和预期结果不代表本站已在所有客户端和系统完成实测。

同一阶段的相邻教程