跳到主要内容
Data 与 Schema

本页尚未翻译,当前显示英文版本。

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

用自然语言提出修改要求;智能体会在动手之前说明它要做什么。确认之前,请先检查它的计划。

U
列出这个 Project 中的所有 Entity,并说明每个的用途。
AI
这个 Project 有 4 个 Entity:
  • Ships —— Player 可以驾驶的飞船
  • Pilots —— 每个 Player 一个,归 Player 所有
  • MatchResults —— 每名飞行员每场比赛一条结果
  • ArenaConfig —— 保存比赛规则的单例
需要我列出其中某个的字段吗?
U
给 Ships 添加一个布尔字段 IsRetired,必填,默认值为 false。
AI
我会为 Ships 暂存这项更改:
  • Name: IsRetired
  • Kind: Primitive — Boolean
  • Required: 是,Default: false
Ships 中已有 Record,所以这项更改要通过迁移完成:现有飞船会获得默认值。要我规划这次迁移吗?
U
创建一个名为 Difficulty 的 Enum,取值为 Easy、Normal、Hard 和 Extreme。
AI
已创建 Enum Difficulty,共 4 个取值:Easy、Normal、Hard、Extreme。现在 Enum 引用字段可以使用它了。
U
哪些对象引用或包含了 Weapon 这个 Part?
AI
Weapon 在 2 处被使用,都在 Loadout 这个 Part 中:
  • 包含字段 Primary,一对一
  • 包含字段 Secondary,一对一
Loadout 本身又被包含在 Pilots 中。
U
Ships 有三个与操控相关的字段。把它们移到一个名为 Handling 的新 Part 中,并在 Ships 中包含它。
AI
计划如下:
  • 创建 Part Handling,包含这三个字段
  • 在 Ships 上添加包含字段 Handling,一对一
  • 从 Ships 中删除这三个字段
从已有 Record 的 Entity 中删除字段需要迁移;应用之前我会先给你看它的影响。继续吗?

智能体可以直接完成的小改动,例如新建对象或添加可选字段,会立即生效。会破坏现有 Record 的更改,例如在已有 Record 的 Entity 上删除字段或把字段改为必填,则不能直接执行:智能体会把它规划为一次迁移,向你展示影响,并在你同意后应用。智能体修改的访问设置会立即生效,不会像在 Backoffice 中那样先暂存为迁移。


根据游戏设计文档生成 Schema

粘贴一份游戏设计文档,或任何描述游戏数据的内容,让智能体据此构建 Schema。它会阅读文档,提出 Entity、Part 和 Enum 的方案,并在你批准后创建它们。

先让它给出计划

在创建任何内容之前,先让智能体总结它从文档中发现了什么、打算创建什么。然后在基于新 Schema 构建数据之前,先在 Schema 中检查结果:一旦已有 Record,重命名或删除字段就需要迁移。


后续步骤

更新于 2026年10月16日