本指南及其附带的视频将引导您通过 MCP 将 AI 驱动的编码工具连接到 Roblox Studio，以便您的代理可以代表您读取、写入和进行游戏测试。
到最后，您将拥有一个项目文件夹，该文件夹通过 Script Sync（这是一项允许您使用自己的编辑器编写代码的功能）与 Studio 同步，以及一个 MCP 连接，使您的代理能够直接驱动 Studio，还有一个准备好的 Git 仓库以供开发。
步骤 1：安装先决条件
在开始之前，您需要以下组件：
- AI 驱动的文本编辑器 - 最流行的选项是 Visual Studio Code 和 Cursor。Cursor 内置了其 AI 助手，而 VS Code 需要像 Claude Code 这样的扩展。两者在这里都能很好地工作，因此请使用您更喜欢的版本。
- Roblox Studio - 从 create.roblox.com 下载。
- Git - 从 git-scm.com 安装。
步骤 2：登录到所有内容
- 您的文本编辑器：
- VS Code — 登录方式因扩展而异。对于 Claude Code，请点击活动栏中的 Claude 图标，使用您的 Anthropic 账户登录，并确认聊天面板打开。其他提供商类似。
- Cursor — 打开 Cursor，使用您的 Cursor 账户登录，并确认聊天面板打开。您可以使用任何您喜欢的模型。
- Roblox Studio — 打开 Studio，使用您的 Roblox 账户登录，并确认您可以创建一个新地点。
步骤 3：下载启动仓库
启动仓库为您提供文件夹布局和 .gitignore 文件，以便 Git 仅提交您项目中重要的部分。大部分手动设置已经为您完成。
- 下载 启动仓库 并解压缩。它已经包含一个名为 WaveSurvival 的文件夹。
- 在您的编辑器中，选择 文件 → 打开文件夹 并选择 WaveSurvival。您应该会看到三个文件夹在里面：
- ServerScriptService/ 包含服务器脚本，例如游戏逻辑、敌人 AI 和波管理。
- ReplicatedStorage/ 包含服务器和客户端都可以使用的共享模块。
- StarterPlayerScripts/ 包含为每个玩家运行的客户端脚本。
每个文件夹内的 .gitkeep 文件是占位符，以便 Git 跟踪这些文件夹，即使它们仍然为空。
步骤 4：在 Roblox Studio 中创建空白项目
- 打开 Roblox Studio 并点击 新体验。
- 选择 文件 → 保存到文件，导航到您的 WaveSurvival 文件夹，并将地点保存为 WaveSurvival.rbxlx。启动仓库的 .gitignore 已经排除了 .rbxlx 文件。
- 保持 Studio 打开。您需要它来进行 Script Sync 和 MCP。
步骤 5：启用 Script Sync 测试版
Script Sync 是一项测试版功能，因此您需要先启用它，才能使用。
Studio 经常更新。如果您在列表中看不到 Script Sync，请安装 最新版本的 Studio 并重试。
- 在 Studio 中，选择 文件 → 测试版功能。
- 找到 Script Sync，启用它，然后点击 保存。
- 按提示重新启动 Studio。
步骤 6：连接 Script Sync
您通过将每个 Studio 服务链接到磁盘上其匹配的文件夹来每个项目连接一次 Script Sync。
- 在资源管理器中，右键点击 ServerScriptService。
- 选择 Script Sync → 同步到，然后浏览到您的 WaveSurvival 文件夹。
- 对 ReplicatedStorage 和 StarterPlayerScripts 重复此操作。
选择顶级的 WaveSurvival 文件夹，而不是其中的文件夹。由于文件夹已经具有正确的名称，Script Sync 会自动将每个服务匹配到正确的文件夹。
您在那些文件夹中创建的任何 .luau 文件现在会自动作为脚本出现在 Studio 中。
步骤 7：验证 Script Sync
在您编辑器的聊天面板中，提示您的代理：
在 ServerScriptService/Test.server.luau 创建一个测试脚本，该脚本会将 'Hello from Script Sync!' 打印到输出中。
在 Studio 中，检查资源管理器。您应该会在 ServerScriptService 下看到 Test 出现。在连接 MCP 后，您会进行更深入的代理驱动检查。
步骤 8：启用 MCP 连接
Studio MCP 服务器允许您的 AI 代理直接与 Studio 交互，读取游戏树，创建对象，运行脚本并检查输出。它处理任何 Script Sync 无法到达的内容，例如 StarterGui 和 StarterPack。
- 在 Studio 中，使用右上角的 Assistant 按钮打开助手窗口。
- 点击 ⋯ → 管理 MCP 服务器。
- 确认 MCP 已启用。
- 在 快速连接 下，启用 Cursor 或 Visual Studio Code。
如果您在 Studio 打开时安装了编辑器，您可能需要重新启动 Studio、编辑器或两者以建立连接。有关更多详细信息，请参见 连接到 Roblox Studio MCP 服务器。
步骤 9：验证 MCP 连接
提示您的代理：
使用 Roblox MCP 读取 Roblox Studio 中的当前游戏树。列出 Workspace 中的内容。
您可能需要批准命令或将 MCP 工具添加到允许列表中。对于一个全新的 Baseplate 模板，响应描述默认的 Camera、Terrain、Baseplate 和 SpawnLocation，并确认当前没有其他内容。
步骤 10：进行端到端检查
提示您的代理一次验证完整的设置：
使用 Roblox MCP 连接来验证 Script Sync 是否正常工作。更改 Test.server.luau，添加其他两个文件夹中的新脚本，并验证每个脚本的输出。在每个脚本中运行 game:GetService("InstanceFileSyncService"):GetStatus(instance) 来验证同步状态。完成后，删除所有三个脚本。
在 Studio 中观看，您将看到代理开始进行游戏测试以确认输出。
步骤 11：提交到 Git
您现在有了一个干净、可工作的配置，这是一个很好的提交时机。从您的终端：
下一步
您的项目现在与 Studio 同步，您的 AI 代理可以直接与其对话，并且您有一个 Git 仓库来跟踪更改和进度。
从这里开始，您可以使用启动项目中的 WAVE_SURVIVAL.md 文件作为上下文，让您的代理构建一个波生存游戏。 跟随伴随视频逐步构建游戏，一次测试一个阶段。