本指南和随附视频将引导您通过MCP将AI启用的编码工具连接到Roblox Studio，以便您的代理可以代表您读取、编写和测试游戏。
到最后，您将拥有一个通过脚本同步（一个允许您使用自己的编辑器编写代码的功能）与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文件。
- 保持Studio打开。您将需要它进行脚本同步和MCP。
第五步：启用脚本同步测试版
脚本同步是一个测试版功能，因此您需要在使用之前将其打开。
Studio经常更新。如果您在列表中看不到脚本同步，请安装最新版本的Studio并重试。
- 在Studio中，选择文件 → 测试版功能。
- 找到脚本同步，启用它，然后单击保存。
- 在提示时重新启动Studio。
第六步：连接脚本同步
您通过将每个Studio服务链接到其在磁盘上的匹配文件夹来每个项目连接一次脚本同步。
- 在资源管理器中，右键单击ServerScriptService。
- 选择脚本同步 → 同步到，然后浏览到您的WaveSurvival文件夹。
- 对ReplicatedStorage和StarterPlayerScripts重复此操作。
选择顶级的WaveSurvival文件夹，而不是其中的文件夹。由于这些文件夹已经具有正确的名称，脚本同步会自动将每个服务匹配到正确的文件夹。
您在这些文件夹中创建的任何.luau文件现在会自动作为脚本出现在Studio中。
第七步：验证脚本同步
在您编辑器的聊天面板中，提示您的代理：
在ServerScriptService/Test.server.luau创建一个测试脚本，该脚本将'Hello from Script Sync!'打印到输出。
在Studio中，检查资源管理器。您应该会看到Test出现在ServerScriptService下。连接MCP后，您将进行更深入的代理驱动检查。
第八步：启用MCP连接
Studio MCP服务器允许您的AI代理直接与Studio交互，读取游戏树、创建对象、运行脚本和检查输出。它涵盖了脚本同步无法到达的任何内容，例如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连接验证脚本同步是否正常工作。对Test.server.luau进行一些更改，在其他两个文件夹中添加新脚本，并验证每个脚本的输出。在每个脚本中运行game:GetService("InstanceFileSyncService"):GetStatus(instance)以验证同步状态。当您完成时，删除所有三个脚本。
在Studio中观察，您将看到代理开始进行游戏测试以确认输出。
第十一步：提交到Git
您现在拥有一个干净、可工作的配置，这使得此时提交是一个好时机。从您的终端：
git add .
git commit -m "脚本同步已连接，MCP已验证"下一步
您的项目现在已与Studio同步，您的AI代理可以直接与其对话，并且您有一个Git存储库来跟踪更改和进度。
从这里开始，您可以使用启动项目中的WAVE_SURVIVAL.md文件作为上下文，让您的代理构建一个波生存游戏。 跟随伴随视频逐步构建游戏，每次测试一个阶段。