스크립트는 컴파일되는데 계층 구조가 안 맞다고? 게임 개발 UI 핸드오프와 MCP 체크리스트

인디 및 소규모 팀 개발에서 흔한 걸림돌은 “C# / GDScript를 못 짠다”가 아니라 스크립트는 컴파일되고 Scene을 열면 아무것도 맞지 않는다는 것입니다. 버튼은 클릭이 안 되고.

근본 원인은 AI 모델이 약해서가 아닙니다. UI 셸 핸드오프와 게임플레이 로직을 같은 툴체인에 섞는 것입니다. 아래에서 흔한 실패 유형, 인수 체크리스트, 그리고 Engine MCP(Unity MCP / Godot MCP / Cocos MCP)가 파이프라인에 들어가야 할 지점을 살펴봅니다.

---

두 가지 작업—하나의 AI 도구에 둘 다 강요하지 마세요

작업	일반적인 결과물	더 나은 도구
UI 셸	Canvas / Control 트리, Prefab, 앵커, 슬라이스 네이밍	구조화된 디자인 임포트 (PSD / Figma → 엔진)
게임플레이 로직	버튼 이벤트, 스탯, 상태 머신, Play 디버깅	Cursor / Claude Code + Engine MCP

Cursor, Copilot, Claude Code는 기본적으로 저장소 텍스트만 봅니다. 다음은 보지 못합니다:

• 에디터에서 저장되지 않은 Scene 편집
• 현재 선택 항목, 깨진 Prefab 참조
• Play 모드의 Console 및 일시적 UI 상태

그래서 AI가 .cs를 고쳐도 Hierarchy에서 Btn_Start에 여전히 OnClick이 없습니다. 이는 프롬프트 문제가 아니라 에디터 브리지 부재입니다. MCP가 그 간극을 메웁니다. 카테고리 지도: Godot / Unity용 AI 도구.

---

UI 임포트 후: 10가지 엔지니어링 점검

디자인 또는 Studio가 Prefab을 내보낸 후, 첫 Play 전에 다음을 실행하세요 (Unity UGUI 예시, Godot / Cocos도 유사하게 대응):

#	점검	흔한 실패
1	루트 Canvas / Control 및 해상도 정책	Canvas Scaler 잘못됨; 세로 Safe Area 잘림
2	히트 영역과 장식 분리	투명 이미지가 Raycast 차단
3	버튼 normal / pressed / disabled	정적 이미지 하나만
4	텍스트가 TMP / Label로 매핑	전체 화면 표시 타입, 현지화 불가
5	스크립트 친화적 노드 이름 (Btn_*, Panel_*)	Layer 47 copy
6	앵커 / 9-slice 및 스트레치 규칙	해상도 변경 시 레이아웃 흐트러짐
7	아틀라스 및 드로우 콜 허용 범위	컨트롤마다 과대 PNG 하나씩
8	임포트 경로가 프로젝트 규칙과 일치	MCP가 Prefab 경로를 못 찾음
9	로직 바인딩 전 커밋	AI가 스크립트 편집; 참조 끊김
10	16:9와 목표 세로 비율에서 한 번 Play	에디터 창 비율만 테스트

구조화된 임포트 vs 수동 슬라이싱: 수동 슬라이싱 없는 Figma → Unity, 인플레이스 UI 분할.

---

Engine MCP를 언제 설치할까

상황	권장
매일 게임플레이 변경, 잦은 Play / Console	해당 Engine MCP 설치
매주 수동 슬라이스로 UI를 다시 만듦	셸 먼저 해결 (Studio / 스펙 핸드오프), 그다음 MCP
스크립트만, Scene은 거의 안 건드림	MCP 이점 제한적
Game Jam, 당일 플레이 가능	UI는 Studio + 버튼은 MCP (워크스루)

Godot MCP는 오픈 소스—워크플로우를 먼저 검증하기 좋음: 설치 · 수동 vs MCP. Unity / Cocos: 공식 Pro 패키지—Unity MCP 설치 · Cocos 3.x.

세 엔진 선택: Godot MCP vs Unity MCP vs Cocos MCP.

---

권장 분할 (엔지니어링 관점)

디자인 파일 / 전체 화면 UI 아트
 → AI Studio: 임포트 · 분할 · Prefab 내보내기 (Unity / Godot / Cocos)
 → 엔지니어링이 위 10가지 점검 실행
 → Cursor + Engine MCP: OnClick, HUD, 스탯, Play 디버그 바인딩

변경 유형	경로
테마 교체 / 현지화 문구 / 전체 화면 리스킨	Studio 재내보내기 (리스킨, 번역)
감각, 충돌, AI, 저장, 버그	MCP + 수동 검토 코드
데미지 숫자, 픽셀 타입	Bitmap font 또는 TMP

경험 법칙: **셸은 Studio.

---

MCP 배선 후: 3가지 실천

1. 프롬프트는 검증 가능해야 함—Prefab 경로.
2. 작은 커밋—한 번에 하나씩: “시작 버튼 → 레벨 로드”.
3. MCP는 QA를 대체하지 않음—모델 생성 노드 편집도 Play가 필요; 클릭을 줄여줄 뿐 테스트는 아님.

Cursor와 Claude Code로 Unity: Unity MCP 워크플로우 가이드, Claude Code Unity MCP 연결.

도구 조합과 1주 롤아웃: 2026 게임 개발 AI 효율.

FAQ

Cursor로 충분한데 MCP가 필요한가요? 스크립트에는 충분합니다. Scene 트리.

MCP가 UI 슬라이싱을 대체할 수 있나요? 아니요. MCP는 에디터 내 객체를 관리; UI 구조는 여전히 Prefab 수준 핸드오프(Studio 또는 스펙 PSD / Figma 흐름)가 필요합니다.

엔진 하나만 쓰는데 Studio를 배울 가치가 있나요? UI 수정이 Canvas 재구축 시간을 잡아먹는다면 가치 있음; UI가 최소라면 플레이스홀더로 충분할 수 있습니다.

Godot 소규모 프로젝트—무엇을 먼저 설치? Godot MCP(오픈 소스)를 먼저 시도; UI 핸드오프가 아플 때 AI Studio 추가.

Unity AI UI Generator와 충돌? 충돌 없음. Unity AI는 에디터 스프라이트에 치중; 멀티 엔진 또는 구조화된 PSD/Figma 임포트에는 Studio + MCP가 일반적 조합입니다.