开发者文档 · v1

接入文档

把 HTML5 游戏接入游隙,使用 MCP 完成上传、预览和发布。

正式平台:https://scalia.ltd。文档公开可读;上传、发布与账号管理需要站主授权。

推荐接入顺序

  1. 游戏项目接入适配器,配置可信平台来源,准备完整 HTML5 构建目录。
  2. 配置本地 MCP 客户端,由站主完成浏览器授权。
  3. 创建工作稿、上传文件并冻结候选,在站主后台检查私有预览。
  4. 明确发布指定候选,再检查详情页和实际游玩页。

给 agent 的入口

可将 文档索引交给 agent。每篇指南均提供 Markdown 原文;OpenAPI JSON 的动作参数与权限从当前代码合约生成。

添加站主

对方先注册并验证邮箱,主管理员再到后台账号管理查询完整邮箱,确认“添加为站主”。各站主使用自己的账号管理全站游戏、站点内容并授权 MCP。主管理员可移除或停用其他站主,旧授权随即失效。

当前能力

支持静态 HTML5 游戏、有限玩家资料、侧栏、防 Boss 、多个站主账号和独立管理连接。游戏自行管理运行、音频与存档;当前没有统一云存档或游戏后端登录令牌。MCP 客户端目前随项目源码提供,需要 Node.js 24 与项目依赖。

适用版本:游戏协议 v1 / 管理 API v1。示例中的 UUID、路径和修订号需要替换为实际值。