#MCP 服务

把 Pushy 接进你的 AI 客户端（Claude Desktop、IDE、自建 Agent 等），让它直接查你的发布状态，再结合 GitHub、Sentry、CI 一起排查问题。全程只读，不会改动任何发布数据。

#典型场景

排查某台设备为什么没收到更新

我的应用（testApp）1.2.0 这个原生包，有台安卓设备一直没拿到更新，帮我看看

AI 会查出这个包当前绑定的版本、重放一次更新判定、检查增量产物是否就绪，然后告诉你卡在哪一步 —— 灰度没命中、包被暂停，还是补丁还没生成完。

发版前后确认状态

看下 1.2.0 现在发的哪个版本，灰度比例是多少

发版后看新版本稳不稳

昨天发的 1.2.4 有没有回滚？看下这个版本的 JS 报错，最多的那个还原到源码是哪一行

AI 会汇总这个版本的下发、下载失败、patch 失败、激活与回滚次数，列出该版本上报的 JS 报错，并用发布时归档的 sourcemap 把堆栈还原到源码位置（需开启 pushy:health:read，见下文）。

结合其他工具定位问题

这个版本昨天开始报错变多，对比一下 Sentry 上的异常和 Pushy 上的发布记录

#快速开始

#1. 创建令牌

在 Pushy 管理后台 打开「MCP 服务」，填写名称与客户端名称，勾选允许访问的应用，创建后立即复制令牌（只显示一次）。

授权范围默认包含 pushy:apps:read 与 pushy:diagnose，足够排查更新下发问题。如果还想让 AI 查看版本健康度与 JS 报错，需要额外勾选 pushy:health:read；已创建的令牌不会自动获得这项权限，需要重新创建。

#2. 让 AI 自己装（推荐）

把下面这段整段复制给你的 AI 助手（Claude Code、Cursor、Codex、Gemini CLI 等都可以），先把里面的令牌换成你自己的，它会自己找到配置位置并完成安装与验证：

请帮我在当前客户端里安装 Pushy 热更新的 MCP 服务。

服务信息（固定，不要改动）：
- 名称：pushy
- 传输方式：HTTP（Streamable HTTP，不是 stdio、不是 SSE）
- 地址：https://update.reactnative.cn/api/mcp
- 鉴权：请求头 Authorization: Bearer <令牌>
- 我的令牌：pushy_mcp_xxxxxxxx   ← 复制后把这里换成后台生成的令牌

请按下面的步骤执行：

1. 先确认我正在用哪个客户端（Claude Code / Claude Desktop / Cursor / VS Code /
   Codex / Cline / Gemini CLI 等），找到它对应的 MCP 配置文件或命令行。
   判断不出来就先问我，不要随便猜一个写进去。
2. 用该客户端的官方方式添加。有官方 CLI（如 claude mcp add、codex mcp add、
   gemini mcp add）就优先用 CLI；否则手改配置文件：改之前先备份，保留文件里
   已有的其他 MCP 服务，不要整个覆盖。
3. 如果这个客户端只支持 stdio，不支持远程 HTTP，就改用代理方式：
   npx -y mcp-remote https://update.reactnative.cn/api/mcp --header "Authorization: Bearer <令牌>"
4. 令牌等同密钥：优先写进用户级（全局）配置，不要写进会被 git 提交的项目文件。
   如果只能写在项目里，先确认该文件已在 .gitignore 中，并提醒我。
5. 装完做一次验证：列出 pushy 提供的工具，并调用一个只读查询（例如列出我有
   权限的应用），把结果贴给我。如果返回 401/403，说明令牌无效或没有勾选应用
   权限，告诉我去后台重新创建令牌，不要反复重试。
6. 最后一句话总结：改了哪个文件 / 执行了什么命令，以及需不需要重启客户端。

补充：这个 MCP 是只读的，只会查询发布状态，不会发版、不会改配置。

#3. 或者手动配置

以 Claude Desktop 为例：

{
  "mcpServers": {
    "pushy": {
      "type": "http",
      "url": "https://update.reactnative.cn/api/mcp",
      "headers": {
        "Authorization": "Bearer pushy_mcp_你的令牌"
      }
    }
  }
}

#4. 直接提问

连上之后按上面的场景提问即可，不需要记工具名。

#能查到什么

#注意事项

• 只读：不会发布版本、不会暂停应用、不会修改任何配置；
• 按应用授权：建议只勾选需要排查的应用；令牌可随时在后台撤销，立即生效；
• 数据去向：查询结果会返回给你授权的 AI 客户端，它可能继续发送给你选择的模型供应商 —— Pushy 不控制该客户端与供应商的数据处理策略；
• 返回内容不含邮箱、IP、设备标识、密钥与支付信息；
• 报错数据：报错消息、堆栈与源码片段来自你自己的应用代码，已去除 URL 参数、邮箱、IP 与形如 token= 的密钥，但仍可能包含业务上下文；captureException 传入的自定义上下文只返回字段名，不返回值；
• 限流：首次把某个报错还原到源码需要下载 sourcemap，按账号限制为每 10 分钟 30 次，超出时返回原始堆栈，已还原过的报错不受影响。