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

이 가이드와 동영상은 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단계: 시작 리포지토리 다운로드

시작 리포지토리는 폴더 레이아웃과 Git이 프로젝트의 중요한 부분만 커밋하도록 하는 .gitignore 파일을 제공합니다. 대부분의 수동 설정이 이미 완료되어 있습니다.

시작 리포지토리를 다운로드하고 압축을 풉니다. 이미 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와 직접 상호작용할 수 있게 해주며, 게임 트리를 읽고, 객체를 생성하고, 스크립트를 실행하고, 출력을 확인할 수 있습니다. Script Sync가 도달할 수 없는 StarterGui 및 StarterPack와 같은 모든 것을 포함합니다.

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 파일을 사용하여 에이전트가 웨이브 생존 게임을 구축할 수 있는 컨텍스트를 제공합니다. 동영상과 함께 진행하여 게임을 한 번에 하나의 테스트된 단계로 구축하세요.