要点
在 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、插入资源并启动试玩测试。请先保存一个版本,并且只连接你信任的客户端。
Studio 的 MCP 服务器能做什么
MCP(Model Context Protocol)是一个开放标准,让 AI 工具能和其他应用通信。Roblox 在 Studio 中内置了一个 MCP 服务器。开启后,你电脑上的 AI 客户端就能探查打开的场景、读写脚本、执行 Luau,并在游戏模式中测试游戏,这一切都通过服务器提供的工具完成。
服务器作为本地进程在你的电脑上运行,通过 stdio(标准输入和输出)与客户端通信。它自己不会做任何事:每个操作都从客户端的请求开始,由客户端决定调用哪个工具。你需要最新版的 Roblox Studio 和所需的 MCP 客户端,两者在同一台电脑上。
在 Studio 中使用 Claude 或 GPT 的两种方式
| 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 服务器
- 打开 Roblox Studio 并打开一个场景。如果 Studio 提示更新,请先安装更新:服务器需要最新版本。
- 点击 Studio 右上角的 Assistant(mezzanine 栏的右侧),打开 Assistant 窗口。
- 点击 …,选择 Manage MCP Servers。
- 开启 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 步的面板(Assistant Settings > MCP Servers)中展开 Quick connect 列表。里面是你电脑上已安装的受支持客户端。
- 开启你需要的客户端。
- 如果客户端不在列表中,请安装它并重启 Roblox Studio。如果你是在 Studio 打开时安装的,可能需要重启 Studio、客户端或两者。
各客户端的设置
| 客户端 | 路径 | 备注 |
|---|---|---|
| Claude Desktop(Anthropic) | Quick connect | 桌面应用。Roblox 没有介绍在网页浏览器中使用 Claude 的方法。 |
| Claude Code(Anthropic) | Quick connect | Roblox 的 coding harness 教程把它作为 Visual Studio Code 扩展使用,通过 Anthropic 账户登录。 |
| Cursor | Quick connect | 内置 AI 助手。用 Cursor 账户登录。 |
| Visual Studio Code | Quick connect | 需要一个 AI 扩展,例如 Claude Code。 |
| Codex CLI(OpenAI) | Quick connect | Roblox 列表中的 OpenAI 客户端。OpenAI 的 Codex 文档在首次启动时提供 Sign in with ChatGPT。 |
| Gemini CLI(Google) | Quick connect | |
| Antigravity | Quick 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 服务器,直接原样使用即可。
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}
配置文件放在哪里取决于客户端(在 Roblox 的示例中它叫 mcp.json)。Roblox 的说明是按客户端的文档完成设置,然后重启客户端,让它读取改动。
CLI 命令
有些客户端接受命令而不是配置文件。下面是启动服务器的命令;请按你客户端的文档注册它:
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat
/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP
两者都指向 Studio 安装的文件。在 Windows 上,%LOCALAPPDATA% 是你这个用户的本地应用数据文件夹。在 macOS 上,路径位于 /Applications 中的 RobloxStudio.app 内。如果文件不存在,客户端就无法启动服务器:见故障排除。
第 3 步:检查连接
- 在 Studio 中打开 Assistant,点击 … > Manage MCP Servers。
- 在 Enable Studio as MCP server 下方找到绿色指示灯。它显示已连接客户端的数量。
- 在客户端中,先用一个只读的请求开始,这样即使设置有误也不会改动任何东西。例如:使用 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 窗口。
| 分组 | 工具 | 作用 |
|---|---|---|
| 脚本 | script_read、multi_edit、script_search、script_grep | 按 game.ServerScriptService.MyScript 这样的路径读取脚本,读取整个脚本或指定行范围。一次应用多处修改,如果路径不存在就创建脚本。按名称搜索脚本(最多 10 条结果),或在所有脚本中搜索文本(最多 50 处匹配)。 |
| 数据模型 | search_game_tree、inspect_instance、subagent | 用过滤条件和深度限制遍历对象层级,读取单个对象所有可访问的属性和 Attribute,或把多步骤工作交给 explore 或 playtest 子代理。 |
| 执行 Luau | execute_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 里报错了。找到原因并修复。
- 用 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。
参考资料
- Roblox Creator Docs: Connect to the Roblox Studio MCP server(英文). 开启服务器、quick connect、JSON 和 CLI、工具列表、多个 Studio 窗口和故障排除
- Roblox Developer Forum: Studio MCP Server Updates and External LLM Support for Assistant(英文). 在 Assistant 中使用自己的 Anthropic、OpenAI 或 Google API 密钥
- Roblox Creator Docs: Build with a coding harness(英文). Script Sync、配合 Cursor 或 Visual Studio Code 的 MCP,以及 Git
- Roblox Creator Docs: Version History(英文). 带备注保存和恢复旧版本
- Roblox Creator Docs: Data stores(英文). 为什么 Studio 对 API services 的访问只应在测试副本中开启
- Roblox Engine API: StudioTestService(英文)
- OpenAI: Codex CLI(英文). 登录 Codex CLI,包括 Sign in with ChatGPT
- OpenAI: Model Context Protocol(英文). Codex 模式下 ChatGPT 桌面应用中的本地 STDIO 服务器
- Model Context Protocol: Introduction(英文). Studio 服务器所实现的开放标准