코딩 하네스를 사용하여 빌드하기 | 설명서

이 가이드와 동영상은 MCP를 통해 AI 지원 코딩 하네스를 Roblox Studio에 연결하여 에이전트가 귀하를 대신하여 읽고 쓰고 플레이 테스트할 수 있도록 안내합니다.

끝나면 Script Sync(자신의 편집기를 사용하여 코드를 작성할 수 있는 기능)를 통해 Studio와 동기화되는 프로젝트 폴더와 에이전트가 Studio를 직접 조종할 수 있는 MCP 연결, 개발을 위한 Git 저장소를 갖게 됩니다.

1단계: 필수 구성 요소 설치

시작하기 전에 다음 구성 요소가 필요합니다:

AI 지원 텍스트 편집기 - 가장 인기 있는 옵션은 Visual Studio Code와 Cursor입니다. Cursor는 AI 어시스턴트가 내장되어 있고, VS Code는 Claude Code와 같은 확장을 필요로 합니다. 두 가지 모두 잘 작동하므로 선호하는 것을 사용하세요.
Roblox Studio - create.roblox.com에서 다운로드하세요.
Git - git-scm.com에서 설치하세요.
- Windows에서는 WinGet을 사용할 수 있습니다: winget install --id Git.Git -e --source winget.
- macOS에서는 Homebrew를 사용할 수 있습니다: brew install git.

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 파일을 Git의 포함에서 제외합니다.
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와 직접 상호작용할 수 있도록 하며, 게임 트리를 읽고, 객체를 생성하고, 스크립트를 실행하고, 출력을 확인할 수 있습니다. 이는 StarterGui 및 StarterPack와 같이 Script Sync가 도달할 수 없는 모든 것을 포함합니다.

Studio에서 오른쪽 상단의 Assistant 버튼을 사용하여 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을 설명하고 아직 다른 콘텐츠가 없음을 확인합니다.

Roblox MCP 연결을 사용하여 Script Sync가 제대로 작동하는지 확인하세요. Test.server.luau를 수정하고 나머지 두 폴더에 새 스크립트를 추가한 다음, 각 스크립트의 출력을 확인하세요. 각 스크립트에서 game:GetService("InstanceFileSyncService"):GetStatus(instance)를 실행하여 동기화 상태를 확인하세요. 완료되면 세 스크립트를 모두 삭제하세요.

Studio에서 지켜보면 에이전트가 출력을 확인하기 위해 플레이 테스트를 시작하는 것을 볼 수 있습니다.

11단계: Git에 커밋하기

이제 깨끗하고 작동하는 구성이 되었으므로 커밋하기에 좋은 시점입니다. 터미널에서:


git add .
git commit -m "Script sync 연결 및 MCP 확인됨"

다음 단계

이제 프로젝트가 Studio와 동기화되었고, AI 에이전트가 직접 대화할 수 있으며 변경사항 및 진행 상황을 추적할 Git 저장소가 있습니다.

이제 시작 프로젝트의 WAVE_SURVIVAL.md 파일을 에이전트가 웨이브 서바이벌 게임을 구축하기 위한 контекст로 사용할 수 있습니다. 동영상과 함께 진행하여 게임을 검증된 단계별로 구축하세요.