本页尚未翻译,当前显示英文版本。
Backoffice MCP 集成
借助 MCP,AI 智能体可以像你在 Backoffice 中那样操作你的 Project。 连接 Claude 或 Cursor 等智能体后,只需用自然语言对话,它就能读取数据、演进 Schema、管理 Player 和商品目录,以及部署 Function。所有相关设置都在侧边栏 Engineering 下的 AI Access 中。
Model Context Protocol 是一项为 AI 智能体提供工具的开放标准。PlayServ 的 MCP 服务器向智能体提供与 Backoffice 相同的操作, 权限与登录者本人相同。
智能体能做什么
| 领域 | 示例 |
|---|---|
| 从需求到后端 | 根据一份需求说明搭建整个 Project:Schema、商品目录和 Function。 |
| Schema 与迁移 | 添加字段、创建 Entity、规划并执行安全的迁移。 |
| 数据 | 查询、创建和批量导入 Record;管理关联和已保存的视图。智能体无法创建 Player 所有的 Entity 的 Record:这需要一个已登录的 Player。 |
| Player | 查找 Player、管理会话、暂停或封禁。 |
| 商品目录与商店 | 管理物品和集成,发布商店。 |
| Function | 查看和部署 Function、管理密钥、读取指标和日志。 |
| 分析 | 拉取仪表盘、基线和事件数据。 |
| Project 与密钥 | 创建 Project,签发和轮换 API key。 |
内置的操作指南会引导智能体完成多步骤任务,例如从零搭建一个 Project。智能体还能访问一些 Backoffice 中看不到的功能,例如 raw 字段,以及从代码推送 Schema。
权限级别
每个工具都属于 Read、Write 或 Admin 之一,因此你可以让读取操作自动执行,其余操作逐一确认。
| 级别 | 作用 | 建议的审批方式 | 端点 |
|---|---|---|---|
| Read | 列出、获取、查询、仪表盘、指标、日志。不做任何更改。 | 自动批准 | /mcp/read |
| Write | 创建、更新、发布、启用。更改可撤销。 | 每次询问 | /mcp/write |
| Admin | 删除、吊销密钥和会话、封禁 Player、断开连接。具有破坏性。 | 默认拒绝;逐次批准 | /mcp/admin |
连接到 /mcp 时,MCP 客户端会自动按级别对工具分组。如果想分别处理各个级别,可以把每个端点添加为单独的服务器,并在客户端中为每个服务器设置审批方式。
连接客户端
把服务器添加到客户端
打开 AI Access → Connect MCP,把配置复制到你的客户端:Claude Desktop、Claude Code、Cursor 或其他任何 MCP 客户端。
{
"mcpServers": {
"playserv": { "type": "http", "url": "https://platform.playserv.com/mcp" }
}
}在 claude.ai 中,则要把它添加为自定义连接器:在 Settings → Connectors(Team 或 Enterprise 套餐为 Organization settings → Connectors)中选择 Add custom connector,命名为 PlayServ 并粘贴 URL。
登录
智能体第一次调用 PlayServ 工具时会打开登录页面。使用有权访问你 PlayServ 工作室的 Google 或 GitHub 账号登录。之后智能体就以该账号的权限执行操作。
检查连接
问智能体 “What PlayServ tools do you have?”,它应该会列出这些工具。如果想不通过智能体检查服务器,可以把 MCP Inspector 指向同一个 URL。
永远不要把 API key 交给智能体
智能体以你的身份登录,不需要 Project 的 API key;而且粘贴到对话中的密钥可能会随对话一起被保存。请把密钥留在游戏、服务器和 CI 中。
选择 Project
通过 slug 告诉智能体要在哪个 Project 中工作,slug 可以在 Projects 中该 Project 的设置里找到。智能体找到这个 Project 后,会在接下来的整个对话中使用它。
安全地修改 Schema
用自然语言提出修改要求;智能体会在动手之前说明它要做什么。确认之前,请先检查它的计划。
智能体可以直接完成的小改动,例如新建对象或添加可选字段,会立即生效。会破坏现有 Record 的更改,例如在已有 Record 的 Entity 上删除字段或把字段改为必填,则不能直接执行:智能体会把它规划为一次迁移,向你展示影响,并在你同意后应用。智能体修改的访问设置会立即生效,不会像在 Backoffice 中那样先暂存为迁移。
根据游戏设计文档生成 Schema
粘贴一份游戏设计文档,或任何描述游戏数据的内容,让智能体据此构建 Schema。它会阅读文档,提出 Entity、Part 和 Enum 的方案,并在你批准后创建它们。
先让它给出计划
在创建任何内容之前,先让智能体总结它从文档中发现了什么、打算创建什么。然后在基于新 Schema 构建数据之前,先在 Schema 中检查结果:一旦已有 Record,重命名或删除字段就需要迁移。
后续步骤
- 构建游戏 Schema —— 审查并应用智能体所做的更改
- 管理游戏数据 —— 智能体创建的 Record
- 访问控制 —— 游戏可以对这些 Record 做什么
更新于 2026年10月16日