Codex 配置 MCP 后看不到工具，先确认服务器是否被当前客户端加载，再检查启动、认证和工具过滤。不要一上来删除配置重装；多数问题可以用 codex mcp list、TUI 里的 /mcp 和一次明确的重启定位。
第一步：确认改的是同一份配置
Codex App、CLI 和 IDE 扩展会共享 Codex 配置，默认位置是 ~/.codex/config.toml；可信项目也可以使用 .codex/config.toml。如果设置了不同的 CODEX_HOME 或切换了配置档案，当前客户端可能读到另一份文件。先运行：
codex mcp list列表里没有目标名称，说明配置没有被当前环境读取。
第二步：让客户端重新加载
在 Codex App 保存 MCP 后要点 Restart；IDE 扩展则选择 Restart extension。CLI 新开一个会话后，在 TUI 输入 /mcp，确认服务器状态和暴露的工具。只修改 config.toml 但继续使用旧会话，工具列表可能不会刷新。
第三步：区分启动失败和认证失败
STDIO 服务器依赖本机命令、参数、工作目录和环境变量。把配置中的启动命令复制到同一终端直接运行；若提示命令不存在或依赖缺失，先修复 PATH 和运行环境。HTTP 服务器需要 OAuth 时，执行：
codex mcp login <服务器名称>完成授权后重新启动客户端。服务器启动较慢时，可以提高 startup_timeout_sec；默认启动等待时间只有 10 秒。
第四步：检查工具是否被过滤
配置项 enabled = false 会停用整个服务器，enabled_tools 只允许列出的工具，disabled_tools 会在允许列表之后继续排除工具。服务器已连接但工具数量为零时，优先检查这三项，而不是怀疑模型。
仍然没有工具时，保留 /mcp 显示的状态、启动命令报错和服务器日志。三者能明确区分“配置没加载”“进程没启动”“授权没完成”和“工具被过滤”，后续修复只处理对应一层。
