Studio MCP 服务器 可以代表您调用 Open Cloud API。您的 MCP 客户端可以上传资产、管理开发者产品和游戏通行证、修改游戏设置等,而无需创建或粘贴 API 密钥。
您决定您的客户端被允许做什么。权限会为您的 Roblox 账户在每个游戏中保存,Studio 会在每个请求中强制执行这些权限。
前提条件
在您使用 Studio MCP 服务器与 Open Cloud 之前:
- 启用 Studio MCP 服务器并连接您的客户端。有关更多信息,请参见 连接到 Roblox Studio MCP 服务器。
- 打开属于已发布游戏的地方。权限是按游戏保存的,因此未发布的本地地方无法使用它们。
- 拥有管理该游戏的权限。如果一个组拥有该游戏,您的组角色必须允许您授予客户端的操作。
工作原理
Studio MCP 服务器添加了 open_cloud_invoke 工具。Studio 为您管理访问权限。您的客户端只能使用您为当前游戏启用的范围,并且永远不会看到或处理凭据。只有您可以更改您的权限。您的客户端无法自行启用它们。
对于每个游戏,您控制您的客户端可以调用哪些 Open Cloud 范围、可以从哪些文件夹上传、是否可以从 execute_luau 进行数据存储和内存存储调用,以及脚本是否可以进行 HTTP 请求以及请求的域。
| 参数 | 描述 |
|---|---|
| method | GET、POST、PUT、PATCH 或 DELETE。 |
| endpoint | 在 https://apis.roblox.com, 下的路径,包括任何查询字符串。例如,/cloud/v2/universes/123`。 |
| body | JSON 编码的请求体。对于 GET 和 DELETE,请省略。 |
| scopes | 端点所需的范围,例如 ["universe:read"]。可选,但如果未启用所需范围,则会返回明确的错误。 |
| files | 用于 multipart/form-data 端点的本地文件,例如资产上传。文件必须位于已批准的 上传文件夹 中。 |
管理权限
要管理您打开的游戏的权限,请单击 Studio 右下角的 MCP,然后选择 MCP 权限 选项卡。或者,从 Assistant 中:
- 打开 Assistant。
- 单击 … ⟩ 设置。
- 选择 MCP 权限 选项卡。
- 启用或禁用权限。更改将在您的客户端下一个请求中生效。
访问级别
选择一个访问级别作为起点,然后启用或禁用单个权限。每个游戏的默认级别为 平衡。
| 访问级别 | 启用的内容 |
|---|---|
| 安全 | 仅低风险范围。大多数权限处于关闭状态。 |
| 平衡 | 低风险和中等风险范围。 |
| 完全访问 | 所有范围,包括可能花费 Robux、影响您的玩家或发布到您的实时游戏的高风险范围。 |
| 自定义 | 在选择级别后更改任何权限时显示。 |
Roblox 为每个范围设置风险级别。
权限部分
权限按其允许您的客户端执行的操作进行分组。每个部分映射到一个或多个 Open Cloud 范围 或脚本能力。有关每个范围的详细信息,请参见 Open Cloud 范围 参考。
| 部分 | 允许的内容 | 范围 |
|---|---|---|
| 查看您的游戏 | 读取游戏和地方设置、版本历史、分析和实例。 | universe:read、universe.place:read、universe.analytics:read、universe.place.instance:read |
| 编辑您的游戏 | 更改游戏和地方设置、发布、重启服务器和远程编辑实例。 | universe:write、universe.place:write、universe.place.instance:write |
| 玩家与社交 | 读取个人资料和库存、发送通知、管理组和论坛、管理事件以及读取已保存的创作者商店物品。 | user.*、group:*、group-forum:read、universe.event:*、creator-store-save:* |
| 保存与加载数据 | 使用 DataStoreService 和 MemoryStoreService 从 execute_luau。 | universe-datastores.*、universe.ordered-data-store.*、memory-store.* |
| 连接到互联网 | 从 Luau 向您允许的域发出 HTTP 请求,并发布跨服务器消息。 | Network 能力、universe-messaging-service:publish |
| 发布与管理资产 | 上传资产并检查其状态、共享资产、管理创作者商店列表、发布地方版本和管理缩略图。 | asset:*、asset-permissions:write、creator-store-product:*、universe-places:write、universe.thumbnail:* |
| 金钱与货币化 | 创建和编辑开发者产品、游戏通行证和广告活动,并读取订阅。 | developer-product:*、game-pass:*、ad.campaign:*、ad.billing:read、universe.subscription-product.subscription:read |
| 玩家后果 | 读取、创建和删除禁令。 | universe.user-restriction:* |
| 安全与凭据 | 读取秘密名称和创建秘密,并在云中运行 Luau。 | universe.secret:*、universe.place.luau-execution-session:* |
上传文件夹
您的客户端只能从您批准的文件夹中上传文件。在要求您的客户端上传资产之前,请添加一个文件夹,并将导出保存在那里。
客户端无法复制或移动文件到已批准的文件夹以绕过此限制。如果文件在其他地方,请自己移动它或批准其文件夹。
数据存储和内存存储
您的客户端通过 DataStoreService 和 MemoryStoreService 在 execute_luau 中访问数据存储和内存存储,而不是通过 Open Cloud。要使用它们:
- 在 保存与加载数据 下启用所需的范围。读取需要 universe-datastores.objects:read。写入需要 universe-datastores.objects:update。
- 在 游戏设置 ⟩ 安全性 中,启用 启用 Studio 访问 API 服务。此游戏设置与您的 MCP 权限是分开的。
HTTP 请求
要让您的客户端运行的脚本使用 HttpService 进行 HTTP 请求:
- 将您的客户端需要的每个域添加到 HTTP 域允许列表。
Studio 拒绝对不在列表上的任何域的请求。
不可用的权限
某些范围无法授予 MCP 客户端。这些包括徽章范围、universe-datastores.control:*、universe-datastores.objects:create、分析警报和所有 legacy-* 范围。使用 创作者仪表板 或 API 密钥 来执行这些任务。
某些端点还会拒绝 Studio 使用的令牌,即使匹配的范围已启用。如果发生这种情况,您的客户端会报告错误并建议另一种完成任务的方法。
导入 3D 模型
从 Blender、Maya 或其他 3D 工具导入资产是一种常见的工作流程。您的客户端导出模型、上传它、插入它,然后将结果与源进行比较并修复导入所更改的内容。
要导入模型:
启用 发布与管理资产 ⟩ asset:read 和 asset:write。
批准导出文件的文件夹。
在您的 3D 工具中打开模型,或将其导出为 .glb 或 .fbx 到批准的文件夹中。
提示您的客户端。例如:
将我打开的 Blender 文件中的城堡导入到 Studio 中,放在出生点旁边。
导入技能告诉您的客户端在上传之前确认。然后它会:
- 检查每个网格是否超过三角形限制,并询问是否要拆分或简化任何超过限制的网格。
- 上传模型并等待审核。
- 插入模型并修复缩放、旋转、缺失的纹理、颜色和锚定。
- 将模型放置在地面上,远离其他物体和出生点。
有关支持的资产类型、格式和大小限制,请参见 资产使用指南。
技能
以下技能教会您的客户端如何使用这些权限。通过 MCP 连接的客户端会自动获得这些技能,并使用 skill 工具加载它们。要查看它们,请打开 Assistant,单击 … ⟩ Assistant 设置,然后选择 技能。要将其调整为您的工作流程,请选择它并单击 复制,然后编辑您的副本。您的副本将替换原始版本,但不会接收未来的更新。
| 技能 | 描述 |
|---|---|
| rbx-open-cloud-usage | 使用 open_cloud_invoke 调用 Open Cloud,选择正确的端点并处理错误。 |
| rbx-permissions | 确定任务需要哪些权限,检查哪些已启用,并仅询问您缺少的权限。 |
| rbx-import-asset | 从外部 3D 工具导入模型,然后在 Studio 中检查和修复它。 |
故障排除
当请求被阻止时,客户端会报告缺少的内容。它绝不会绕过您已禁用的权限。
| 错误 | 原因 | 修复 |
|---|---|---|
| Scope '<scope>' has not been granted | 范围被禁用,或名称拼写错误。 | 在匹配的部分中启用该范围。 |
| HTTP 403 或 401,范围已启用 | 端点不接受 MCP 令牌。 | 使用创作者仪表板或 API 密钥执行此任务。 |
| lacking capability <capability> | 脚本需要未授予的能力。 | 为 Network 启用 连接到互联网。其他能力无法授予。 |
| domain <domain> is not in the Assistant HTTP allowlist | 该域不在您的允许列表中。 | 在 连接到互联网 ⟩ HTTP 域允许列表 下添加它。 |
| 502 … Access forbidden 来自数据存储调用 | 匹配的 保存与加载数据 范围被禁用。 | 启用读取或更新范围。 |
| Studio access to APIs is not allowed | 此游戏禁用了 Studio API 访问。 | 启用 游戏设置 ⟩ 安全性 ⟩ 启用 Studio 访问 API 服务。 |
| InternalError 来自内存存储调用 | memory-store.* 范围被禁用。 | 在 保存与加载数据 下启用内存存储范围。 |
| 文件不在批准的上传目录中 | 该文件位于您的批准文件夹之外。 | 批准该文件夹,或将文件移动到其中。 |