使用 Studio MCP 服务器与 Open Cloud

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处。

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 请求以及请求的域。

参数描述
methodGET、POST、PUT、PATCH 或 DELETE。
endpoint在 https://apis.roblox.com, 下的路径,包括任何查询字符串。例如,/cloud/v2/universes/123`。
bodyJSON 编码的请求体。对于 GET 和 DELETE,请省略。
scopes端点所需的范围,例如 ["universe:read"]。可选,但如果未启用所需范围,则会返回明确的错误。
files用于 multipart/form-data 端点的本地文件,例如资产上传。文件必须位于已批准的 上传文件夹 中。

管理权限

要管理您打开的游戏的权限,请单击 Studio 右下角的 MCP,然后选择 MCP 权限 选项卡。或者,从 Assistant 中:

  1. 打开 Assistant。
  2. 单击 … ⟩ 设置。
  3. 选择 MCP 权限 选项卡。
  4. 启用或禁用权限。更改将在您的客户端下一个请求中生效。

访问级别

选择一个访问级别作为起点,然后启用或禁用单个权限。每个游戏的默认级别为 平衡。

访问级别启用的内容
安全仅低风险范围。大多数权限处于关闭状态。
平衡低风险和中等风险范围。
完全访问所有范围,包括可能花费 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。要使用它们:

  1. 在 保存与加载数据 下启用所需的范围。读取需要 universe-datastores.objects:read。写入需要 universe-datastores.objects:update。
  2. 在 游戏设置 ⟩ 安全性 中,启用 启用 Studio 访问 API 服务。此游戏设置与您的 MCP 权限是分开的。

HTTP 请求

要让您的客户端运行的脚本使用 HttpService 进行 HTTP 请求:

  1. 启用 连接到互联网。这授予 Network 脚本能力。
  2. 将您的客户端需要的每个域添加到 HTTP 域允许列表。

Studio 拒绝对不在列表上的任何域的请求。

不可用的权限

某些范围无法授予 MCP 客户端。这些包括徽章范围、universe-datastores.control:*、universe-datastores.objects:create、分析警报和所有 legacy-* 范围。使用 创作者仪表板 或 API 密钥 来执行这些任务。

某些端点还会拒绝 Studio 使用的令牌,即使匹配的范围已启用。如果发生这种情况,您的客户端会报告错误并建议另一种完成任务的方法。

导入 3D 模型

从 Blender、Maya 或其他 3D 工具导入资产是一种常见的工作流程。您的客户端导出模型、上传它、插入它,然后将结果与源进行比较并修复导入所更改的内容。

要导入模型:

  1. 启用 发布与管理资产 ⟩ asset:read 和 asset:write。

  2. 批准导出文件的文件夹。

  3. 在您的 3D 工具中打开模型,或将其导出为 .glb 或 .fbx 到批准的文件夹中。

  4. 提示您的客户端。例如:

    将我打开的 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.* 范围被禁用。在 保存与加载数据 下启用内存存储范围。
文件不在批准的上传目录中该文件位于您的批准文件夹之外。批准该文件夹,或将文件移动到其中。
©2026 Roblox Corporation、Roblox、Roblox 标志及 Powering Imagination 是我们在美国及其他国家或地区的注册与未注册商标。