服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 官方记录为2026年8月24日弃用、2026年9月5日移除；这是既有入口的迁移事项，不是2026年10月11日的新功能上线。
- 受影响的是把 Codex 本身作为 MCP server 的旧入口；连接外部 MCP 工具及 codex mcp 管理命令仍受支持。
- App Server 不是 MCP 客户端的即插即用替代：初始化握手、线程与轮次、事件流及审批响应都要适配。
- App Server 命令仍属实验性且不支持生产工作负载；现有认证的商用托管限制与远程监听安全也要先确认。
旧入口已经移除：升级前先查两种启动名称
当前官方迁移页明确：codex mcp-server 命令及独立 codex-mcp-server 二进制已移除，启动它们的集成应在升级前完成迁移。旧页上的 MCP 工具参考和 Agents SDK 示例也不再受支持，不能继续当作当前接入说明。
发布记录给出的顺序是2026年8月24日弃用、2026年9月5日宣布移除。官方这些说明没有标出首次包含移除的精确 CLI 版本，也不能据此断言所有旧安装都已被远程停用。
先在编辑器配置、服务启动项和自动化脚本中找这两个名称，再记录实际安装版本、命令参数与错误正文。仅看到 MCP 字样还不能判定受影响；一次连接失败也不足以推断账号、套餐或地区被封锁。
外部 MCP 工具仍可用：迁移对象要先分清
旧入口把 Codex 暴露给外部 MCP 客户端；codex mcp 则用于管理 Codex 连接的外部 MCP servers。官方明确后者继续支持。若启动失败的是数据库、搜索或其他下游工具，应先查那个工具的配置，不要一并删除所有 MCP 连接。
App Server 面向需要认证、会话历史、审批和流式代理事件的集成，使用自己的 JSON-RPC 协议。它不是标准 MCP server，也不是普通 MCP 客户端的直接替代；宿主若只会发 MCP 工具调用，就需要改接入层。
例如，假设一个 IDE 原来把 codex mcp-server 当作工具进程启动，直接换成 codex app-server 仍不会让旧 MCP 握手变成有效请求。这个例子只是说明协议边界，迁移是否成功要由该 IDE 的实际客户端能力确认。
自建客户端怎样连接：先握手，再开始线程
当前文档默认使用 stdio，以逐行 JSON 传送消息；App Server 支持双向 JSON-RPC 2.0，但线上消息省略 jsonrpc 字段。不要沿用旧 MCP 请求形状，也不要仅凭进程还在运行就判断接入完成。
每条连接先发送 initialize，再发送 initialized 通知；完成握手后才调用 thread/start 或 thread/resume，以及 turn/start。初始化前发送请求会得到 Not initialized，重复初始化会得到 Already initialized，应按连接生命周期处理。
客户端还应保存线程标识并持续读取通知。可用本机版本的 generate-ts 或 generate-json-schema 生成匹配的类型与模式；这些输出对应生成它们的 CLI 版本。任务自动化或 CI 场景，官方另建议使用 Codex SDK。
不是一次工具返回：审批和结束状态怎样接
启动或恢复线程后，客户端要持续处理 thread、turn 与 item 事件。turn/completed 的状态可能是 completed、interrupted 或 failed；收到终止事件不等于任务成功，更不代表结果已经通过你的质量检查。
命令执行或文件修改可能需要审批。服务器会主动发起 JSON-RPC 请求，客户端应按线程和轮次展示内容、回应决定，再处理 serverRequest/resolved 与 item/completed。不能把无人处理的审批当成网络卡顿，也不能默认全部允许。
遇到错误时保留消息及状态；若有上游 HTTP 状态，文档说明它会出现在相关错误信息中。队列过载的 -32001 应使用退避与抖动处理，不能对所有失败无限重试；中断、认证错误和权限拒绝应分别呈现。
能否用于上线：实验性、认证与监听边界
当前官方明确 App Server 命令及 WebSocket 传输为实验性，不支持生产工作负载。迁移推荐不等于稳定商用接口承诺，也不说明所有套餐、地区或账号都能使用同一模型；模型能力仍要按实际可用列表与访问条件核对。
认证说明允许现有本地或开源应用继续使用 App Server 认证，同时明确这种认证从未允许用于商业或托管服务。商业场景被引导至 Sign in with ChatGPT，应另按其规则核资格；不能把本页当作商用授权或免费额度依据。
远程监听还要独立保护：当前文档提醒，推广期间非回环地址默认没有认证，需显式配置认证并使用 TLS。普通 ws 仅用于本机或 SSH 转发；不要为排错直接公开无认证端口，也不要把令牌直接写进命令参数。
切换前后怎样检查：保留版本与可控回退
迁移前保留启动配置、已验证版本和负责人，只记录非敏感参数与日志时间。用不含敏感数据的隔离项目检查初始化、新线程、续接、允许与拒绝审批、中断、失败状态和退出，确认工作目录及权限没有被扩大。
如果线程无法恢复、审批没有界面承接、错误被吞掉或子进程无法退出，应停止扩大切换范围。回到已验证环境是为了恢复可控流程，不是保证旧入口长期可用；旧安装是否仍提供该命令，必须以那个版本的实际行为为准。
切换后继续观察线程恢复、待审批项和进程回收，再核对所用 CLI 版本与当前协议。DNS、TLS、代理认证和传输阻断可单独排查，但网络通畅不会把 MCP 请求自动转换成 App Server 协议，也不能解除认证使用限制。
资料来源
常见问题
旧命令是弃用还是已经移除？
当前官方明确已移除 codex mcp-server 和独立 codex-mcp-server。发布记录先记8月24日弃用，再记9月5日移除；首次包含移除的精确 CLI 版本未在这些说明中标出。
Codex 以后不能连接 MCP 工具了吗？
不是。官方明确外部 MCP servers 继续受支持，codex mcp 仍管理这些连接。移除针对把 Codex 本身作为 MCP server 启动的旧入口。
Claude Code 或 Agents SDK 中的旧 MCP 配置能照搬吗？
不能把旧 MCP 工具参考或旧 Agents SDK 示例当作受支持方案。先核对调用方当前支持的接入方式；需要接 App Server 的客户端必须适配其独立协议，不能只替换启动命令。
为什么启动了 App Server，第一条请求仍报错？
检查是否在同一连接完成 initialize 和 initialized，再发线程或轮次请求。初始化前请求会报 Not initialized，重复初始化会报 Already initialized；之后再按具体错误核对消息结构、认证与权限。
旧版本还保留命令，是否说明可以一直使用？
不能。旧安装的行为不等于当前支持承诺，官方已说明旧入口及示例不再支持。保留已验证环境可用于受控回退，但应安排迁移，不能承诺旧版本的长期可用性。
本地接通后可以直接开放成商业服务吗？
不可以据此推断。App Server 仍属实验性且不支持生产工作负载，现有认证也不允许商业或托管服务。远程监听认证、TLS、模型访问和相应接入资格需要分别确认。