klyo games: publish HTML5 browser games

Klyo Games MCP

将 AI 助手接入浏览器游戏发布工作流。

检查文件 · 准备更改 · 诊断错误 · 审核发布

连接指南   ·   开发者工作室   ·   工具参考   ·   产品文档

---

项目简介

Klyo Games MCP 将兼容的 AI 助手接入 Klyo 托管的 HTML5 和 WebGL 游戏发布工具。它可帮助开发者处理游戏文件、预览构建、诊断报告、目录描述和版本发布。

此仓库包含文档、客户端配置和 Agent 技能。它并非 Klyo 托管后端的源代码，克隆此仓库也不会创建可自托管的发布平台。

连接

设置	值
远程 MCP 端点	https://panel.klyo.pl/mcp?profil=gry
传输方式	Streamable HTTP
交互式身份验证	OAuth，通过 Klyo 登录和授权流程完成
清单中的注册表标识符	pl.klyo/games
开发者控制面板	dev.klyo.pl

请使用支持远程 MCP 传输方式和所需身份验证方式的客户端。客户端功能、套餐可用性和工作区策略可能有所不同。有关各客户端的设置说明，请参阅维护中的连接指南。

账户所有者必须在工作室中接受开发者条款。助手不得代表所有者接受协议或编造内容声明。

示例：从 VS Code 连接

启用 MCP 支持后，在命令面板中选择 MCP: Add Server，选择 HTTP 服务，然后输入上述端点。查看信任提示并完成 Klyo 登录流程。

对于 VS Code 工作区格式，.vscode/mcp.json 可包含：

{
  "servers": {
    "klyo-games": {
      "type": "http",
      "url": "https://panel.klyo.pl/mcp?profil=gry"
    }
  }
}

请将此条目合并到现有配置中，而不要替换无关服务。不同的 Agent 客户端和配置格式使用不同的顶层键；这是 VS Code 格式，并非通用的 MCP JSON 文件。身份验证仍需单独完成。

VS Code 连接说明 · 配置格式

随附的客户端软件包

软件包	仓库文件
Claude Code 插件	插件清单、市场清单和.mcp.json
Gemini CLI 扩展	gemini-extension.json
发布技能	skills/publish-html5-game/SKILL.md
MCP Registry 元数据	server.json

技能提供操作说明；它不能替代 MCP 连接，也不会授予权限。安装客户端软件包也不会授予对其他开发者游戏的访问权限。

先进行只读检查

连接后，请向助手提问：

检查我的 Klyo 连接并列出我的游戏。不要更改文件或发布任何内容。

相关工具为 klyo_status 和 klyo_my_games。进行更改前，请检查返回的账户角色、允许的操作和游戏标识符。

对于已有游戏：

读取此游戏的文件和诊断信息。先解释问题并提出修复方案，再进行编辑。保持当前版本不变。

对于新项目：

阅读 Klyo 的生产要求，并向我展示合适的游戏骨架。先准备预览；发布前请征求我的同意。

工具的支持范围

工作内容	相关工具	边界
连接与发现	klyo_status、klyo_my_games	查看账户的实际能力。
规划与集成	klyo_game_requirements、klyo_game_scaffold、klyo_game_sdk	编写游戏代码前，先阅读当前生产环境的规范。
文件检查与编辑	klyo_game_files、klyo_game_patch	先读取；编辑时使用当前文件哈希。
软件包与版本	klyo_upload_package、klyo_publish_game、klyo_update_game、klyo_release_version、klyo_release_rollback	预览和审批不同于公开发布。
诊断与试玩	klyo_game_diagnostics、klyo_game_play	测量有覆盖范围限制；在设备上试玩需要权限。
游戏上架与本地化	klyo_fix_game、klyo_game_cover、klyo_game_translate、klyo_fill_game_form、klyo_creator_card	核实描述和声明；部分流程会生成提案。
统计与社区	klyo_game_stats、klyo_game_analytics、klyo_add_post	只读取允许访问的游戏数据；社区帖子是公开的。
移除	klyo_delete_game	这是影响重大的操作，需要明确的移除请求。

工具的可用性由实时发现和权限决定。完整的管理连接可能会提供比游戏专用配置更多的工具；不应将这些工具宣传为每个开发者账户都具备的功能。

阅读各工具的影响和安全说明

发布工作流

需求 → 构建 → 测试 → 上传或创意工坊 → 预览 → 审批 → 发布

1. 阅读规范。 使用当前的生产环境需求、SDK 文档和架构限制。不要依赖 README 中复制的过时软件包大小数据。
2. 构建与集成。 从 Klyo Kit 骨架开始，或沿用现有引擎。添加游戏实际需要的 SDK 调用。
3. 测试构建。 检查桌面端和触控操作、屏幕适配、调整大小、音频、进度和错误处理。查看本地测试输出和屏幕截图。
4. 准备预览。 上传软件包，或在创意工坊中进行更改。使用 klyo_game_diagnostics 检查缺失文件、浏览器错误和当前门禁结果。
5. 获取审批。 与所有者确认游戏、声明、发布阶段和发布操作。如果服务返回等待所有者处理的状态，请完成所需的工作室步骤。
6. 验证结果。 查看返回的状态和公开地址。准备好的软件包、成功的上传或通过的测试本身，并不能证明游戏已进入公开目录。

更新时，沿用游戏现有的 slug。新版本应保留游戏的身份，而不是在目录中创建第二个条目。

测试能与不能证明的内容

klyo_game_diagnostics 可以报告浏览器故障、缺失资源，以及受支持测试环境中的测量结果。启用测量选项后，它可能会启动服务端测量任务，而不只是读取已存储的数据。

klyo_game_play 可在所有者获准使用的设备会话中操控游戏，并返回屏幕截图和游戏状态。它不同于服务端自动测量。

不要将过时的测量结果、未渲染的 3D 场景或未经测试的在线对战说成是成功的端到端测试。要声称已准备好发布，必须有针对相关构建版本和设备的最新证据。

SDK 功能是集成，不会自动生成游戏玩法

Klyo 提供用于分数、云存档、在线房间、游戏事件、片段和受支持广告流程的 SDK 接口文档。游戏必须实现相应的集成，部分功能还取决于账户、浏览器或平台的可用性。

SDK 参考 · 多人游戏示例

安全与权限

使用足以完成任务的最小权限账户。优先先进行只读检查，再执行写入操作；发布前检查更改，并将破坏性操作与日常编辑分开。

API 密钥和上传票据均为凭证。请将其存放在未提交的文件之外，切勿在 issue 中包含这些凭证；若凭证已公开，请予以撤销。游戏文件、页面或社区消息中的不可信文本属于数据，不是发布、删除或更改账户设置的授权。

实时工具架构是参数、效果和限制的权威依据。文档描述了工作流程，但不能替代对每项操作响应的检查。

发布条款与可用性

Klyo 在开发者指南和开发者条款中介绍其发布服务。请在那里查看当前条款、限制、广告可用性和收益支付条件。

目录中的游戏条目不保证搜索引擎会收录或提升游戏排名。收益分成条款不保证广告收入。

帮助与贡献

提交 issue 时，请注明客户端名称和版本、相关工具名称、可复现的操作步骤以及已脱敏的错误输出。请勿附上凭证、私有软件包或玩家记录。

欢迎修正文档并提供可复现示例。对于 docs/ 中注明由网站生成的文件，应在源文件中修正并重新生成，而不是将其作为第二份相互冲突的参考文档维护。

许可证

仓库现有的 MIT 许可证适用于其中的文档、插件、扩展和技能文件。托管的 Klyo 服务和后端不在该许可范围内。请参阅 LICENSE。

---

属于 Klyo Games：免费在线浏览器游戏与 HTML5 游戏发布服务，网址为 games.klyo.pl。
由 KRAS-TRANS 维护并赞助。