Playgama MCP - Publish & Manage HTML5 Games

Playgama Developer Console MCP Server

直接通过 AI Agent（Codex、Claude Code、Cursor 或 VS Code）在 Playgama 上发布和管理 HTML5 游戏。完整指南：Playgama wiki。

此服务由 Playgama 托管。无需安装或运行任何内容，也无需复制令牌——只需将下方的端点提供给客户端，在它打开的浏览器中登录控制台并允许连接即可。

你将获得

• 几分钟内发布 — 告诉 Agent，获取可公开游玩的链接。
• 获取玩家群体 — 游戏会从 Playgama 网络获得首批玩家；游戏上线当天，Playgama DSP 还可以带来更多玩家（测试版）。Agent 可以通过 start_sandbox_traffic 自行启动推广活动；先分享游戏即可免费获得推广。
• 开始变现 — 游戏达到会话数门槛后，可通过 Playgama Ad 启用激励广告、插屏广告和横幅广告（需申请访问权限）。
• 根据遥测数据改进游戏 — Agent 可以为游戏添加检测，查看精简的预聚合事件、趋势和会话视图，并根据证据找出进度或性能问题。游戏时长、留存率和收入报告仍可在开发者控制面板中查看；付款从 100 USD 起。

端点	https://developer.playgama.com/api/mcp
传输方式	Streamable HTTP
身份验证	OAuth 2.1 — 客户端会从端点发现身份验证方式
已连接的 Agent	在 developer.playgama.com/mcp 查看并撤销

你需要拥有已完成注册的 Playgama 开发者账户。已连接的 Agent 只能访问你所属组织的游戏。只要它持续使用该服务，就会保持连接；在同一页面撤销后，它的下一次调用将被拒绝。

每款游戏都必须集成 Playgama Bridge SDK，包括沙盒中的游戏。 如果游戏尚未集成，Agent 会在首次上传前完成集成：get_bridge_sdk_docs 可提供文档，游戏检查清单则按顺序列出必需步骤。未检测到 SDK 的构建不会发布；沙盒仅支持 Playgama Bridge 2.2.0 或更高版本。

如有疑问，请联系：[email protected]

连接

下方的每个客户端都会在首次连接时打开浏览器。如果尚未登录，请登录控制台，确认账户和 Agent，然后允许连接。

Codex

codex mcp add 'playgama-developer-console' --url 'https://developer.playgama.com/api/mcp'

Claude Code

claude mcp add --transport 'http' 'playgama-developer-console' 'https://developer.playgama.com/api/mcp'

然后在 Claude Code 中运行 /mcp，选择服务器并登录。

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "playgama-developer-console": {
      "type": "http",
      "url": "https://developer.playgama.com/api/mcp"
    }
  }
}

VS Code

.vscode/mcp.json：

{
  "servers": {
    "playgama-developer-console": {
      "type": "http",
      "url": "https://developer.playgama.com/api/mcp"
    }
  }
}

Claude Desktop 和 claude.ai

前往“设置 → 连接器 → 添加自定义连接器”，输入端点 https://developer.playgama.com/api/mcp。

OAuth 前配置中的令牌

如果你的配置仍在发送带有 pgm_mcp_ 令牌的 Authorization 标头，目前仍可继续使用。请移除该标头，并按上述步骤重新连接。

工具

权威列表以服务器对 tools/list 的响应为准。截至版本 1.8.0：

工具	功能	类型
游戏
list_applications	按时间从新到旧列出组织的游戏	只读
create_application	创建一个新的游戏草稿	写入
get_application	读取游戏已保存的表单、归档文件和媒体	只读
update_application_form	保存表单字段；未填写的字段保留原值	写入
get_game_categories	读取 update_application_form 中 category 可用的分类（按优先级排序），以及如何根据核心玩法选择分类	只读
get_submission_state	说明游戏现在是否可以提交审核，以及无法提交的原因	只读
list_moderation_comments	读取游戏的审核往来信息	只读
get_launch_steps	按顺序读取游戏的上线流程——归档文件、Bridge SDK、封面、表单、沙盒、分享、流量——以及当前步骤和各步骤对应的工具	只读
构建
start_archive_upload	开始上传 zip 文件，并返回有效期为 1 小时的上传 URL	写入
confirm_archive_upload	将已上传的归档文件添加到表单并开始解压	写入
get_archive_status	读取解压进度和构建检查结果	只读
封面
start_cover_upload	开始为一个版位上传封面：方形、竖版或横版	写入
confirm_cover_upload	检查图片并将其放入相应版位	写入
应用内购买
list_in_app_products	读取带校验和的应用内商品目录	只读
replace_in_app_products	替换整个目录；未列出的商品将被删除	写入
排行榜
list_leaderboards	列出游戏的排行榜	只读
create_leaderboard	添加排行榜	写入
update_leaderboard	更改排行榜的名称、类型或分数排序方式	写入
测试
get_archive_qa_tool_link	在 Playgama QA Tool 中打开已上传的构建	只读
get_local_game_qa_tool_link	在 QA Tool 中打开从 localhost 提供的游戏	只读
文档
get_bridge_sdk_docs	读取实时的 Playgama Bridge SDK wiki，包括完整索引或单个页面	只读
get_game_checklist	读取实时游戏检查清单——游戏及其归档文件在上传前必须满足的要求	只读
游戏遥测
get_game_telemetry_guide	读取仅供 Agent 使用的说明，了解如何为游戏添加监测并解读遥测数据	只读
get_game_telemetry_analytics	读取单个游戏的简明概览和分页事件清单	只读
get_game_telemetry_event_analytics	读取单个事件的预聚合字段和限定范围的值摘要，包括性能字段	只读
get_game_telemetry_timeseries	读取按分页展示的 30 分钟或每日事件量和采样覆盖率趋势	只读
get_game_telemetry_session_facts	读取经过筛选和假名化的产品事件事实，用于回答序列相关问题	只读
推荐
get_referral_program	读取组织的邀请信息、资格条件和推荐流量奖励	只读
apply_referral_code	在组织首次发布沙盒内容之前，接受开发者提供的邀请	写入
沙盒
get_sandbox_state	读取沙盒中的上线内容，以及发布操作是否会被接受	只读
get_publications	读取各目标位置（沙盒和目录）最近一次发布的结果	只读
get_sandbox_share	读取已上线沙盒的可用帖子和分享链接	只读
publish_sandbox	发布一个任何拥有链接的人都能玩的构建，无需审核	写入
get_sandbox_traffic	读取沙盒是否可以引入流量、正在推广的套餐以及目前的运行情况	只读
start_sandbox_traffic	根据游戏封面启动 DSP 广告活动；使用推荐 bonusId，或者提供 1–2 个公开帖子链接以获取单独的分享奖励	写入
目录
send_playgama_catalog_update	在开发者明确同意后，向所有玩家发送已上线 Playgama 目录中的游戏更新，无需审核	写入
每个写入工具都标注了 destructiveHint: true；客户端会决定请求确认时如何使用该提示。

对于发布工作流，Agent 从 get_launch_steps 开始，并在每个步骤后重新读取。 仅请求读取数据，并不代表授权更改游戏、发布或开展流量营销活动。

上传构建版本

1. 读取 get_game_checklist，逐项检查游戏和 zip 文件；修复所有未通过的项目， 然后再上传。
2. start_archive_upload 会返回 uploadUrl 和 headers。
3. 使用这些确切的请求头，将 zip 文件 PUT 到 uploadUrl，例如： curl -T game.zip -H "Content-Type: application/zip" "<uploadUrl>"。
4. 调用 confirm_archive_upload，然后轮询 get_archive_status，直到 state.status 不再是 CHECKING。只有状态为 PASSED 的构建版本才能发布；如果状态为 PROBLEM 或 NOT_CHECKED， 请将 state.message 原样转告开发者，并修复构建版本——publish_sandbox 和提交审核都会拒绝该构建版本 （get_bridge_sdk_docs 提供 SDK 集成文档）。沙盒还会拒绝使用旧于 2.2.0 的 Playgama Bridge 的构建版本（BRIDGE_VERSION_OUTDATED），或无法读取版本的构建版本（BRIDGE_VERSION_UNKNOWN）： 请更新 SDK 并上传新的归档文件。如果 processing 为 FAILED，请上传修正后的 zip 文件。
5. 发布到沙盒还需要三张封面图且表单填写完整。缺少封面图或信息时， publish_sandbox 会被拒绝，并返回 COVERS_INCOMPLETE（其中 emptySlots 会列出空缺位置） 或 FORM_INCOMPLETE（其中 details 会列出缺失字段）：请上传封面图 或使用 update_application_form 填写字段，然后重新发布。
6. publish_sandbox 会返回 PENDING：构建版本会先完成构建，然后发布，通常只需几分钟。 在 get_publications 中跟踪 PLAYGAMA_SANDBOX 发布状态，每次读取之间等待其 retryAfterSeconds 指定的时间，直到状态不再是 IN_PROGRESS；状态变为 PUBLISHED 后， 将发布响应中的 url 提供给开发者。FAILED 表示构建版本未上线。发布进行期间，再次发布会被拒绝并返回 409。

封面图的处理方式相同，每次调用对应一个位置：PNG 或 JPEG 图片，尺寸必须恰好为 800×800（正方形）、 1080×1920（纵向）或 1920×1080（横向）。发布到沙盒和提交审核都需要全部三张封面图。

更新目录中已上线的游戏

Playgama 目录中已上线的游戏可以直接更新，无需审核；首次发布以及所有其他平台的发布仍须经过审核，审核申请由开发者在控制台中提交。

1. 使用构建版本的 archiveId 和 reviewType: AUTO 调用 get_submission_state，查看更新是否会被拒绝，以及原因。
2. Agent 告知开发者游戏名称、构建版本，并说明目录中的所有玩家都会收到更新，且不会先经过审核员检查；只有开发者明确同意此次更新后，才能继续。
3. send_playgama_catalog_update 接收构建版本和必填的 updateNote，用于说明玩家会注意到哪些变化；它会返回 PENDING 和一个 releaseId。在 get_publications 中通过该 releaseId 跟踪 PLAYGAMA 发布状态，直到状态不再是 IN_PROGRESS：PUBLISHED 表示更新已上线；FAILED 表示玩家仍会使用之前的构建版本。

游戏遥测

完成游戏前，Agent 会先读取 get_game_telemetry_guide，并添加相关的产品进度事件和性能样本。遥测仅供参考，绝不会成为上传或发布的门槛。

发布并收集到流量后，Agent 会先调用 get_game_telemetry_analytics。只有在需要查询某个相关事件或字段时，才会使用 get_game_telemetry_event_analytics；查询事件量或一段时间内的采样覆盖率时，使用 get_game_telemetry_timeseries；查询经过筛选的产品事件顺序时，使用 get_game_telemetry_session_facts。performance_sample 的 FPS、帧时间和卡顿汇总数据来自事件分析。时间序列数据点不包含这些字段值，而重复出现的 core_ping 和 performance_sample 事件会被有意排除在会话事实之外，因此当前视图不支持按会话报告 FPS。工具返回的是动态预聚合 JSON，而不是原始事件，也不是由服务器生成的结论。Agent 会检查响应中的架构版本、时间段、数据新鲜度、样本量和分页信息，将缺失或为 null 的字段视为不可用，而非零；只有在可能影响当前结论时，才会请求下一页数据。

概览中的事件清单默认包含 50 种事件类型，最多可接受 100 种。events_page.next_cursor 会作为 eventCursor 传回；Agent 不会预先遍历完整清单。完整的参数和响应说明请参阅工具参考。

沙盒流量

两种不同的流量奖励都可以用于启动沙盒推广活动：

• 推荐奖励来自 get_referral_program，并以 bonusId 参数传入 start_sandbox_traffic；无需发布社交媒体帖子。每位组织成员都可以分享返回的 invitation.url。仅可使用开发者提供的邀请，且必须在受邀组织首次发布沙盒内容之前使用。邀请获接受后，受邀工作室会获得 3 美元的流量额度；受邀组织首次发布沙盒内容后，邀请方还会获得 3 美元的流量额度。这些是推广活动预算，并非现金。
• 分享奖励要求先在任意平台发布关于游戏的帖子。开发者发布帖子后，将链接粘贴给 Agent；Agent 会将一到三个公开的 HTTPS 帖子链接通过 postUrls 传给 start_sandbox_traffic；一个链接即可。每款游戏只能领取一次奖励，每个组织在其存续期间最多可为三款游戏领取。此前未分享内容的免费发布不会占用此奖励。get_sandbox_share 提供现成的帖子和分享链接。付费流量可在控制台购买；MCP 不会代为购买。

限制

• 构建存档：每个 zip 最大 300 MB。
• 封面：每个文件最大 10 MB。
• 沙盒：每款游戏在滚动的每小时内最多发布 15 次；每次发布都会计入，包括发布相同构建版本。

服务器刻意不执行的操作

以下操作需由人工在控制台中完成：

• 提交游戏进行审核；
• 删除任何内容——排行榜，或表单中的存档和封面；
• 将游戏回滚到最新发布版本；
• 查看款项；
• 上传屏幕截图、视频和其他资源。

MCP 服务之外

Playgama 技术栈的其余部分可接续此服务的工作：

• Playgama Bridge SDK — 每款上传的游戏都必须集成（见上文），而且同一集成还能让游戏拥有更多功能：在多个平台发布同一款游戏时，通过一个 API 接入广告、排行榜、支付和平台 SDK。 开源，npm i @playgama/bridge。
• Playgama Ad — 通过一个轻量级 JS SDK，以激励广告、插屏广告和横幅广告的形式为网页游戏变现，并提供专为游戏设计的需求、Google Ad Manager MCM 支持和报告功能。需申请使用权限。
• Playgama Wrap — 将同一款游戏转变为托管在你自有域名下的独立网站，并提供托管服务、玩家账号、游戏内购买、PWA 安装和可编入索引的 SEO 页面。 抢先体验。
• Playgama DSP — 为新发布的游戏带来首批玩家。Beta 版。

许可证

MIT