【用途】 horizOn MCP Server 是 horizOn 后端即服务（Backend-as-a-Service）的官方 MCP 服务器，为 AI 编程助手提供游戏与应用开发所需的文档、实时 API 工具和工作流提示词。它面向使用 Godot、Unity 或 Unreal Engine 的开发者，帮助 AI 助手理解并操作 horizOn 后端。
【主要能力】 文档资源：共 18 份文档资源，由 MCP 服务器直接提供，无需 API 密钥。 实时 API 工具：共 34 个工具，调用 horizOn 后端，需要有效 API 密钥。部分工具（如 horizon_submit_score、horizon_save_cloud_data、horizon_load_cloud_data、horizon_redeem_gift_code、horizon_get_profile、horizon_set_profile、horizon_start_run、horizon_submit_validated、horizon_get_state、horizon_upload_evidence）还需要玩家会话：先登录，然后将返回的 accessToken 作为 sessionToken 传入。 工具注解：每个工具都声明 MCP 注解（readOnlyHint、destructiveHint、idempotentHint、openWorldHint），便于客户端区分读取与写入操作。破坏性工具包括 horizon_save_cloud_data（替换存档）、horizon_set_profile（替换整个档案）、horizon_submit_validated（消耗票据，可能花费余额）和 horizon_cancel_email。返回对象的读取工具还声明 outputSchema，并在 JSON 文本旁返回 structuredContent。每个工具描述说明何时使用、应改用哪个同类工具、返回什么以及如何从错误中恢复。 工作流提示词：共 4 个提示词，引导 AI 助手完成常见 horizOn 任务。
【使用方式】 将服务器添加到 MCP 客户端配置（如 Claude Desktop、Cursor 等），通过 npm 安装。文档资源无需 API 密钥；实时 API 工具需要认证。
【管理工具（v1.2+）】 使用 Account Key（可在 horizOn 仪表盘 -> API Keys -> Create -> Account Key 创建）后，MCP 服务器会暴露额外工具，允许 Claude 管理仪表盘，包括项目、远程配置、新闻、邮件模板、礼品码、用户、排行榜、云存档数据、崩溃报告、反馈、用户日志、SMTP 以及 Validated Actions（规则、运行、玩家值和证据审核）。 获取 Account Key 的步骤：登录 horizOn 仪表盘；在侧边栏进入 API Keys；点击 Create API Key；选择 Account Key 作为密钥类型；选择密钥可访问整个账户、单个 Project API Key 或选定功能组；点击 Create，密钥仅显示一次，请立即复制；将密钥加入 MCP 配置。 玩家密钥与管理密钥可在 MCP 客户端配置中同时或分别设置。仅当设置了 Account Key 时才会注册管理工具，否则服务器只暴露面向玩家的原始工具。Account Key 继承账户等级（FREE/BASIC/PRO/ENTERPRISE），不授予额外权限。密钥可以是全账户、仅限单个 Project API Key、仅限选定功能组，或两者兼有。平台管理员专属端点（Blog、Banner、System-Config）自动不可达。少数超敏感端点（删除账户、更改凭据、密钥管理本身、取消订阅）需要仪表盘会话，无法通过 Account Key 调用。当密钥限定项目范围时，后端在直接 HTTP 调用中也会强制执行该范围；无法证明项目上下文的账户级端点或仅 ID 端点会针对项目范围密钥被拒绝。管理工具与玩家工具带有相同的注解：列表、获取和统计工具为只读，更新和删除工具标记为破坏性。
【适用场景】 适用于使用 horizOn 后端即服务的游戏与应用开发场景，尤其需要 AI 编程助手协助集成 Godot 4.5+（GDScript SDK）、Unity 6（C# SDK）或 Unreal Engine 5.5+（C++ 和 Blueprint SDK）的开发者，以及需要通过 AI 助手管理 horizOn 仪表盘各项功能的用户。
【限制】 实时 API 工具需要有效 API 密钥，部分工具还需要玩家会话令牌。管理工具仅在设置 Account Key 后可用。Account Key 不额外提权，部分端点和超敏感操作无法通过 Account Key 调用。项目范围密钥在直接 HTTP 调用中也受范围限制。
