本指南及隨附的視頻將指導您如何通過 MCP 將 AI 支援的編碼工具連接到 Roblox Studio，讓您的代理可以代您讀取、編寫和測試遊戲。
到最後，您將擁有一個通過 Script Sync（一個讓您使用自己的編輯器編寫代碼的功能）與 Studio 同步的項目文件夾、一個讓您的代理可以直接控制 Studio 的 MCP 連接，以及準備開發的 Git 倉庫。
第一步：安裝所需條件
開始之前，您需要以下組件：
- 一個 AI 支援的文本編輯器 - 最受歡迎的選擇是 Visual Studio Code 和 Cursor。Cursor 內建有其 AI 助手，而 VS Code 則需要像 Claude Code 這樣的擴展。這兩者在這裡都能很好地工作，因此請使用您喜歡的版本。
- Roblox Studio - 從 create.roblox.com 下載。
- Git - 從 git-scm.com 安裝。
第二步：登入所有帳戶
- 您的文本編輯器：
- VS Code — 登入方式因擴展而異。對於 Claude Code，請點擊活動列中的 Claude 圖標，使用您的 Anthropic 帳戶登入，並確認聊天面板已打開。其他提供者類似。
- Cursor — 打開 Cursor，使用您的 Cursor 帳戶登入，並確認聊天面板已打開。您可以使用任何您喜歡的模型。
- Roblox Studio — 打開 Studio，用您的 Roblox 帳戶登入，並確認您可以創建新地方。
第三步：下載啟動倉庫
啟動倉庫為您提供文件夾佈局和一個 .gitignore 文件，這樣 Git 只會提交您項目中重要的部分。大多數手動設置都為您完成。
- 下載 啟動倉庫 並解壓縮。它已經包含一個名為 WaveSurvival 的文件夾。
- 在您的編輯器中，選擇 文件 → 打開文件夾 並選擇 WaveSurvival。您應該會看到裡面有三個文件夾：
- ServerScriptService/ 保存伺服器腳本，例如遊戲邏輯、敵人 AI 和波次管理。
- ReplicatedStorage/ 保存伺服器和客戶端都可以使用的共享模組。
- StarterPlayerScripts/ 保存為每個玩家運行的客戶端腳本。
每個文件夾內的 .gitkeep 文件都是佔位符，以便 Git 在文件夾仍然是空的時候能夠跟踪這些文件夾。
第四步：在 Roblox Studio 中創建一個空白項目
- 打開 Roblox Studio，點擊 新體驗。
- 選擇 文件 → 保存到文件，導航到您的 WaveSurvival 文件夾，並將地方保存為 WaveSurvival.rbxlx。啟動倉庫的 .gitignore 已經將 .rbxlx 文件排除在 Git 之外。
- 保持 Studio 開放。您需要它來進行 Script Sync 和 MCP。
第五步：啟用 Script Sync 測試版
Script Sync 是一個測試版功能，因此您需要在使用之前將其開啟。
Studio 經常更新。如果您在列表中看不到 Script Sync，請安裝 最新版本的 Studio 再試一次。
- 在 Studio 中，選擇 文件 → 測試版功能。
- 找到 Script Sync，啟用它，並點擊 保存。
- 當出現提示時重啟 Studio。
第六步：連接 Script Sync
您可以通過將每個 Studio 服務連接到磁碟上的匹配文件夾，來為每個項目連接一次 Script Sync。
- 在資源管理器中，右鍵點擊 ServerScriptService。
- 選擇 Script Sync → 同步到，然後瀏覽到您的 WaveSurvival 文件夾。
- 對 ReplicatedStorage 和 StarterPlayerScripts 重複此操作。
請選擇頂層的 WaveSurvival 文件夾，而不是裡面的文件夾。由於這些文件夾已經具有正確的名稱，因此 Script Sync 自動將每個服務匹配到正確的位置。
您在這些文件夾中創建的任何 .luau 文件現在會自動顯示為 Studio 中的腳本。
第七步：驗證 Script Sync
在您編輯器的聊天面板中，提示您的代理：
在 ServerScriptService/Test.server.luau 創建一個測試腳本，將 'Hello from Script Sync!' 輸出到結果。
在 Studio 中檢查資源管理器。您應該會看到 Test 出現在 ServerScriptService 下。您將在連接 MCP 後進行更深入的代理驅動檢查。
第八步：啟用 MCP 連接
Studio MCP 伺服器允許您的 AI 代理直接與 Studio 交互，讀取遊戲樹、創建對象、運行腳本和檢查輸出。它涵蓋了 Script Sync 無法訪問的任何內容，如 StarterGui 和 StarterPack。
- 在 Studio 中，通過右上角的 助手 按鈕打開助手窗口。
- 點擊 ⋯ → 管理 MCP 伺服器。
- 確認已啟用 MCP。
- 在 快速連接 下，啟用 Cursor 或 Visual Studio Code。
如果您在 Studio 打開時安裝了編輯器，您可能需要重啟 Studio、編輯器或兩者以建立連接。欲了解更多詳細資訊，請參見 連接到 Roblox Studio MCP 伺服器。
第九步：驗證 MCP 連接
提示您的代理：
使用 Roblox MCP 讀取 Roblox Studio 中的當前遊戲樹。列出工作區中的內容。
您可能需要批准命令或將 MCP 工具添加到允許列表中。對於新的基座模板，回應將描述默認的 Camera、Terrain、Baseplate 和 SpawnLocation，並確認尚沒有其他內容。
第十步：運行端到端檢查
提示您的代理一次性驗證完整設置：
使用 Roblox MCP 連接驗證 Script Sync 是否正常工作。對 Test.server.luau 進行一些更改，新增另外兩個文件夾中的新腳本，並驗證每個腳本的輸出。在每個腳本中運行 game:GetService("InstanceFileSyncService"):GetStatus(instance) 以驗證同步狀態。完成後，刪除所有三個腳本。
在 Studio 中觀察，您將看到代理開始進行測試，以確認輸出。
第十一步：提交到 Git
現在您擁有了一個乾淨、可正常工作的配置，這是一個不錯的時機來提交。在您的終端中：
接下來的步驟
您的項目現在已經與 Studio 同步，您的 AI 代理可以直接與其交談，您還擁有一個 Git 倉庫來跟踪更改和進展。
從這裡開始，您可以使用啟動項目中的 WAVE_SURVIVAL.md 文件作為上下文，讓您的代理構建一個波生存遊戲。 請跟隨隨附的視頻，一次測試階段地構建該遊戲。