Codex 是 OpenAI 的 AI 编程智能体及其客户端，通过 ONES MCP 以授权身份读取 ONES 的工作项与知识库数据，从而在编码任务中带入需求上下文。本文按国内版公有云产品手册与 Codex 官方 MCP 文档整理核验清单，未在目标环境实测；代理与直接 HTTP 的选用、授权与只读调用的实际结果仍需在你们的环境中验证。
要点总览（TL;DR）
- 核验顺序按四层推进：团队端点、授权身份、目标工作项与知识空间的业务权限、检索范围，前一层不通过不进入下一层。
- 端点的判断标准是来源可追溯：从个人中心已授权 MCP 客户端页面复制，路径为 /mcp，OAuth 授权页地址不能替代。
- 工具出现在列表里只说明客户端发现了它，能否读到具体需求还取决于该身份在工作项与知识空间上的权限和 Wiki 许可。
- 普通查询与依赖 Assistant 的语义检索分两条线验收，语义检索需先确认团队具备 Assistant 条件，再比对结果覆盖范围。
- 只读核验全部通过并留痕后再评估写操作；端点不属于当前团队、凭据属于他人账号、越权对象可读都属于阻断项。
谁在什么时点用这份清单
这份清单面向两类人：负责 Codex 与 ONES 对接的研发效能或平台人员，以及为对接提供权限的 ONES 团队管理员。前者关心连接与调用是否成立，后者关心被读取的对象是否在授权范围内，两侧的确认动作需要分开留痕。
核验时点建议固定在四个节点：首次接入完成后、团队或权限发生变更后、新增知识空间后、新增项目后。前两个节点影响身份与端点，后两个节点影响检索范围，任何一次变更都可能让此前通过的检查项失效。
开始核验前需要具备两个前置条件：Codex 侧已完成 MCP 配置，ONES 侧已取得 MCP 客户端入口与凭据。配置完成只说明客户端认识了这个服务，业务调用是否成立要由后面的只读调用来回答。
第一段：团队端点与连接核验
端点是整条链路的第一道关口。Codex 连到哪个地址，决定了它读的是哪个团队的数据，因此这一步的判断标准是“地址来源可追溯”，而非“连接没有报错”。
端点来源与格式
- 从 ONES 个人中心的已授权 MCP 客户端页面复制团队 MCP 服务器地址，不要从浏览器地址栏或其他页面拼凑。
- 确认服务端路径为
/mcp。OAuth 授权页地址不能替代 MCP 服务器地址，两者混用会让客户端连到一个无法提供工具列表的端点。 - 记录该地址所属团队，与本次要读取需求所在团队比对一致。
客户端配置与代理排查
Codex 可在用户级或受信项目的 config.toml 中配置 MCP 服务，具体配置位置与当前桌面、CLI、IDE 版本的对应关系以厂商文档为准。ONES 国内手册给出的 Codex 配置范式使用 npx mcp-remote 代理，这种方式需要本地具备 Node.js 环境。
连接不通时，手册建议依次检查 Node.js/npx 是否可用、端点字符串中是否混入空格、网络是否可达目标地址。这三项只适用于采用该代理方式的配置。Codex 官方支持远程 MCP 与 OAuth，但代理与直接 HTTP 两种方式是否在你们的版本上等效，属于待验证项，清单中不预设结论。
第二段：身份与授权核验
端点正确只说明连对了门，身份核验要回答“以谁的名义读”。ONES MCP 支持 OAuth 与手工 Token 两种授权方式，手工 Token 可通过 X-ONES-MCP-Token 或 Authorization Bearer 携带，凭据绑定具体用户与团队，需在 ONES 提供的管理入口获取。
授权动作检查项
- 确认凭据由本人账号在 ONES 管理入口生成，凭据归属与预期调用身份一致，避免借用他人 Token 造成权限错位。
- 首次填入团队端点后完成 OAuth 授权，再回到 Codex 客户端检查连接状态与工具列表是否出现。
- 记录授权所用账号、授权时间与凭据类型（OAuth 或手工 Token），作为后续排查的基线。
- 工具列表出现后，继续执行一次只读调用，例如查询一个已知工作项的详情。配置成功与业务调用成功是两件事，前者不能替代后者。
工具数量以连接后实际发现的结果为准。手册与官网公布的数量口径不完全一致，实际可见工具取决于团队与授权，清单中不设固定数量作为通过标准。
第三段：数据权限与检索范围核验
这一段要把“工具可见”和“数据可读”拆开。可见工具及可操作数据受授权范围、用户权限、许可和团队能力共同限制，工具出现在列表中并不保证能操作任意对象。
普通查询验收线
- 选取一个目标项目中的工作项，用 Codex 查询其详情，比对返回字段与 ONES 页面显示是否一致，重点看标题、状态、负责人、所属项目。
- 选取一个知识空间或页面执行查询，确认返回内容属于预期空间。知识库操作受 Wiki 许可和权限约束，许可缺失时查询会失败而非返回空结果。
- 选取一个当前身份无权访问的工作项或空间发起读取，确认请求被拒绝。越权对象可读是阻断项，说明权限边界没有生效。
语义检索验收线
部分相似工作项与知识检索工具依赖 Assistant 及可用的嵌入模型或检索能力。这类工具需要单独验收：先确认团队是否具备 Assistant 条件，再验证检索结果是否落在预期项目与知识空间内。不能把“连接成功”等同于“全部语义能力可用”，也不能因为某个检索工具未出现就推断产品不具备该能力。
检索范围的判断口径是结果集合，而非单条命中。建议用同一关键词分别在 Codex 与 ONES 页面检索，比对结果覆盖的项目与空间是否一致；若 Codex 返回了预期范围之外的内容，按越权处理并暂停后续核验。
通过标准、证据与负责人
每类检查项都要有可判断的通过口径和可留存的证据，否则清单会退化成口头确认。下表给出对照关系，可按团队实际情况补充检查项，但判定口径保持一致。
| 检查项 | 通过标准 | 证据 | 负责人 |
|---|---|---|---|
| 团队端点来源 | 地址来自个人中心已授权 MCP 客户端页面，路径为 /mcp，所属团队与目标团队一致 | 端点来源截图与团队标识 | 对接人 |
| 客户端连接 | Codex 连接后可见工具列表，代理方式下 Node.js/npx 与网络检查通过 | 连接状态与工具列表截图 | 对接人 |
| 授权身份 | 凭据归属为预期账号，OAuth 授权完成并记录时间 | 授权账号、凭据类型、授权时间 | 对接人 |
| 工作项读取 | 指定工作项详情字段与 ONES 页面一致 | 只读调用返回结果与页面比对记录 | 对接人 |
| 知识空间读取 | 指定空间或页面可查，内容属于预期空间 | 查询返回记录 | 对接人 + 团队管理员 |
| 越权拒绝 | 无权对象读取被拒绝 | 被拒绝请求的记录 | 团队管理员 |
| 语义检索 | 具备 Assistant 条件，检索结果落在预期范围 | Assistant 条件确认记录与检索比对结果 | 团队管理员 |
分工上，对接人负责连接与调用验证，团队管理员负责权限与许可确认。语义检索的 Assistant 条件单独记录，不与普通查询合并成一条结论。
阻断项与完成条件
以下情况出现时必须停下，先修正再继续，不能带着问题进入下一段核验：
- 端点不属于当前团队，或使用 OAuth 授权页地址充当 MCP 服务器地址。
- 凭据属于他人账号，或授权身份与预期调用身份不一致。
- 目标对象越权可读，即当前身份本不应访问的工作项或知识空间返回了内容。
- 在无 Assistant 条件的情况下，把语义检索工具当作已具备并据此判断检索范围。
另需记录一条已知限制：所读 MCP 概述明确该 MCP 服务暂不支持删除操作，此限制只针对该 MCP 服务，不涉及 REST API 的删除能力。清单的完成条件是只读核验全部通过并留存证据；创建、更新、评论、执行工作流等写操作需在只读通过后另行评估，评估时还要确认对应权限与必填规则。
代理与直接 HTTP 的选用、授权与只读调用的实际结果，属于需要在目标环境验证的未确认项。完成首轮核验后，建议把端点、账号、检查日期与结论记入同一份记录，供下次团队或权限变更时对照复用。
常见问题
Codex 连接成功、工具列表也出现了，为什么还查不到某个项目的需求？
连接成功只说明客户端认识了这个 MCP 服务，工具列表出现也只说明工具被发现。可见工具及可操作数据受授权范围、用户权限、许可和团队能力共同限制，工具出现在列表中不保证能操作任意对象。遇到这种情况，先确认授权身份在该项目上是否具备工作项读取权限，再确认目标对象是否属于当前团队端点覆盖的范围。
团队没有 Assistant 时，Codex 还能检索知识库吗？
需要区分两类能力。知识空间与页面的查询属于常规工具，受 Wiki 许可和权限约束；部分相似工作项和知识检索工具依赖 Assistant 及可用的嵌入模型或检索能力。团队不具备 Assistant 条件时，把语义检索工具当作已具备会得出错误结论，应单独记录该条件，只对常规查询做验收。
只读核验通过后，能否直接让 Codex 创建或更新工作项？
只读通过是继续评估的前提，写操作需要另行确认。工作项创建与更新、评论、执行工作流等能力需满足相应权限和必填规则，变更状态要使用工作流工具。建议先在一个测试工作项上验证字段映射与必填项，再放开到真实需求；删除操作不在该 MCP 服务当前支持范围内，不要把它纳入写操作验收。
采用 mcp-remote 代理连不上时，应该先排查什么？
按手册顺序检查三项：本地 Node.js/npx 是否可用、端点字符串中是否混入空格、网络是否可达目标地址。这三项只适用于采用该代理方式的配置。Codex 官方支持远程 MCP 与 OAuth，代理与直接 HTTP 两种方式是否在你们的版本上等效，需要在目标环境验证，不能直接套用他人的结论。
团队或权限变更后，清单里哪些项需要重新核验？
端点、授权身份、工作项读取、知识空间读取、越权拒绝与语义检索条件建议全部重跑一遍。凭据绑定用户与团队，团队变更可能让原端点失效；权限调整则直接影响工作项与知识空间的读取结果。重跑时沿用同一份记录格式，把端点、账号、检查日期与结论记在一起，便于与上一轮对照。
官方参考资料
- MCP 服务概述（ONES）
- MCP 配置与使用（ONES）
- Model Context Protocol（OpenAI）
