Claude Code와 Cursor로 Unity MCP 사용하기: 모든 변경을 직접 쓰지 않고 에디터 조작

“AI가 C#을 폴더에 쓴다”의 한계

채팅 기반 코딩 도구는 스크립트 생성에 능숙합니다. 파일만 편집하는 AI는 여전히 실시간 에디터 상태—열린 씬, 선택된 GameObject, 프리팹 변형, 플레이 모드 동작, Console 오류—를 놓칩니다.

모델이 디스크의 파일만 보면 계층 구조를 추측할 뿐, Play를 클릭하거나 Hierarchy에서 노드를 이름 변경하거나 누락된 참조를 검사할 수 없습니다. 팀은 저장소 안에서만이 아니라 엔진 루프 안에서 어시스턴트가 필요합니다.

**Model Context Protocol (MCP)**은 AI 클라이언트가 도구를 호출하는 표준 방법입니다. Unity MCP 서버는 로컬 브리지를 통해 에디터 작업을 노출하여 Claude Code, Cursor, Codex 스타일 워크플로우 같은 클라이언트가 Unity가 실행되는 동안 프로젝트를 읽고 변경할 수 있게 합니다.

VberAI는 해당 브리지를 위한 Unity MCP 플러그인을 제공합니다. 이 가이드는 기능 나열이 아닌 실용적인 설정 및 사용 경로입니다.

Unity MCP가 일상 작업에서 바꾸는 것

MCP 없이	MCP 사용 시
생성된 스크립트를 붙여넣고 컴파일 오류를 직접 수정	클라이언트에 스크립트 생성 및 지정된 GameObject에 연결 요청
UI 패널을 수동으로 복제	프롬프트: “Canvas 아래 Panel_Shop을 복제하고 자식 이름을 변경”
Console 오류를 채팅으로 설명	클라이언트가 최근 로그 / 선택 컨텍스트를 읽도록 허용 (플러그인이 노출하는 경우)
YAML에서 씬 레이아웃 추측	계층 구조를 쿼리한 후 확인을 거쳐 편집

여전히 diff와 플레이 모드 결과를 검토합니다. 에이전트가 안전하게 수행할 수 있는 모든 에디터 클릭을 직접 입력하지 않게 됩니다.

사전 요구 사항

• Unity 프로젝트가 열려 있어야 함 (팀 작업에는 LTS 권장)
• MCP 지원 클라이언트: Claude Code, Cursor, Windsurf 등
• 127.0.0.1에 대한 로컬 네트워크 액세스 (브리지는 일반적으로 루프백에 유지)
• Unity 버전에 맞는 VberAI Unity MCP 패키지 (다운로드 / 문서)

선택 사항이지만 유용: 작은 샘플 씬(빈 Canvas + 버튼 2개)으로 첫 프롬프트를 쉽게 확인할 수 있습니다.

설정 체크리스트

1. Unity MCP 플러그인 설치

1. 패키지를 프로젝트에 가져옵니다 (또는 팀의 패키지 워크플로우를 통해 설치)
2. 확장 프로그램 / 메뉴 항목을 활성화합니다 (빌드에 따라 이름이 약간 다를 수 있음—MCP 또는 AI Bridge 찾기)
3. Unity가 요청하면 에디터를 다시 로드합니다

2. 로컬 MCP 브리지 시작

플러그인 패널을 열고 서버를 시작합니다. 확인:

• 상태가 running으로 표시
• 호스트가 localhost (포트를 공개적으로 노출하지 마세요)
• 프로젝트 경로가 편집하려는 Unity 프로젝트와 일치

3. AI 클라이언트에 서버 등록

Cursor 또는 Claude Code에서 로컬 Unity 브리지를 가리키는 MCP 서버 항목을 추가합니다 (stdio 또는 HTTP/SSE—플러그인의 최신 문서를 따르세요).

도구가 나타나지 않으면 클라이언트를 다시 시작합니다. Unity 관련 도구(씬 읽기, 노드 작업 등)가 나열되어야 합니다.

4. 읽기 전용 스모크 테스트 실행

다음과 같이 요청합니다:

활성 씬의 루트 GameObject를 나열해 줘.

응답이 Hierarchy와 일치하면 브리지가 작동하는 것입니다. 그런 다음에만 쓰기 작업을 시도하세요.

5. 작은 쓰기 테스트 실행

다음과 같이 요청합니다:

씬 루트 아래에 MCP_SmokeTest라는 빈 GameObject를 생성해 줘.

Hierarchy에서 찾은 후 삭제합니다. 대규모 리팩터링 전에 되돌릴 수 있는 테스트를 선호합니다.

잘 작동하는 프롬프트 패턴

구조 먼저

Canvas/HUD의 자식을 보여주고 어떤 것이 LayoutGroup인지 요약해 줘.

집중된 쓰기

Canvas/Menu 아래에서 Button을 Btn_Start로 이름을 바꾸고 TMP 라벨 텍스트를 Start로 설정해 줘.

디버그 루프

Play를 누른 후 PlayerController와 관련된 Console 오류를 요약하고 가장 작은 수정을 제안해 줘.

생성된 UI와 페어링

AI Studio에서 화면을 가져온 경우 MCP를 사용하여 onClick 리스너를 연결하거나 C# 규칙에 맞게 이름을 정렬하세요—프리팹을 수동으로 다시 만들지 않고.

안전 습관

• 브리지를 localhost에서만 유지
• 하나의 거대한 “게임 재구축” 프롬프트보다 읽기 → 계획 → 쓰기를 선호
• 대규모 에이전트 편집 전에 커밋
• 프롬프트에 비밀을 붙여넣지 마세요; MCP는 액세스 제어를 대체하지 않습니다
• 플레이 모드와 에셋 데이터베이스 새로 고침을 인간 체크포인트로 취급

MCP는 수동 엔진 클릭을 줄입니다. 코드 검토를 제거하지는 않습니다.

내장 Unity AI 어시스턴트와의 관계

번들된 Unity 어시스턴트와 타사 Unity MCP 플러그인은 겹치는 작업을 해결합니다. 같은 방식으로 평가하세요:

1. 도구가 실시간 Hierarchy / 선택을 볼 수 있습니까?
2. 감사할 수 있는 되돌릴 수 있는 편집을 할 수 있습니까?
3. 팀이 이미 사용하는 AI 클라이언트(Claude Code, Cursor, …)와 작동합니까?

Unity MCP는 팀이 이미 이러한 클라이언트에서 작업하고 엔진 전반에 걸쳐 하나의 프로토콜을 원할 때 가장 강력합니다 (많은 스튜디오가 같은 습관으로 Godot 또는 Cocos MCP도 실행).

FAQ

여전히 C#을 작성해야 하나요?
네. MCP는 에디터 작업과 스캐폴딩에 가장 적합합니다. 게임플레이 시스템, 네트워킹, 성능 작업은 여전히 엔지니어가 필요합니다.

Claude Code vs Cursor?
둘 다 MCP를 지원하고 같은 로컬 Unity 서버를 가리키면 작동합니다. 저장소에서 이미 사용하는 클라이언트를 선택하세요; 브리지는 공유 부분입니다.

UI 전용인가요?
아니요. Hierarchy, 컴포넌트, 씬 작업은 게임플레이 객체에도 적용됩니다. UI는 단지 쉬운 첫 데모일 뿐입니다.

비디오 워크스루는 어디에 있나요?
VberAI 채널 경로의 Unity Game Engine MCP Plugin (video guide)에서 녹화된 설정 과정을 참조하세요.

다음 단계

1. 임시 씬에 Unity MCP 설치
2. Claude Code 또는 Cursor를 연결하고 읽기 전용 스모크 테스트 통과
3. 싫어하는 작업 하나를 자동화 (일괄 이름 변경, 패널 복제, 스크립트 연결)

디자인-투-프리팹이 에디터 작업 대신 병목이라면, 이를 Figma → Unity AI Studio 워크플로우와 페어링하세요.