配置 MCP 时依次确认四件事：服务器地址或本地启动方式、传输协议、认证方式、工具和数据权限。先用只读工具测试，再开放写入动作；MCP 的连接、认证和授权由服务器与产品策略共同决定，不能只看“已连接”三个字。
官方参考：MCP 官方介绍 · 连接自定义 MCP 服务器 · MCP Inspector · MCP、Skills、Plugins 区别
MCP 到底连接了什么？
MCP 是连接 AI 应用与外部系统的开放标准。服务器可以提供数据、工具或工作流，Codex 作为客户端发现这些能力，并在用户请求符合条件时调用。它不等于把整个账号交给 Codex：服务器能做什么，取决于它暴露的工具、认证身份、资源权限和工作区策略。
| 组件 | 负责什么 | 排障时看什么 |
|---|---|---|
| MCP Server | 暴露工具、资源和提示 | 端点、进程、工具列表、日志 |
| Codex Client | 连接、发现和调用工具 | 客户端版本、配置、连接状态 |
| 认证 | 证明用户或服务身份 | OAuth、Token、环境变量、过期时间 |
| 授权策略 | 决定能读什么、写什么 | 账号角色、工作区权限、工具副作用 |
先选择连接方式
托管服务器通常提供公网 HTTPS 端点；本机工具则可能通过本地传输启动一个进程。不要把“HTTPS”当成安全保证，也不要把“本地”当成天然可信：两者都要检查来源、权限、日志和数据流向。
- HTTPS 服务器：记录完整端点、是否需要 OAuth 或其他认证、服务端允许哪些来源。
- 本地服务器：确认启动命令、运行用户、工作目录、环境变量和进程退出时的错误。
- 测试服务器：优先选择只读工具和测试数据，确认工具输入输出后再接生产资源。
Codex MCP 配置的通用步骤
- 确认当前 Codex 客户端和账号支持 MCP，工作区没有禁止外部连接。
- 准备服务器端点或本地启动命令，并阅读它的工具清单和隐私说明。
- 在产品提供的 Plugins、Apps 或 MCP 入口中添加服务器，填入名称、端点和认证方式。
- 阅读风险提示，确认服务器会访问哪些数据、能执行哪些动作，再完成连接。
- 刷新或重新打开会话，查看工具元数据是否出现。
- 先调用一个无副作用的只读工具，再测试参数错误、无权限和超时场景。
OpenAI 当前帮助说明，在支持的 Plugins 体验中，可以选择 Add custom MCP server，输入公网 HTTPS 端点或可用的安全隧道，配置认证，确认风险提示后创建并查看发现的工具。入口名称和工作区权限可能随产品版本变化。
认证方式怎么选？
| 方式 | 适合 | 主要风险 |
|---|---|---|
| OAuth | 需要用户登录和按用户授权的服务 | 回调地址、scope、refresh token 和撤销流程 |
| 短期 Token | 临时测试或受限服务 | 过期、泄露和复制到日志 |
| 环境变量 | 本地开发和 CI 的服务凭证 | 错误打印、进程继承和 CI 日志暴露 |
| 无认证只读 | 公开文档、演示或测试数据 | 不要误以为无认证服务可以写入真实数据 |
不要把 API Key、OAuth refresh token、Cookie 或密码写入 Git、AGENTS.md、SKILL.md 或聊天内容。生产环境应使用最小权限、可撤销凭证和独立测试账号；出现泄露时先撤销再排查日志。
连接成功但工具不可用怎么办？
| 现象 | 优先检查 | 判断方向 |
|---|---|---|
| 连接超时 | 端点、DNS、TLS、防火墙、服务器是否运行 | 网络或服务存活问题 |
| 401/403 | Token、OAuth scope、账号和工作区权限 | 认证或授权问题 |
| 已连接但无工具 | 初始化响应、工具列表、版本兼容 | 协议或元数据问题 |
| 工具调用失败 | 参数 schema、必填字段、资源权限 | 输入或业务授权问题 |
| 调用后数据不对 | 服务器日志、工具副作用、缓存和数据源 | 工具实现或数据边界问题 |
排查时保留原始错误、时间、客户端版本、工具名和脱敏后的请求参数。若服务器支持 MCP Inspector，可以先在独立环境中查看工具发现和调用结果，再回到 Codex 连接；这样能区分服务器问题和客户端配置问题。
如何做一次安全验收？
- 用测试账号或测试项目连接，不直接接生产账户。
- 先列出工具和权限，再逐个验证读操作；写操作必须有明确确认。
- 检查服务器是否会把输入发送到第三方、保存多久以及如何删除。
- 限制网络域名、文件目录、数据库角色和 Token scope。
- 为工具调用保留可追踪日志，但不要记录完整密钥或敏感内容。
和 Skills、AGENTS.md 怎么配合？
Skills 负责“如何完成一套工作流”，MCP 负责“从哪里拿数据、执行什么工具”；AGENTS.md 负责项目级边界和验收规则。可以让 Skill 规定先调用只读工具、再核对结果、最后请求确认，但不要把认证凭证写入任何规则文件。
常见问题
MCP 是什么？
MCP 是连接 AI 应用与外部数据、工具和工作流的开放标准。MCP 服务器提供工具和数据，Codex 作为客户端连接并按权限调用。
Codex MCP 用 HTTPS 还是本地服务器？
公网或托管服务通常使用 HTTPS 端点；本机工具可以使用本地传输。选择取决于服务器部署方式、网络和认证要求。
MCP 连接成功但 Codex 看不到工具怎么办？
先检查服务器是否完成初始化、工具列表是否返回、账号权限和工作区策略，再重新连接或刷新工具元数据。
MCP 需要把 API Key 写进配置文件吗？
不应把长期密钥直接写进公开仓库或提示词。优先使用产品支持的认证流程、环境变量或密钥管理，并限制服务器权限。
需要 Codex 套餐或连接配置咨询？
GPT Pro AI 提供 Codex、ChatGPT Plus/Pro 相关的第三方使用咨询，不代表 OpenAI 官方授权；连接能力、权限和工具可用性以官方客户端与账号页面为准。