远程 MCP 工具已经返回，为什么 ChatGPT 里还是看不到

远端服务正常，不等于客户端拿到新工具

在一次将 ChatGPT 与远程 BodySense 开发环境连接起来的实践中，目标是让代理能够读取项目文件、执行受控的开发操作。最让我困惑的是：远端 MCP 工具清单已经能返回需要的命令工具，但 ChatGPT 的应用操作列表里仍只有旧工具。

这类问题特别容易让人反复重启服务器；但要先确认故障落在哪一层。

三次定位，实际上是三种不同问题

最初的运行时把文件工具和命令工具拆成两条注册命令，客户端桥接只登记了其中一条。改成统一的工具聚合端点后，才有机会在同一份 tools/list 中看到两类工具。

第二层是工具 schema 与消费端的兼容性。原始笔记记录了对 tools/list 结果和元数据字段的检查；即便服务能返回工具，也不代表客户端一定接受整份工具定义。

第三层更容易忽略：ChatGPT 当时已发布的自定义 App 保留了旧操作快照。重新连接或重新安装旧 App 时，仍然看不到新增命令工具。后来我新建并发布了应用，工具才在客户端出现并可用。

对这段经历最有用的总结

调试 MCP 时，可以把证据依次拆开：服务端是否导出工具、桥接协议是否如实传输、客户端的应用注册是否重新采集工具定义。不要把“健康检查 200”误当成“用户已经能调用新增工具”。

本文不公开远端主机、用户目录、App 标识、Tunnel ID、凭据、可执行命令的实际权限范围或内部网络边界。尤其是具备文件写入与命令执行能力的 Agent，需要比“能连通”更严格的授权和范围控制。

时间边界： 这是一份 2026 年的历史兼容性记录，不能据此断言所有当前版本的 ChatGPT 都采用相同的操作刷新规则。