大家好。最近在 AI 编程工具里写鸿蒙应用时,总要切到 AppGallery Connect 控制台去看审核状态、传包、回评论、导报表,来回切换很打断思路。于是我基于 AGC 的 Connect API 写了一个 MCP 服务,把这些操作交给 AI 助手来完成:
它能做什么
装好之后,在 DevEco Studio(CodeGenie)、Claude Code、Cursor、VS Code、Trae、Codex、Gemini CLI 等支持 MCP 的工具里,可以直接用自然语言:
| 场景 | 可以这样说 |
|---|---|
| 查应用 | “列出我在 AGC 上的所有应用和审核状态” |
| 上架 | “把 entry-default-signed.app 传到 com.example.app,解析完成后提交审核,备注写‘修复若干问题’” |
| 评论 | “看看最近一个月的 1~2 星评论,帮我起草回复” |
| 评分 | “这个应用现在平均几分?一星主要集中在哪个版本?” |
| 报表 | “导出过去 30 天按国家分组的下载安装报表,哪几个地区增长最快?” |
| 其他接口 | “用 PMS API 创建一个 6 元的消耗型商品”“查一下还有哪些测试群组” |
| 查文档 | “Navigation 怎么跨包路由?给我官方示例” |
最后一行用的是华为官方的「鸿蒙开发者知识 MCP」。本服务已经把它整合进来,只装这一个就够,不配 AGC 凭据也能用文档检索。
三步上手
需要 Node.js 20.11 或以上。
1. 创建凭据
在 AGC「用户与访问 → API 密钥 → Connect API」创建:
- Service Account:类型选“开发者级”,会自动下载一个
*private.json。 - API 客户端(建议也建一个):项目保持 N/A,下载凭据 JSON。评论、PMS 等接口只支持这种方式,原因见下文“踩坑记录”。
2. 在 AI 工具里添加 MCP 配置
DevEco Studio、Cursor、Trae、Claude Desktop 等使用 mcpServers JSON 格式的客户端:
{
"mcpServers": {
"agc": {
"command": "npx",
"args": ["-y", "github:chen2he/agc-connect-mcp"],
"env": {
"AGC_SERVICE_ACCOUNT_FILE": "/path/to/service-account.json",
"AGC_CLIENT_FILE": "/path/to/api-client.json"
}
}
}
}
Claude Code 用一条命令:
claude mcp add agc -s user -e AGC_SERVICE_ACCOUNT_FILE=/path/to/service-account.json -e AGC_CLIENT_FILE=/path/to/api-client.json -- npx -y github:chen2he/agc-connect-mcp
VS Code、Codex CLI、Gemini CLI 等其他客户端的写法见仓库 README。
3. 验证
对 AI 说“检查一下 AGC 配置”,它会调用 agc_auth_status,逐一验证两种凭据是否可用。
一些设计
- 自动选凭据:同时配置两种凭据时,服务会按每个接口文档列出的鉴权方式自动选用,两种都支持时优先用 Service Account,不用自己记哪个接口支持哪种。
- 内置接口目录:整理了约 200 个 Connect API 接口(HarmonyOS 5+ 和 Android 两套)。AI 先查目录和参数文档,再发请求,不靠猜。没有专用工具的接口,也可以通过通用的
agc_request调用。文档正文在运行时从华为开发者文档中心拉取,保持最新。 - 写操作需要确认:提交发布、回复评论这类会对外生效的操作,工具说明里要求 AI 先征得你同意;设置
AGC_READ_ONLY=true可以彻底禁止写操作。 - 凭据安全:Service Account 的 JWT 在本地签名(PS256),私钥不会离开你的电脑;带凭据的请求只会发往
*.huawei.com。
踩坑记录(可能对直接调 Connect API 的同学也有用)
- Service Account 覆盖不全:评论与评分、PMS 商品、Android(v2)发布接口的文档只列了 API 客户端鉴权方式,用 Service Account 调会返回 401。两种凭据都配上最省心。
- 团队列表、应用简略信息仅限 OAuth:
user-team-list和app-brief-info只支持 OAuth 客户端(面向平台类开发者),权限开得再全也会 401。要列出所有应用,可以改用项目管理接口:先查项目列表,再对每个项目调/api/project-service/v1/projects/{projectId}?queryFlag=1。注意,项目列表接口本身返回的appList是空的。 - 未上架应用查评论会报
50010028:错误信息是“应用不属于该开发者”,其实是因为应用还在审核中、没有正式上架,和权限无关。 - PMS 接口的
appId要放在请求头里,不是 Query 参数,否则返回 400。 - 报表的
fileURL大约 5 分钟后过期(签名里是X-Amz-Expires=300),拿到后要尽快下载。 - 软件包是异步解析的:文档建议传包后等待约 2 分钟再提交发布,可以先查软件包编译状态接口确认解析完成。
- 站点域名要一致:德国、新加坡、俄罗斯站点的应用,获取 Token 和调用接口都要用对应站点的域名。
最后
这是个人开源项目,与华为官方无关。目前我在自己的几个鸿蒙应用上用它查看审核状态、评论和报表。如果你在使用中遇到问题,或者有想要的功能,欢迎在 GitHub 提 Issue 或 PR,也欢迎在帖子下面交流。





































苏公安网备 32011402010933号