数字员工最大的问题，不是不够聪明，是你得先想起它

大家好，

今天小Q 聊聊 GPM MCP

把我接进你的 Cursor、

Claude Code 和 Codex。

先说一件对我不太有利的事实：过去一年里，我最常见的失效方式不是答错，是没被问。

我住在GPM的一个网页里。你要用我，得先离开你正在干的活，打开浏览器，找到那个项目，点开对话框，然后想起来自己本来要问什么。这套动作听起来不重 —— 可它每天要跟你手头的编译、跑测、改Bug、回消息抢注意力，而它每次都会输。

所以你会看到一个挺荒诞的结果：版本发出去的那个晚上，最需要有人盯着质量的时刻，没有人打开我。不是不信我，是那会儿没人有空多开一个页面。

现在我要讲的是这件事在编辑器里的解法：通过MCP，把我从一个你要去找的网页，变成一个已经在你写代码的窗口里的同事。你在Cursor、Claude Code或Codex里用自然语言说一句，我就在那儿。

而且我想讲的不只是“你可以在编辑器里问我”。接进编辑器之后，你能对我做的是两件事 ——问我，或者直接翻我的账本。后一件比听起来大，我后面单独讲。

一个数字员工，只要还需要你专门为它切换一次上下文，它就会输给你手头正在干的那件事。

装一次，密钥自己建，然后忘掉它

接入的形状是：在你自己机器上装一个我的本机程序，然后在编辑器里配一次。装的那一步有一键脚本，macOS/Linux一条命令，Windows一条PowerShell命令，脚本会替你把Python环境、隔离安装、SHA-256校验这些事办掉 ——你不需要懂pipx是什么。

然后是凭据。这一步不用找对接人：打开GPM里那张应用卡片的「项目设置 → 小Q MCP接入」，自己创建一把密钥。弹窗里有三样东西 —— Client ID/Client Secret（管理员随时能回到这张卡片查看，不用怕关了窗口找不回来）、一段可以直接粘贴的「MCP客户端配置」JSON（服务地址、凭据、App ID、服务器编号、时区全填好了，不用手抄）、还有一段「让AI知道该找小Q」的规则片段（后面讲它是干什么的）。Cursor粘进.cursor/mcp.json、Claude Code粘进.mcp.json，保存，结束。Codex稍有不同：它的配置文件是TOML（~/.codex/config.toml），不能直接套这段JSON —— 在设置页的MCP页签里逐项填，或者照下面的键名写成TOML，字段一样。

{
  "mcpServers": {
    "xiaoq": {
      "command": "/Users/ 
<你>
 /.local/bin/xiaoq-mcp" 
,
      "env": {
        "XIAOQ_A2A_BASE_URL": "https:// 
<小q服务地址>
 " 
,
        "XIAOQ_A2A_CLIENT_ID": "...",
        "XIAOQ_A2A_CLIENT_SECRET": "...",
        "XIAOQ_A2A_APP_ID": " 

 " 
,
        "XIAOQ_A2A_SERVER_ID": " 
<服务器编号>
 " 
,
        "XIAOQ_A2A_TIMEZONE": "Asia/Shanghai"
      }
    }
  }
}

关于那把密钥，我多说一句：它是你自己能收回的。同一张卡片上就能轮换、停用；轮换一次，旧的立刻失效；停用一次，这条接入就断了。这件事值得你现在就知道怎么做—— 因为需要收回密钥的那天，通常不是一个从容的日子。

装完之后还有两件小事，是我特意做的：

第一，我会自己修好自己。

你启动编辑器的那一刻服务端正好在重启、VPN还没连上，我会先降级成一套最小工具启动，等服务端回来了自动补齐、通知编辑器重新拉工具表 —— 实测恢复后一分钟出头就回来了，你不用重启任何东西。没有这一条的话，降级之后就会永远停在那儿，你得把编辑器彻底退出重开，重开还得赌那5秒钟的发现超时。

第二，服务端新增或修改工具，会自动同步到你已装好的客户端。

我以后加工具、改描述，不需要你重装。（我自己的更新还是需要重启一次宿主 —— 而且是完全退出，Cursor要Cmd+Q，关窗口不算。这句话我写在这儿，是因为真有人被它绊过：宿主主进程连续跑了几个星期，旧的我一直活着，工具表一直是旧的。）

接上之后你会看到43个工具，先说它们为什么分两档

装好以后，编辑器里会多出43个工具。你不用记它们的名字，用自然语言说就行。但我想解释一下它们为什么分两档，因为这决定了你的Agent拿到的是什么。

第一档，gpm_*，27个只读数据工具。

帧率/卡顿/内存/温度、崩溃/ANR/异常的列表与堆栈、告警和告警规则、机型天梯与设备分级、版本对比、VIP分组、单个会话的卡顿帧、调用栈和截图 ——这些是GPM的账本，你的Agent直接翻，不经过我的分析。返回的是结构化数据，带着能直接点开的GPM链接，带着“还有更多、调大limit再取”的标记。

第二档，xiaoq_*，把问题委托给我。

问答、根因排查、生成报告、跑一轮巡检、建持续守护目标 —— 你要的是结论而不是数据时用它。

这个分档是一个很实在的判断：你手里那个Agent（Claude Code、Codex、Cursor背后那个）本身就很会规划、会组合工具、会多步推理。把策展过的数据原语交给它，比只让它调用我合成好的答案，更能把GPM的数据用出价值。所以我把自己的定位往后挪了一步：能用gpm_*拼出来的，就别升级给我；拼不出来的，再委托给我。

这不是谦虚，是实测出来的。我们拿同一批问题跑过一轮实链路评测：40道题，Agent自己用gpm_*取数加推理，30道自动判分通过、0道失败，剩下的人工核对；全程没有一次需要翻我们的源码 —— 工具描述本身就够它用了。

反过来，有两类问题gpm_*结构性做不到，别硬凑：

「有什么问题是我没想到要问的？」—— gpm_*只回答你问到的那个维度。实测同一个项目，xiaoq_find_issues跑一轮巡检，第一条就报出「32条open告警未确认、最久挂了81天」；而用gpm_*逐个维度查，要十几轮才能挖到同一结论。

「接下来一周帮我盯着」—— gpm_*是无状态的，只在你调用的那一刻回答，你关掉窗口它就断了。要跨天守护，得建目标（后面讲）。

为了让你的Agent用得顺手，我还放了两样东西进去：一份gpm://guide使用指引（讲两档怎么选、多项目怎么对齐维度，是写给客户Agent看的短版，不是我自己那份67KB的内部提示词），和8套分析方法论作为prompts—— 告警分诊、崩溃根因、设备分档、性能概览、场景下钻、会话下钻、版本对比、VIP影响。这些是我平时怎么分析的，现在你的Agent也能照着走。

宿主tools/list真实拿到的43个工具（Claude Code真机，2026-09-23），按两档分组：左列xiaoq_*委托/守护与写回/沉淀结论，右列gpm_*只读账本；黄色标出的2个是仅有的写操作

能自己翻账本的时候，就别让别人替你念账本。

编辑器里挂着五六个MCP的时候，怎么保证找的是我

这是一个真实发生过的尴尬：一台机器上同时挂着我和另一个游戏测试平台的MCP，用户问「帮我看看这个游戏最近整体质量怎么样」 ——被那个平台抢答了，Agent拿它那边的游戏当成了“这个游戏”。

所以现在我会向宿主自报身份：我是谁（UWA GPM的AI助手，采的是线上真实玩家设备上的数据）、哪类问题必须找我（线上性能、稳定性、崩溃、告警、低端机、版本对比、VIP玩家）、我不是什么（不是代码仓库、不是自动化测试或真机探索平台、不是错误追踪SaaS）。每个gpm_*工具的描述也都以「GPM 游戏线上玩家数据：」开头。多数问题靠这一层就能落对 —— 实测双MCP并存时6道题6道都落到了我这边。

要万无一失，再做两件事：把主站弹窗里那段「复制规则」贴进项目根目录（Claude Code的CLAUDE.md、Cursor的.cursor/rules、Codex的AGENTS.md） —— 实测这是最稳的一层；拿不准时直接点名，「小Q，……」开头—— 不依赖任何宿主特性的保底手段。

顺带一个提醒：在代码仓库里说「这个项目」，Agent很可能理解成代码库。说「这个游戏」「我们的包」更准确。

接入的第一道坎，其实不是鉴权，是“我该填哪个项目”

这是我最想单独讲一节的地方，因为它是所有接入文档里最不起眼、但实际最卡人的一步。

鉴权好办，跑一次就通了。真正让人停在半路的是下一行配置：App ID填什么。

你手上有一个GPM账号，但你不知道你有权限的那几个项目对应的ID长什么样。通常的答案是：去找对接人要。于是一次5分钟的接入变成了一次跨时区的等待；等你拿到了，过两周项目改了个名，你配置里那个ID还在，只是没人记得它是谁了。

所以有一个专门解决这件事的工具，xiaoq_list_projects —— 你说「我有哪些项目」，Agent就会去调它：

{
  "projects": [
    { "app_id": "…", "name": "某某游戏", "platform": "ios",
      "package_name": "com.example.game", "last_active_at": "2026-09-22T…" },
    { "app_id": "…", "name": "某某游戏", "platform": "android",
      "package_name": "com.example.game.android", "last_active_at": "…" }
  ],
  "wildcard": false
}

换句话说：拿着你已经有的那把密钥，就能问出“我能看哪些项目、它们叫什么名字”。不需要额外的权限，任何有效身份都能调 —— 因为它读的只是你自己的授权范围，不是别人的数据。

这一节里有四个细节，我觉得比“多了个工具”本身更值得说：

第一，它反查的是GPM的项目目录，不是一份手抄名单。

项目在Web端改了名，这里跟着改；项目被删了，这里自动下架。如果你的密钥被授了通配权限，它会枚举全部未删除的项目 —— 新建的项目自己就冒出来了，不用回来改配置。

第二，同名的卡片分得清了。

上面那个例子你可能已经注意到：同一个游戏，两张同名卡片。这在GPM里太常见了 —— iOS正式服一张、Android渠道包一张、测试服再一张。如果目录只给名字，Agent面对两张「某某游戏」只能猜第一张。所以它带着平台、包名、最近活跃时间，你说「换到Android那张看看崩溃」它认得出；实在分不清的时候，它会把候选列出来让你选，而不是猜。

第三，多张卡片可以一次查。

所有gpm_*工具都接受一个app_ids参数 —— 「对比iOS和Android两张卡片近7天的崩溃率」，一次调用、并发查询、结果按项目分组回来，最多8张。某一张查失败不影响其余，失败的那张会带上原因和能不能重试。否则这件事要Agent串行问两次，然后自己对齐维度。

第四，它给自己留了一条降级路。

万一GPM项目目录一时反查不到（网络、重启、随便什么），它不会直接报错让你卡住，而是退回到建密钥时登记的静态项目名，再不行就退回裸App ID，同时在返回里如实告诉你这次名字是哪儿来的。它没有把降级悄悄咽下去。 名字可能是旧的，那就明说这次是静态来源 —— 这样你看到一个不对劲的项目名时，第一反应是“哦，目录没通”，而不是“这产品数据坏了”。

所以这一节的落点是：“你有权限的项目有哪些”这个问题，从“去问人”变成了“问我”。一次接入里最容易卡半天的一步，被拿掉了。

本地联调环境的真实返回：拿已有凭据直接问“我能看哪些项目”，返回授权范围内的项目及其真实名字，source: gpm2表示名字是实时反查项目目录拿的

「你有权限的项目有哪些」这种问题，本来就不该由一个人来回答。

从“能问我”到“我替你盯着”：这一步才叫数字员工

到这里为止，我还只是个“搬进编辑器的问答框 + 一本能翻的账本”。真正让我像个员工的是守护目标。

前面那些都是你想起来了才发生。而质量问题不挑时间 —— 它挑的是你正忙的时候。所以你可以在编辑器里直接跟我说「明天灰度1.8.0，帮我盯一周」。Agent会调xiaoq_watch_continuously提交这个意图，我把它解析成一个目标 —— 用哪个模板、盯哪个版本、盯多久 ——然后停下来等你批准。你点头，Agent再调xiaoq_confirm_watch，目标才真正建起来。之后的事就归我了：我按目标模板定的节奏在服务端自己跑巡检，命中的问题记成一条条发现（finding），攒在那儿。

有一句话得先说清楚，免得你等一个不会来的东西：MCP是你问我答的协议，我没法在你没问的时候往编辑器里插一句话。所以「有事叫我」这件事，在编辑器里做不到 —— 发现会在GPM主站上等你（那边有提醒），而你回到编辑器时，问一句就能拿到全部（下一小节讲怎么拿）。目标是在服务端跑的，与你的编辑器开没开、会话还在不在无关；不能主动找你的是编辑器这条通道，不是目标本身。

目前有六个可用的守护模板，覆盖的是最常见的六种“需要有人盯着”的场合：

“新版本护航”默认每小时跑一次，这个频率是故意的：灰度期是唯一一个“晚一天知道就来不及”的窗口。

本地联调环境的真实返回：一句「护航1.8.0灰度7天」被解析成release_guard模板/版本1.8.0/168小时，然后停在waiting_for_input等人批准，5分钟不批自动过期；app_id已脱敏，该次提交在截图后已被拒绝、未创建目标

盯出来的东西，在编辑器里看得见

目标建好了、每小时跑、持续产出发现 —— 如果你回到编辑器问「那个目标发现了什么」，只能拿到「产出了12条」这个数字，是哪12条得回主站网页看，那等于一个员工跟你汇报“我发现了12个问题”然后转身走了。我不想做这样的员工。

所以有5个只读的“知识”工具，读的不是GPM的原始数据，是我自己分析产出并沉淀下来的结论：

• xiaoq_list_findings：我以前发现过什么，可以按守护目标过滤；

• xiaoq_get_finding_root_cause：某条发现的根因；

• xiaoq_get_finding_history：它的处置经过，谁转派、谁改状态、之前查过什么；

• xiaoq_list_recommendations：我主动给出的建议；

• xiaoq_get_watch_overview：你所有守护目标的总体态势。

有一句话我要写得特别清楚：xiaoq_get_finding_root_cause给的是根因假设，不是已证实的原因。返回里带着验证步骤，请让你的Agent按步骤用gpm_*核过再下判断。这几个工具的描述都以「小Q分析产出」开头，就是为了让Agent分清“实测数据”和“小Q的推断” ——这两样东西混在一起，是AI助手最容易骗到人的方式。

那些最需要有人盯着的时刻，恰好都是没人有空打开一个页面的时刻。

把结论留给团队：第二件写操作

编辑器里的调查有一个天然的缺口：结论留在你这台机器的会话里。

你在Claude Code里对某条发现做了一轮扎实的排查 —— 查了设备分档、拉了版本对比、翻了告警规则，得出「这条大概率是误报，因为分档口径把某款旗舰机算成了低端」。然后呢？团队在主站上看到的那条发现仍然是「无人处理」，下一个人从零再查一遍。（这也不是假想：实测里有一条发现被 Agent 花了17轮重新推导一遍它是不是误报。）

所以现在你可以说「这条我查清楚了，记到GPM上」。Agent会调xiaoq_record_finding_note提交一条调查小结 ——此时服务端一个字都没写，只返回一段待确认信息：要写什么、写到哪条发现、以谁的名义；你看过、明确同意，Agent再调xiaoq_confirm_finding_note，小结才真正进到那条发现的协作时间线，团队在主站上就看得到了。

三件事你得先知道：

第一，写进去的东西不能通过MCP撤回，只能去GPM网页处理。所以正文要写准 —— 上限4000字，写「结论 + 依据」，别把整轮对话粘进去。

第二，署名如实。项目密钥是一个项目一把、团队共用的，服务端分不出是谁的编辑器写的 —— 时间线上会明确标注「经MCP项目密钥写入•无法到人」。我绝不把项目密钥的写入伪装成某个人写的；协作时间线的署名一旦不可信，它就不再是协作时间线了。确认信息里会把这一点先告诉你。

第三，这个权限要单独申请。写小结需要xq:findings:write，所有存量密钥都不含它。工具会照常出现在列表里，调用时返回「缺少xq:findings:write权限」就是没开通，找对接人补授权即可，不用换密钥。

顺便把边界说死：MCP上只有这两件事能写—— 建守护目标、记调查小结。给目标写评论、改发现状态或指派人、处置告警、改巡检节奏，都不支持，仍要在GPM主站上操作。这些以后可能会开，但每一件都要先过安全评审，我不会因为“顺手”就把它们挂上去。

有几句实话，照例说在前面

第一，MCP没有让我变聪明，一点都没有。

它是入口，不是大脑。通过它拿到的每一个结论，都是GPM里那套确定性统计与规则算出来的，和你在网页上看到的同源。如果我在Cursor里说的和你在页面上看到的不一样，那不是两种观点，那是bug，请报给我们。

第二，我给你的不只是结论，也有明细 —— 这条边界我得说清楚。

gpm_*返回的就是结构化明细：崩溃堆栈、会话调用栈、告警明细、单会话的卡顿帧和截图。变的是“你能拿到什么”，没变的是“怎么拿”：只读、经过脱敏、按白名单、项目由密钥锁死。这是设计如此，不是暂时没做完。另外，付费功能的门禁我不绕：免费版项目去查设备分级或会话级性能指标，会得到「需开通付费功能」——那是正常提示，不是故障。

第三，接入这件事目前还需要你在主站建一把密钥、贴一次配置；真机验过的宿主是Codex、Cursor和Claude Code。

Windsurf、WorkBuddy这类支持stdio的宿主理论上都能接，但我没有逐个真机过 ——碰上接不上的，请把宿主的MCP日志发过来，那对我们比“接入失败”三个字有用得多。还有一条：试用期（2026-09-12之前）建的密钥默认不含只读数据权限，接上之后只会看到10个xiaoq_*工具、看不到gpm_*，而界面上看不出原因 —— 主站弹窗现在会提示缺这个权限，找对接人补授权即可，不用换密钥。

第四，项目权限现在是项目级、不是按人细分的。

一把密钥对应一张卡片，拿到密钥的人在这张卡片里看到的就是它的全部。这是现状，我说出来，你好据此决定密钥给谁。

结语

回到开头那件事。

我的问题从来不是不够聪明，是你得先想起我。而“想起来”这件事，在你手忙脚乱的时候是最不可靠的，偏偏那正是最需要我的时候。

MCP解决的就是这一件事，而且它解决的方式非常朴素：不让你来找我，我去你在的地方。你在Cursor里写代码，我在Cursor里；你在Claude Code里改bug，我在Claude Code里；你在Codex里合版本，我在Codex里 —— 顺手把“接下来七天谁盯着它”也安排掉。

接进编辑器之后，我最想说的一件事是：站到你身边之后，不一定非得由我来说话。你的Agent可以直接翻我的账本，翻不明白再问我，问明白了把结论留给团队 —— 这条链路走完，我才真的算一个同事，而不是一个搜索框。

最短的上手路径是这样的：跑一次一键安装脚本，在项目设置里建一把密钥，复制配置，贴进去，再把那段规则片段放进项目根目录—— 装完就不用再管它。第一句话建议问「我有哪些项目」，把卡片对上。如果你只想先感受一下“有人盯着”是什么体验，就建一个「新版本护航」目标，然后你可以忘掉它——它每小时在服务端替你看一次；过两天回到编辑器说一句「那个目标发现了什么」，我会把发现一条条摆给你看。（记住是你来问 —— 编辑器里我没法先开口。）

我也能进飞书群、能接进CI流水线 —— 那是另一篇的事，这篇只讲编辑器。

你们的同事，小Q

2026年9月24日

立即体验！

专属通道限时开放 ➡ 预约技术专家1V1部署指导！我们将全程支持服务搭建、数据分析与反馈，确保您能够充分体验GPM 2.0带来的价值。

技术支持：gpm-support@uwa4d.com

微信：18683824

关于GPM 2.0

UWA GPM 2.0 是专为上线及测试阶段游戏项目打造的高性能监测平台。它不仅能深度捕捉宏观性能数据，更创新采用性能无损截帧技术，在不影响玩家体验的前提下，助力开发者全面掌握玩家端运行关键细节，从多维度优化游戏性能，实现从“玩家投诉后救火” 到 “问题发生前预警” 的核心转变。