Codex MCP Server connected 但工具不显示怎么办？

大家好，我是 Codex 中文网的站长宇哥。

本文按 2026 年 8 月的 Codex 公开能力整理。Codex CLI、模型、Skill、Plugin 和第三方兼容接口更新较快，具体字段与可用能力请以你当前版本和官方文档为准。

MCP 的作用是把外部工具以标准化接口提供给 Codex。配置成功不代表业务安全；连接、Schema、权限、超时和工具返回都需要单独验证。

Codex 里的 MCP 配置放在哪里

Codex 会把 MCP 配置与其他设置一起保存在 config.toml。默认用户级位置是 ~/.codex/config.toml，受信任项目也可以使用 .codex/config.toml 做项目级配置。CLI、IDE 扩展和 ChatGPT 桌面端的 Codex 能共享这套配置。

从最小连接开始

官方 CLI 提供 codex mcp add 一类命令来添加 MCP Server。以本地 stdio Server 为例，思路是“先在终端独立启动成功，再交给 Codex 管理”。

# 形式示意：具体包名和参数以目标 MCP Server 文档为准
codex mcp add my-server -- npx -y some-mcp-server

如果 Server 自己都启动失败，继续修改 Codex 配置通常没有意义。先确认可执行文件、依赖、环境变量和标准输入输出协议。

故障排查顺序

1. 单独启动 MCP Server，确认没有依赖/权限错误。

2. 检查 Codex 当前实际加载的是哪个配置文件。

3. 查看 Server 是否成功完成初始化和工具发现。

4. 检查 Tool Schema：字段名、必填项、类型、枚举值。

5. 对远程 Server 再检查 HTTPS、代理、认证和超时。

6. 用最简单的工具调用测试，不要一开始就跑复杂多步 Agent 任务。

Skill 和 MCP 怎么配合

一个可靠做法是：MCP 提供能力，Skill 规定流程。比如数据库 MCP 暴露 query 工具，sql-review Skill 规定“先静态审查 SQL → 再用只读工具验证执行计划 → 最后输出风险”。这样既不会把业务规则散落在每次 Prompt 里，也不会让 MCP Server 承担不必要的 Agent 决策。

常见问题

这篇文章适合新手照着做吗？

适合。建议先按文章里的顺序理解问题背景，再在自己的项目里做最小验证，不要一次修改太多配置。

文章里的命令和配置需要完全照抄吗？

不建议完全照抄。Codex、模型接口和第三方工具更新很快，执行前要结合当前系统、项目目录、账号权限和官方文档再确认一遍。

总结

围绕“Codex MCP Server connected 但工具不显示怎么办”，建议始终从最小权限和最小工具集开始。先确保 Server 能独立工作，再让 Codex 连接；能用之后再增加认证、远程部署和自动化。这样排错和安全控制都会简单很多。

参考资料

• OpenAI：Model Context Protocol
• OpenAI：Configuration Reference
• OpenAI：Agent approvals & security

如果你通过第三方 API、中转站或兼容层使用 Codex，协议行为可能与 OpenAI 官方链路不同，排查时要把“Codex 客户端”和“上游接口”分开验证。