重點摘要
在 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 不在 Quick connect 清單中,Roblox 也沒有記載 ChatGPT 的設定方式。Roblox 記載的 OpenAI 途徑是透過 MCP 使用 Codex CLI(OpenAI 為它提供 Sign in with ChatGPT),或在 Assistant 中使用 OpenAI API 金鑰。OpenAI 也記載了在 Codex 模式的 ChatGPT 桌面應用程式中加入本機伺服器的方法,但 Roblox 的清單中沒有它。
- 連接的用戶端可以在任何開啟的場景中修改 Script、執行 Luau、放入素材並啟動試玩測試。請先儲存一個版本,而且只連接你信任的用戶端。
Studio MCP 伺服器的作用
MCP(Model Context Protocol)是讓 AI 工具與其他應用程式溝通的開放標準。Roblox 把 MCP 伺服器內建在 Studio 中。開啟後,你電腦上的 AI 用戶端就能探索開啟的場景、讀寫 Script、執行 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,使用你選的模型 |
這篇教學說的是第一種途徑。如果你只需要讓 Claude 或 OpenAI 的模型在 Studio 中回答問題,第二種途徑比較短:向服務商取得 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 視窗的 studio_id。
| 群組 | 工具 | 作用 |
|---|---|---|
| Script | script_read、multi_edit、script_search、script_grep | 依 game.ServerScriptService.MyScript 這類路徑讀取 Script,整份或依行數範圍讀取。一次套用多項修改,路徑不存在時會建立 Script。依名稱搜尋 Script(最多 10 筆結果),或在所有 Script 中搜尋文字(最多 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 控制,以及把遊戲轉為串流的 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 會讀寫和正式遊戲相同的 data store,Roblox 建議只在另外的測試版本中開啟。這也適用於代理執行的程式碼與它啟動的試玩測試。
- 會修改東西的工具保留同意步驟。允許
script_read與search_game_tree這類讀取工具幾乎是安全的。multi_edit、execute_luau、insert_asset與upload_image請一次一次同意,直到你信任整個流程為止。 - 保留之前先檢查。閱讀修改過的 Script,在 Explorer 中檢查新增或消失的物件,並自己測試。代理的試玩測試只顯示它決定檢查的東西,而不是玩家會做的所有事。
大型專案:Script Sync 與 Git
Roblox 的 coding harness 教學把 MCP 連線再搭配另外兩個部分。Script Sync 把 Studio 的服務連到磁碟上的資料夾,讓編輯器與代理使用會在 Studio 中顯示為 Script 的 .luau 檔案,而 Git 則讓這些程式碼有可以回溯的歷史。要請代理做大事之前,先提交一個乾淨的狀態。
Script Sync 涵蓋連結服務中的 Script;它碰不到的部分,例如 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 登入的 Roblox 帳號和 RoCode 相同,外掛程式就會自動連線;否則你只要用外掛程式面板中的 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 搜尋免費模型(會移除其中的 Script),或依素材 ID 放入模型、貼圖或網格,並為每個遊戲重新設計裝飾、建築與道具。免費的 Starter 方案每天包含 1 點。與其他工具的比較:最佳 Roblox Studio AI。
我剛剛測試遊戲時,RoundManager 出現錯誤。找出原因並修好。
- 用 Check Output 讀取你試玩測試的 Output,包括 Server 與 Client 訊息,再用 Read Script 開啟那一行附近的 Script
- 在已連接的 Studio 視窗中,用 Edit Script 就地修正壞掉的程式碼
- 結束前在 Studio 中用 Check Script 檢查 Script。這是編譯檢查,不是型別檢查,也不是試玩測試
- 分批送出變更,每一批都是 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 的清單中沒有它,我們也沒有測試過。另一條路是在 Assistant 中透過 Manage API Keys 使用 OpenAI API 金鑰。
把 Claude 連接到 Roblox Studio 需要 API 金鑰嗎?
用 MCP 不需要。Roblox 的設定中沒有 API 金鑰這一步,用戶端使用它平常的登入:coding harness 教學是用 Anthropic 帳號登入 Claude Code。只有另一條途徑,也就是透過 Manage API Keys 在 Assistant 中使用 Claude 模型,才需要 API 金鑰。
AI 能透過 MCP 測試我的遊戲嗎?
可以。start_stop_play 會啟動與停止試玩測試,get_console_output 會讀取 Output,screen_capture 會擷取檢視區,輸入工具則會移動角色並送出按鍵與點擊。playtest 子代理可以跑一段遊戲情境並檢查結果。發布前請自己也玩一遍。
Studio MCP 伺服器能在 Mac 上使用嗎?
可以。Roblox 在 Windows 設定旁邊,也記載了指向 /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP 的 macOS 設定。
來源與延伸閱讀
- 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 伺服器實作的開放標準