教程 · Roblox Studio AI

怎么通过 MCP 把 Claude、Cursor 或 ChatGPT 连接到 Roblox Studio

Roblox Studio 内置了一个 Model Context Protocol(MCP)服务器。开启它,连接 Claude Code、Claude Desktop 或 Cursor 这样的 AI 客户端,这个客户端就能在打开的 Studio 窗口中读取你的场景、编辑脚本、执行 Luau 并启动试玩测试。本教程遵循 Roblox 自己的设置文档,直接说明文档在哪里止步(ChatGPT 就是其中之一),并讲解在代理工作时如何保证场景的安全。

更新于 2026年11月20日阅读约 5 分钟作者

要点

在 Roblox Studio 中打开 Assistant,点击 … > Manage MCP Servers,然后开启 Enable Studio as MCP server。接着连接客户端。Claude Code、Claude Desktop、Cursor、Codex CLI、Gemini CLI、Visual Studio Code 和 Antigravity 在这个面板中都有一键开关的 Quick connect。其他任何支持 stdio 的客户端,都可以使用 Roblox 文档中给出的 JSON 配置或命令。

  • 同一个面板里的绿色指示灯会显示已连接的客户端数量。如果你的客户端没有出现,请同时重启 Studio 和客户端。
  • ChatGPT 不在快速连接列表中,Roblox 也没有给出 ChatGPT 的设置文档。Roblox 文档中的 OpenAI 路径是通过 MCP 使用 Codex CLI(OpenAI 为它提供 Sign in with ChatGPT),或者在 Assistant 中使用 OpenAI API 密钥。OpenAI 还记录了在 Codex 模式下的 ChatGPT 桌面应用中添加本地服务器的方法,但 Roblox 的列表里没有它。
  • 已连接的客户端可以在任何打开的场景中编辑脚本、执行 Luau、插入资源并启动试玩测试。请先保存一个版本,并且只连接你信任的客户端。
本页内容
  1. 它能做什么
  2. 1. 开启服务器
  3. 2. 连接客户端
  4. JSON 和 CLI
  5. 3. 检查
  6. ChatGPT
  7. 工具
  8. 多个窗口
  9. 安全
  10. Script Sync 和 Git
  11. 故障排除
  12. 免设置
  13. 常见问题
  14. 参考资料

Studio 的 MCP 服务器能做什么

MCP(Model Context Protocol)是一个开放标准,让 AI 工具能和其他应用通信。Roblox 在 Studio 中内置了一个 MCP 服务器。开启后,你电脑上的 AI 客户端就能探查打开的场景、读写脚本、执行 Luau,并在游戏模式中测试游戏,这一切都通过服务器提供的工具完成。

服务器作为本地进程在你的电脑上运行,通过 stdio(标准输入和输出)与客户端通信。它自己不会做任何事:每个操作都从客户端的请求开始,由客户端决定调用哪个工具。你需要最新版的 Roblox Studio 和所需的 MCP 客户端,两者在同一台电脑上。

在 Studio 中使用 Claude 或 GPT 的两种方式

Roblox 文档中的两条路径
Studio 的 MCP 服务器使用自己 API 密钥的 Assistant
在哪里输入在 AI 客户端中,例如 Claude Desktop、Claude Code 或 Cursor在 Studio 的 Assistant 面板中
要设置什么在 Studio 中开启服务器,然后连接客户端Assistant > … > Manage API Keys,然后选择模型
模型你的客户端所用的模型Anthropic、OpenAI 或 Google Gemini
需要什么客户端及其自己的登录该服务商的 API 密钥
谁在 Studio 中操作你的客户端,通过 MCP 工具Assistant,使用所选的模型

本教程讲的是第一条路径。如果你只需要一个在 Studio 内回答问题的 Claude 或 OpenAI 模型,第二条路径更短:从服务商处获取 API 密钥,打开 Assistant,点击 … > Manage API Keys,选择服务商,粘贴密钥,然后在 Model 列表中选择模型。

第 1 步:在 Studio 中开启 MCP 服务器

  1. 打开 Roblox Studio 并打开一个场景。如果 Studio 提示更新,请先安装更新:服务器需要最新版本。
  2. 点击 Studio 右上角的 Assistant(mezzanine 栏的右侧),打开 Assistant 窗口。
  3. 点击 …,选择 Manage MCP Servers。
  4. 开启 Enable Studio as MCP server。

现在面板会显示 Quick connect 选项,以及设置不同客户端的说明。不要关闭它:下一步要用到它,连接指示灯也会出现在这里。

如果没有 Assistant 按钮或窗口打不开,请看如何打开 Assistant 面板(英文)。

第 2 步:连接 AI 客户端

Roblox 提供三种连接方式,按以下顺序:客户端在列表中时用 quick connect,客户端读取 MCP 配置文件时用 JSON 配置,需要命令的客户端用 CLI 命令。

Quick connect

Quick connect 支持七个客户端(按 2026 年 9 月 30 日的列表):Antigravity、Codex CLI、Claude Code、Claude Desktop、Cursor、Gemini CLI 和 Visual Studio Code。

  1. 在第 1 步的面板(Assistant Settings > MCP Servers)中展开 Quick connect 列表。里面是你电脑上已安装的受支持客户端。
  2. 开启你需要的客户端。
  3. 如果客户端不在列表中,请安装它并重启 Roblox Studio。如果你是在 Studio 打开时安装的,可能需要重启 Studio、客户端或两者。

各客户端的设置

Roblox 为每个客户端提供的文档,2026 年 9 月 30 日
客户端路径备注
Claude Desktop(Anthropic)Quick connect桌面应用。Roblox 没有介绍在网页浏览器中使用 Claude 的方法。
Claude Code(Anthropic)Quick connectRoblox 的 coding harness 教程把它作为 Visual Studio Code 扩展使用,通过 Anthropic 账户登录。
CursorQuick connect内置 AI 助手。用 Cursor 账户登录。
Visual Studio CodeQuick connect需要一个 AI 扩展,例如 Claude Code。
Codex CLI(OpenAI)Quick connectRoblox 列表中的 OpenAI 客户端。OpenAI 的 Codex 文档在首次启动时提供 Sign in with ChatGPT。
Gemini CLI(Google)Quick connect
AntigravityQuick connect
其他任何支持 stdio 的客户端JSON 配置或 CLI 命令见下一节。按客户端的文档完成设置,然后重启它。
ChatGPT无文档不在 quick connect 列表中。OpenAI 记录了一条通过 Codex 模式下的 ChatGPT 桌面应用的路径;见ChatGPT 能否连接到 Roblox Studio。

Roblox 的 coding harness 教程把 MCP 连接与编辑器结合起来:Cursor 或带 Claude Code 之类扩展的 Visual Studio Code。如果你希望代理除了操控 Studio,还能以文件形式写代码,请看下面的 Script Sync 和 Git 一节。

其他客户端:JSON 配置或 CLI 命令

服务器适用于任何支持 stdio 传输的客户端。如果你的客户端没有 quick connect,就把 Roblox Studio 加进它的 MCP 配置。下面是 Roblox 文档中的完整配置。如果 Roblox Studio 是你唯一的 MCP 服务器,直接原样使用即可。

JSON 配置 · Windows
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "%LOCALAPPDATA%\\Roblox\\mcp.bat"
      ]
    }
  }
}
JSON 配置 · macOS
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
    }
  }
}

配置文件放在哪里取决于客户端(在 Roblox 的示例中它叫 mcp.json)。Roblox 的说明是按客户端的文档完成设置,然后重启客户端,让它读取改动。

CLI 命令

有些客户端接受命令而不是配置文件。下面是启动服务器的命令;请按你客户端的文档注册它:

CLI 命令 · Windows
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat
CLI 命令 · macOS
/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP

两者都指向 Studio 安装的文件。在 Windows 上,%LOCALAPPDATA% 是你这个用户的本地应用数据文件夹。在 macOS 上,路径位于 /Applications 中的 RobloxStudio.app 内。如果文件不存在,客户端就无法启动服务器:见故障排除。

第 3 步:检查连接

  1. 在 Studio 中打开 Assistant,点击 … > Manage MCP Servers。
  2. 在 Enable Studio as MCP server 下方找到绿色指示灯。它显示已连接客户端的数量。
  3. 在客户端中,先用一个只读的请求开始,这样即使设置有误也不会改动任何东西。例如:使用 Roblox Studio MCP 工具,列出 Workspace 里有什么。不要做任何修改。

在全新的 Baseplate 上,回答应该列出标准的 Camera、Terrain、Baseplate 和 SpawnLocation。客户端可能会请你批准工具调用,或建议把工具加入允许列表。做这个测试时批准一次就够了。

ChatGPT 能连接到 Roblox Studio 吗?

网页浏览器中的 ChatGPT 不行:Studio 的 MCP 服务器是本地程序,而 OpenAI 说网页版 ChatGPT 不会读取本地的 Codex 配置文件。Roblox 文档中的路径是 Codex CLI,可以用 ChatGPT 账户登录。截至 2026 年 10 月 11 日,Roblox 的 MCP 页面没有介绍 ChatGPT 的设置,ChatGPT 也不在 quick connect 列表中。下面是每条路径覆盖的范围。

  • Roblox 有文档:Codex CLI 是 OpenAI 的命令行编程代理,也是一个 quick connect 客户端。像第 2 步中的其他客户端一样设置它。OpenAI 的 Codex 文档在首次启动时提供 Sign in with ChatGPT,所以这是把 ChatGPT 账户带进 Studio 最接近的有文档方式。Codex 这一侧,包括让 Codex 在使用 Studio 工具前先询问的批准设置,在如何在 Roblox Studio 中使用 OpenAI Codex(英文)教程中有介绍。
  • Roblox 有文档:Assistant 接受 OpenAI API 密钥。打开 Assistant,点击 … > Manage API Keys,选择 OpenAI,粘贴密钥并选择模型。Assistant 会在 Studio 内使用这个模型。
  • OpenAI 有文档,Roblox 没有:Codex 模式下的 ChatGPT 桌面应用。OpenAI 的 MCP 页面说,桌面应用可以在 Settings > MCP servers > Add server 中添加本地 STDIO 服务器,并与 Codex CLI 共用这份配置。OpenAI 没有说普通的 ChatGPT 聊天能否使用这个服务器。Roblox 没有把桌面应用列入 quick connect,我们也没有测试过,所以请把它视为未经证实。所需的命令见 CLI 命令一节。

把 ChatGPT 聊天里的代码复制到 Script 中仍然可行,但走这条路时,没有任何东西会读取你的场景或在 Studio 中检查结果。Roblox Studio AI 使用教程把各种选择放在一起比较。

服务器向客户端提供哪些工具

Roblox 列出了分为八组的 26 个工具(截至 2026 年 9 月 30 日)。调用哪个由客户端选择;你不需要手动调用。每次调用都带有一个 studio_id,指向目标 Studio 窗口。

Studio MCP 服务器的工具,根据 Roblox 文档
分组工具作用
脚本script_read、multi_edit、script_search、script_grep按 game.ServerScriptService.MyScript 这样的路径读取脚本,读取整个脚本或指定行范围。一次应用多处修改,如果路径不存在就创建脚本。按名称搜索脚本(最多 10 条结果),或在所有脚本中搜索文本(最多 50 处匹配)。
数据模型search_game_tree、inspect_instance、subagent用过滤条件和深度限制遍历对象层级,读取单个对象所有可访问的属性和 Attribute,或把多步骤工作交给 explore 或 playtest 子代理。
执行 Luauexecute_luau在 Studio 中的 Edit、Client 或 Server 数据模型里执行 Luau,并返回结果或错误。
试玩测试get_studio_state、start_stop_play、get_console_output、screen_capture检查游戏状态,启动或停止试玩测试,读取 Output 日志,并把视口截成图片。
玩家输入character_navigation、user_keyboard_input、user_mouse_input把角色移动到某个位置或对象,并发送按键、文字、点击和滚动。
资源和生成generate_mesh、generate_material、generate_procedural_model、wait_job_finished、search_asset、insert_asset、upload_image、store_image根据文字生成网格、材质和程序化模型。在 Creator Store 和你的物品库中搜索,并按 ID 插入资源。把 URL 上的图片上传到 Roblox,或把本地图片作为参考。
文档和技能http_get、skill从允许的 Roblox 文档网站加载页面,以及用于调试和设备模拟等任务的参考资料。
会话list_roblox_studios列出已连接的 Studio 窗口,包括名称、Studio 实例 ID 和场景 ID。

有两类工具值得注意。第一类是会做改动的:multi_edit 和 execute_luau 直接修改场景,insert_asset 按资源 ID 引入外部内容,upload_image 把图片发送到 Roblox 的资源服务器。第二类是代理用来检查自己工作的试玩测试工具:Roblox 关于 StudioTestService 的参考说明,start_stop_play 会启动一个 Play Client 会话,输入工具在会话进行时操控角色。

Roblox 还通过服务器开放了 Studio 的其他功能:通过 SceneAnalysisService 获取的 Scene Analysis 数据、MicroProfiler 分析、Device Simulator 控制,以及一个把游戏转为流式加载(streaming)的 AI 技能。

同时使用多个 Studio 窗口

一个客户端可以同时连接多个正在运行的 Studio 窗口。由于每次调用都用 studio_id 指定目标,代理必须知道你说的是哪个窗口。它可以调用 list_roblox_studios 查看每个窗口的名称、Studio 实例 ID 和场景 ID。没有 ID 的本地场景只按名称列出,当两个窗口同名时,用场景 ID 区分。

实际操作中:在提示词里写明场景名称,并关闭不应被改动的场景。服务器可以访问任何打开的场景,而不只是你正在看的那个。

安全地工作:备份、批准、检查

Roblox 的警告很简短:MCP 客户端可以读取和修改打开的场景中的内容,所以只连接你信任的客户端。有了能执行代码、插入资源和启动试玩测试的工具,一条被误解的指令就可能造成真正的破坏。下面这些习惯让一切都能恢复。

  • 每次会话前保存一个版本。File > Save to Roblox with Notes(Ctrl+Alt+S,Mac 上是 Cmd+Option+S)会创建一个带名称的检查点。要回退时,打开 Window > Version History,点击版本旁的 ⋮,选择 Open Local Copy,然后在副本中用 File > Save to Roblox As 把它恢复到场景上。File > Save to File 还能在电脑上额外保存一份副本。
  • 不要指望 Ctrl+Z。Roblox 的 MCP 页面没有说明客户端的修改是否会进入 Studio 的撤销历史,所以回退的办法是保存的版本。
  • 在测试副本中工作,而不是在线上游戏中。开启 Enable Studio Access to API Services(File > Experience Settings > Security)后,Studio 读写的是与线上游戏相同的数据存储,Roblox 建议只在单独的测试版本中开启。这同样适用于代理执行的代码和它启动的试玩测试。
  • 为会做改动的工具保留批准。允许 script_read 和 search_game_tree 这样的只读工具几乎是安全的。在你信任整个流程之前,对 multi_edit、execute_luau、insert_asset 和 upload_image 逐次批准。
  • 保留之前先检查。阅读修改过的脚本,在 Explorer 中检查有没有新增或消失的对象,并自己测试。代理的试玩测试只显示它决定检查的内容,而不是玩家会做的一切。

大型项目:Script Sync 和 Git

Roblox 的 coding harness 教程把 MCP 连接与另外两个部分结合。Script Sync 把 Studio 的服务与磁盘上的文件夹关联起来,让编辑器和代理处理 .luau 文件,这些文件在 Studio 中显示为脚本;Git 则为这些代码提供可以回滚的历史。在请代理做大改动之前,先提交一个干净的状态。

Script Sync 覆盖已关联服务中的脚本;它覆盖不到的部分,例如 StarterGui、试玩测试和 Output,仍由 MCP 连接负责。分步设置以及作为替代方案的 Rojo,见如何在 Roblox Studio 中使用 Cursor 或 VS Code,Claude Code 版本见如何在 Roblox Studio 中使用 Claude Code(均为英文)。

故障排除:客户端连接不上时

Roblox 的检查清单有三项:同时重启 Studio 和客户端,确认命令或文件的路径正确且文件存在,检查 JSON 语法。下面是这些检查项背后的具体情况。

找不到 Manage MCP Servers

把 Roblox Studio 更新到最新版本,然后打开 Studio 右上角的 Assistant 并点击 …。Manage MCP Servers 就在这个菜单里。

我的客户端不在 Quick connect 列表中

列表只显示电脑上已安装的受支持客户端。安装客户端,然后重启 Studio。如果它不在七个受支持的客户端之列,请使用 JSON 配置或 CLI 命令。

客户端没有显示 Roblox 工具,或提示服务器没有启动

确认配置中的文件存在:Windows 上是 %LOCALAPPDATA%\Roblox\mcp.bat,macOS 上是 /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP。如果你 Mac 上的 Studio 没有安装在 /Applications 中,请修正路径。然后重启客户端(Roblox 说这是应用配置改动所必需的),再重启 Studio。

添加 Roblox Studio 后配置文件无法加载了

mcpServers 中两项之间漏掉的逗号或多余的括号,会让文件变成无效的 JSON,无法加载。用 JSON 校验工具检查文件,修正它指出的那一行,然后重启客户端。

Studio 里没有绿色指示灯

客户端没有连接上。确认 Enable Studio as MCP server 仍然开启,并且添加服务器后你重启过客户端,然后同时重启 Studio 和客户端。

代理改错了场景

打开多个 Studio 窗口时,客户端按 studio_id 选择目标。请它调用 list_roblox_studios,并说明需要的场景,或关闭其他窗口。被改动的场景请从 Version History 中恢复。

客户端每一步都请求许可

这是你的客户端,不是 Studio。Roblox 提到你可能需要批准命令,或把 MCP 工具加入允许列表。如果请求太烦人,就只允许只读工具,并继续逐次批准会修改场景的工具。

或者跳过 MCP 设置:RoCode

RoCode(RoCode.app)是另一条路径,它不是 MCP 产品。它是面向 Roblox Studio 的独立 AI 代理:你在 rocode.app 的网页聊天里描述改动,Creator Store 中免费的 RoCode 插件会在打开的场景中执行各个步骤。没有配置文件、命令行或需要设置的 MCP 服务器。你在 Studio 中允许插件使用 HTTP 和 Script Injection。然后,如果 Studio 登录的是与 RoCode 相同的 Roblox 账户,插件会自动连接;否则,你只需用插件面板上 8 个字符的代码把聊天和插件关联一次。

取舍也直说。RoCode 无法连接 Claude、Claude Code 或 ChatGPT 的订阅。它通过 OpenRouter 以第三方模型自己的名称运行它们:所有套餐可用 GPT-6 Luna,Pro 起可用 GLM 5.3 Flash 和 Claude Sonnet 5.5,Studio 起可用 Claude Opus 5.5,Ultra 可用 GPT-6 Astra。使用插件 3.9 及以上时,它可以启动一次简短的试玩测试并读取错误;3.9.11 及以上可以操控测试角色。使用插件 3.9.14 及以上时,它还会对编辑模式下建好的内容截图,并能修正看起来不对的地方。它不会直接执行代码,也不会生成网格,而上面的 Studio MCP 工具可以。它会按你的描述在 Creator Store 中搜索免费模型(会移除其中的脚本),或按资源 ID 插入模型、贴花或网格,并为每个游戏重新设计装饰、建筑和道具。免费的 Starter 套餐每天包含 1 个额度。与其他工具的对比:Roblox Studio 最佳 AI 工具。

你输入

我刚测试了游戏,RoundManager 里报错了。找到原因并修复。

RoCode 的操作
  • 用 Check Output 读取你试玩测试的 Output,包括 Server 和 Client 的行,然后用 Read Script 打开脚本中这一行附近的内容
  • 在已连接的 Studio 窗口中,用 Edit Script 就地修复出错的代码
  • 结束前用 Check Script 在 Studio 中检查脚本。这是编译检查,不是类型检查,也不是试玩测试
  • 分组发送改动,每一组都是 Studio 自身历史中的一个撤销点

RoCode 只检查它决定要检查的内容,所以请自己点击 Play 玩一个回合,确认已经修好。插件和配对的工作方式。RoCode 是独立产品,与 Roblox Corporation 没有关联,也未获得其认可。

常见问题

Roblox Studio 的 MCP 服务器免费吗?

它内置于 Roblox Studio,Roblox 的 MCP 文档没有提到任何费用或注册。AI 模型来自你的客户端,所以限额和费用由客户端的账户或套餐决定。

能把 ChatGPT 和 Roblox Studio 的 MCP 服务器一起用吗?

截至 2026 年 10 月 11 日,网页版 ChatGPT 不行:它无法启动本地的 Studio 服务器。Roblox 文档中的 OpenAI 路径是 Codex CLI,可以用 ChatGPT 账户登录。OpenAI 还记录了 Codex 模式下的 ChatGPT 桌面应用中的本地服务器,但 Roblox 的列表里没有它,我们也没有测试过。另一条路径是通过 Manage API Keys 在 Assistant 中使用 OpenAI API 密钥。

把 Claude 连接到 Roblox Studio 需要 API 密钥吗?

用 MCP 不需要。Roblox 的设置中没有 API 密钥这一步,客户端使用它平常的登录:coding harness 教程通过 Anthropic 账户登录 Claude Code。只有另一条路径才需要 API 密钥,即通过 Manage API Keys 在 Assistant 内使用 Claude 模型。

AI 能通过 MCP 测试我的游戏吗?

能。start_stop_play 启动和停止试玩测试,get_console_output 读取 Output,screen_capture 截取视口,输入工具移动角色并发送按键和点击。playtest 子代理可以运行一个游戏场景并检查结果。发布前请自己也玩一遍。

Studio 的 MCP 服务器能在 Mac 上用吗?

能。Roblox 在 Windows 配置旁边给出了 macOS 的配置,它指向 /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP。

参考资料

在你自己的游戏里试试 RoCode。

每天有免费额度,无需绑定银行卡。安装插件,描述你想要的功能,然后看看它在 Studio 里做了什么。