◀ [이전회차] Unity와 AI로만 게임 만들기! 바이브 코딩의 핵심 가이드 (1) 바로가기
Unity MCP 연결하기
MCP를 설정하면 Claude Code가 Unity를 직접 조작할 수 있습니다. 이 장에서는 가장 널리 사용되는 mcp-unity를 설치합니다.
🔧 MCP 설치 방법
Step 1: Unity 프로젝트 생성
Unity Hub 실행
"새 프로젝트(New Project)" 클릭
템플릿 선택:
2D 게임: 2D (Built-In Render Pipeline)
3D 게임: 3D (Built-In Render Pipeline) 또는 3D (URP)
프로젝트 이름과 저장 위치 설정
"프로젝트 생성" 클릭
Step 2: Unity Package 설치
Unity 에디터가 열리면:
상단 메뉴에서 Window → Package Manager 클릭
좌측 상단 "+" 버튼 클릭
"Add package by name..." 선택
입력창에 아래 내용 입력:
com.unity.nuget.newtonsoft-json
"Add" 클릭
Step 3: MCP Unity 패키지 설치
다시 "+" 버튼 클릭
"Add package from git URL..." 선택
아래 URL 입력:
<https://github.com/CoderGamester/mcp-unity.git>
"Add" 클릭하고 설치 완료까지 대기
Step 4: MCP 서버 설정
설치가 완료되면 Unity 상단 메뉴에 "Tools"가 추가됩니다.
Tools → MCP Unity → Server Window 클릭
나타나는 창에서 "Start Server" 버튼 클릭
상태가 "Running"으로 바뀌면 성공
⚙️ Claude Code에 MCP 연결하기
Step 1: 설정 파일 위치 찾기
Windows:
C:\\\\Users\\\\[사용자이름]\\\\AppData\\\\Roaming\\\\Claude\\\\claude_desktop_config.json
Mac:
~/Library/Application Support/Claude/claude_desktop_config.json
💡 파일이 없다면? Claude Code를 한 번 실행했다가 종료하면 자동으로 생성됩니다.
Step 2: 설정 파일 수정
해당 파일을 메모장이나 VS Code로 열고, 아래 내용으로 수정합니다:
{
"mcpServers": {
"mcp-unity": {
"command": "node",
"args": [
"C:/Users/[사용자이름]/[Unity프로젝트경로]/Library/PackageCache/com.gamedevmcp.mcp-unity@[버전]/Server~/build/index.js"
]
}
}
}
⚠️ 주의: [사용자이름], [Unity프로젝트경로], [버전]을 실제 값 으로 바꿔야 합니다.
Step 3: 연결 확인
Unity에서 MCP 서버가 "Running" 상태인지 확인
터미널에서 프로젝트 폴더로 이동 후 Claude Code 실행:
cd "Unity프로젝트 경로"
claude
Claude Code에서 아래와 같이 입력해봅니다:
Unity에 빨간색 큐브를 하나 만들어줘
Unity 씬에 빨간 큐브가 나타나면 연결 성공! 🎉
🚫 MCP 없이 사용하기
MCP 설정이 어렵다면, MCP 없이도 사용할 수 있습니다:
Claude Code에게 코드 생성을 요청
Claude가 만든 코드를 복사
Unity에서 새 스크립트 생성 후 붙여넣기
이 방식도 충분히 효과적입니다. 다만 "복사-붙여넣기" 과정이 추가될 뿐입니다.
프롬프트 작성의 기초
프롬프트(Prompt) 란 AI에게 전달하는 요청/지시문입니다. 프롬프트를 어떻게 작성하느냐에 따라 결과물의 품질이 크게 달라집니다.
📝 좋은 프롬프트의 5가지 원칙
1️⃣ 구체적으로 작성하기
❌ 나쁜 예시:
"플레이어 만들어줘"
✅ 좋은 예시:
"WASD 키로 이동하고, 스페이스바로 점프하는 3D 플레이어 캐릭터를 만들어줘.
이동 속도는 5, 점프 높이는 2로 설정해줘."
2️⃣ 맥락 제공하기
AI는 여러분의 프로젝트에 대해 모릅니다. 필요한 배경 정보를 알려주세요.
✅ 좋은 예시:
"나는 2D 플랫포머 게임을 만들고 있어.
플레이어가 적과 충돌하면 HP가 1 감소하는 시스템을 만들어줘.
현재 PlayerController 스크립트에 이미 이동 로직이 있어."
3️⃣ 단계별로 나누기
복잡한 기능은 한 번에 요청하지 말고 나눠서 요청하세요.
❌ 나쁜 예시:
"인벤토리 시스템 만들어줘"
✅ 좋은 예시:
1단계: "아이템 데이터를 저장할 ScriptableObject 구조를 만들어줘"
2단계: "인벤토리 UI 레이아웃을 만들어줘"
3단계: "아이템을 추가/제거하는 로직을 만들어줘"
4단계: "아이템을 클릭하면 사용하는 기능을 추가해줘"
4️⃣ 예시나 참고 자료 활용하기
원하는 결과물의 예시가 있다면 공유하세요.
✅ 좋은 예시:
"젤다 야생의 숨결처럼 패러글라이더로 활강하는 시스템을 만들어줘.
- 점프 중 특정 키를 누르면 패러글라이더 발동
- 천천히 하강하면서 앞으로 이동
- 스태미나가 소모되고, 0이 되면 자동으로 접힘"
5️⃣ 제약 조건 명시하기
지켜야 할 규칙이 있다면 미리 알려주세요.
✅ 좋은 예시:
"적 AI를 만들어줘.
제약 조건:
- NavMesh는 사용하지 말고 간단한 방식으로
- Update에서 직접 움직이는 방식으로
- 모바일에서도 돌아갈 수 있게 성능 고려해줘"
🎯 프롬프트 템플릿
복사해서 바로 사용할 수 있는 템플릿입니다:
기능 요청 템플릿
## 목표
[만들고 싶은 기능을 한 문장으로]
## 상세 설명
[구체적인 동작 방식 설명]
## 조작 방법
- [키/버튼]: [동작]
- [키/버튼]: [동작]
## 참고 사항
- [지켜야 할 규칙이나 제약 조건]
- [참고할 만한 게임이나 예시]
버그 수정 템플릿
## 문제 상황
[어떤 문제가 발생하는지]
## 재현 방법
1. [첫 번째 단계]
2. [두 번째 단계]
3. [문제 발생]
## 예상 동작
[원래 어떻게 동작해야 하는지]
## 에러 메시지 (있다면)
[Unity 콘솔에 나온 에러 메시지 복사]
💬 대화 이어가기
Claude Code와의 대화는 일회성이 아닙니다. 결과가 마음에 들지 않으면 계속 수정을 요청하세요.
👤 You: 플레이어 이동 스크립트 만들어줘
🤖 Claude: [스크립트 생성]
👤 You: 이동 속도가 너무 빨라. 절반으로 줄여줘
🤖 Claude: [속도 수정]
👤 You: 대각선 이동할 때 속도가 더 빨라지는 문제가 있어. 수정해줘
🤖 Claude: [대각선 이동 정규화 적용]
👤 You: 좋아! 이제 달리기 기능도 추가해줘. Shift 누르면 1.5배 빨라지게
🤖 Claude: [달리기 기능 추가]📂 부록: 함께 읽으면 좋은 레시피 & 용어
▶ [다음회차] Unity와 AI로만 게임 만들기! 바이브 코딩의 핵심 가이드 (3) 바로가기
▶ [게임 기획] 서브 퀘스트 30개를 2주 안에? AI로 시나리오 뼈대 10분 만에 잡기
▶ [게임 QA] "기획서 5건, TC 마감 일주일... 엑셀 앞에서 멘붕 온 QA 테스터의 비장의 무기"