> Agent Publishing

不离开 AI 会话，游戏直接上线

你刚和 agent 一起写完一个游戏。不用导出、打包、填表单——直接对它说 「发布」。AIGameShare 提供托管 MCP server 和 REST API：在 Claude Code 里一句话，游戏就上线到可分享的链接，自带游玩数、点赞和排行榜。

1 · 获取 API Token

下面所有方式都用同一个个人 token 鉴权。创建一次、妥善保管——它会以你的账号发布游戏。

2 · 接入你的 Agent（MCP）

AIGameShare 是一个托管 MCP server。接入一次，你的 agent 就多了三个工具：publish_game、update_game、list_my_games。之后发布游戏只需要一句话。

添加 server（一条命令，任意项目）：

claude mcp add --transport http aigameshare https://www.aigameshare.com/mcp --header "Authorization: Bearer ags_YOUR_TOKEN"

然后直接对 Claude 说：

「把这个游戏发布到 AIGameShare，标题和描述帮我写好。」

Claude 会读取游戏文件、写好元数据、调用 publish_game，并回复线上试玩链接。迭代时说「把新版本更新到已发布的游戏」即可。

3 · 验证成功

发布成功会返回 playUrl，立即可玩——打开它，或拉一下列表：

curl https://www.aigameshare.com/api/v1/games -H "Authorization: Bearer ags_YOUR_TOKEN"

参考

MCP 工具

  • publish_game — title + description + (html | zip_base64) → 线上试玩链接。可选：slug、category、tags、controls、ai_model、ai_tool、device_support、leaderboard_*。
  • update_game — game_id + html / zip_base64 / title / description / controls / tags 任意组合。游玩数、点赞、排行榜在更新后保留。
  • list_my_games — 你账号下游戏的 id、标题、链接、游玩数和点赞。

REST 端点

  • POST /api/v1/games — publish (JSON or multipart)
  • PUT /api/v1/games/{gameId} — update build / metadata
  • GET /api/v1/games — list your games
  • POST https://www.aigameshare.com/mcp — MCP (Streamable HTTP)

限制与沙箱规则

  • 单 HTML 文件最大 2MB；zip 包最大 10MB，必须包含 index.html。
  • 游戏运行在 opaque origin 的沙箱 iframe 里：外部网络请求被拦截，localStorage 跨会话不保留。
  • 持久化分数请用内置排行榜：在游戏里调用 window.AIGameShare.submitScore(value)。排行榜默认开启（key: score，高分优先）——竞速类用 leaderboard_value_type: "time_ms" + asc。
  • 内容需对全年龄友好。损坏或滥用的上传会被下架。

排障

  • 401 → Authorization 头缺失或错误。格式：Authorization: Bearer ags_...
  • 409 → 游戏 id 已存在。不传 gameId（我们会生成）或用 update_game 迭代。
  • 413 → 超出大小限制。压缩资源，或改用 zip 包。
  • 遇到重定向 → 始终直接请求 https://www.aigameshare.com（www 域名）。