文档开发者中心
我的

让 AI 助手直接帮你管 AGC 上架、评论和报表,顺便查鸿蒙官方文档

浏览55发布于2026-09-28 08:08福建

大家好。最近在 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 的同学也有用)

  1. Service Account 覆盖不全:评论与评分、PMS 商品、Android(v2)发布接口的文档只列了 API 客户端鉴权方式,用 Service Account 调会返回 401。两种凭据都配上最省心。
  2. 团队列表、应用简略信息仅限 OAuth:user-team-list 和 app-brief-info 只支持 OAuth 客户端(面向平台类开发者),权限开得再全也会 401。要列出所有应用,可以改用项目管理接口:先查项目列表,再对每个项目调 /api/project-service/v1/projects/{projectId}?queryFlag=1。注意,项目列表接口本身返回的 appList 是空的。
  3. 未上架应用查评论会报 50010028:错误信息是“应用不属于该开发者”,其实是因为应用还在审核中、没有正式上架,和权限无关。
  4. PMS 接口的 appId 要放在请求头里,不是 Query 参数,否则返回 400。
  5. 报表的 fileURL 大约 5 分钟后过期(签名里是 X-Amz-Expires=300),拿到后要尽快下载。
  6. 软件包是异步解析的:文档建议传包后等待约 2 分钟再提交发布,可以先查软件包编译状态接口确认解析完成。
  7. 站点域名要一致:德国、新加坡、俄罗斯站点的应用,获取 Token 和调用接口都要用对应站点的域名。

最后

这是个人开源项目,与华为官方无关。目前我在自己的几个鸿蒙应用上用它查看审核状态、评论和报表。如果你在使用中遇到问题,或者有想要的功能,欢迎在 GitHub 提 Issue 或 PR,也欢迎在帖子下面交流。

GitHub:https://github.com/chen2he/agc-connect-mcp

收藏
0
回复
0
分享
全部评论
暂无评论
暂无评论
写评论
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。
发表
我要写文章
目录 收起
大家好。最近在 AI 编程工具里写鸿蒙应用时,总要切到 AppGallery Connect 控制台去看审核状态、传包、回评论、导报表,来回切换很打断思路。于是我基于 AGC 的 Connect API 写了一个 MCP 服务,把这些操作交给 AI 助手来完成:
它能做什么
三步上手
一些设计
踩坑记录(可能对直接调 Connect API 的同学也有用)
最后
了解社区公约,与您携手共创和谐专业的开发者社区。