Unity CLI MCP 완전 가이드 — 로컬 AI로 유니티 게임을 만든다

> "Unity CLI MCP를 사용하면 별도의 유료 결제(월 10달러) 없이, 무료 로컬 AI 모델들을 연결하여 게임 개발이 가능하다."

기존 방식은 Unity Pro 라이센스나 유료 AI API가 필요했다. 하지만 MCP(Model Context Protocol) 서버를 통해 로컬 AI(Claude, Gemini, Ollama 등)를 유니티 엔진에 직접 연결하면, 월 비용 없이 AI가 코드를 짜고 테스트까지 수행하는 구조를 만들 수 있다.

0. MCP란 간단히 말하면?

MCP = AI 모델 ↔ 외부 프로그램(Utility) 연결 통로

AI가 유니티를 직접 조작할 수 있게 해주는 다리(Bridge) 역할이다. Claude Desktop이나 로컬 AI에서 "큐브를 하나 만들어줘"라고 하면, MCP 서버를 통해 유니티에 실제 큐브가 생성된다.

1단계: Unity CLI 설치 및 편집기 환경 설정

1-1. Unity Hub에서 CLI 설치

과거와 같이 터미널에서 복잡한 명령어를 칠 필요가 없다. 최신 Unity Hub를 이용하면 클릭 몇 번으로 설치된다.

1. Unity Hub (3.21 버전 이상) 실행
2. 상단의 도구 상자 아이콘 클릭
3. Unity CLI 메뉴에서 [설치] 클릭
4. 설치 완료 후 [열기] 눌러 터미널 실행

1-2. 로그인 및 라이센스 활성화

터미널 창에서 다음 두 명령어를 순서대로 입력한다:

# 1. 브라우저를 통한 CLI 전용 로그인
unity auth login

# 2. 계정에 맞는 라이센스 활성화
unity license activate

> unity auth login 실행 시 브라우저가 자동으로 열리며 Unity 계정으로 로그인한다. 로그인 완료 후 터미널로 돌아오면 인증이 완료된다.

1-3. 에디터 및 프로젝트 생성

# LTS 버전 편집기 설치
unity editors --install LTS

# 새 프로젝트 생성
unity project new [프로젝트명] --template [템플릿이름]

꿀팁: Unity Hub 설정에서 에디터와 프로젝트의 기본 경로를 미리 지정해 두면, CLI가 이 디폴트 경로를 자동으로 따라가므로 편리하다.

2단계: AI 에이전트 연결 및 MCP 구성

Unity CLI와 내 컴퓨터에 설치된 AI 모델을 MCP 서버로 엮어주는 단계다.

2-1. MCP 설정 파일 구성

터미널에서 다음 명령어를 실행한다:

# 연결 가능한 AI 플랫폼 목록 확인
unity mcp configure

# 사용하는 AI의 MCP 설정 추가
unity mcp configure claude        # Claude Desktop 연결 시
unity mcp configure gemini        # Gemini 연결 시
unity mcp configure ollama        # 로컬 Ollama 연결 시

unity mcp configure를 실행하면 Claude, VS Code, Kimi, Codex 등 연결 가능한 AI 플랫폼 목록이 표시된다. 내가 사용하는 AI의 이름을 지정하면 MCP 서버 항목 파일이 자동으로 추가된다.

2-2. 깃허브에서 Unity 스킬 주입

1. 구글에서 "Unity Skills" 검색 → 공식 GitHub 페이지로 이동
2. 스킬 패키지 지파일(.zip) 다운로드 → 압축 해제
3. 사용하는 AI 앱(예: Claude Desktop)의 설정 → 스킬(Skills) 탭으로 이동
4. 다운로드한 파일 중 'Unity CLI 스킬' 업로드하여 주입

> 꿀팁: AI가 수많은 명령어를 자동으로 처리할 수 있도록, 권한 설정은 '자동 허용'으로 체크해 두면 편하다.

3단계: CLI MCP로 실시간 게임 개발하기

환경 구축이 끝났다면 AI에게 말 한마디만 건네도 유니티 엔진을 직접 조작하며 게임을 만들어 준다.

3-1. 프로젝트 연동 및 파이프라인 설치

1. AI 프로젝트의 루트 폴더를 내 유니티 프로젝트 폴더로 지정
2. AI에게 "프로젝트를 실행해 줘"라고 명령하면 주입된 스킬을 통해 자동으로 워크스페이스를 연다
3. 이때 AI가 프로젝트 내부를 분석한 뒤 "Unity Pipeline 패키지가 없으니 설치할까요?"라고 먼저 제안
4. "네"라고 대답하면 개발에 필요한 핵심 파이프라인 패키지가 자동으로 세팅된다

3-2. 말 한마디로 오브젝트 배치 및 스크립트 작성

AI에게 다음과 같이 말하면 된다:

"현재 장면(Scene) 상황을 점검해 봐"
→ AI가 장면에 배치된 모든 hierarchy 객체들을 텍스트로 파악한다

"큐브 하나를 만들어서 씬 한가운데 놔줘"
→ AI가 직접 유니티에 큐브를 생성하고 배치한다

"총알 피하기 게임을 기획서대로 만들어 줘"
→ 에이전트는 기획에 필요한 C# 스크립트들을 스스로 판단하여 실시간으로 생성하고 유니티 프로젝트에 배치한다

3-3. AI 스스로 플레이 테스트 및 레벨 밸런싱

1. AI에게 "테스트 플레이 해봐"라고 명령
2. AI가 직접 Run Test를 돌리며 게임을 플레이한다
3. 테스트 중 오류가 나거나 밸런스가 맞지 않으면, AI가 스스로 코드를 수정한다
4. 결과를 깔끔한 표로 요약하여 보고한다
5. 사용자는 그저 게임이 완성되는 과정을 지켜보기만 하면 된다

핵심 정리

1단계: Unity Hub → CLI 설치 → auth login → license activate → editors --install LTS
2단계: unity mcp configure → GitHub에서 Unity Skills 다운로드 → AI 앱에 스킬 주입
3단계: 프로젝트 연동 → AI에게 명령 → 오브젝트 배치/스크립트 작성 → AI가 테스트+수정

> 핵심: 유료 AI API(월 $10~$100) 없이도, 로컬 AI 모델(Ollama 등)을 MCP 서버로 연결하면 무료로 게임 개발이 가능하다.

참고: 지원하는 AI 플랫폼

보충: 자주 묻는 질문

Q. Unity Pro 라이센스가 필요한가? A. 아니다. Personal 라이센스(무료)로도 MCP가 동작한다.

Q. 로컬 AI 모델은 어떤 것이 좋은가? A. 코딩용이라면 Qwen 2.5 Coder 7B 또는 Llama 3.1 8B가 적당하다. Ollama에서 ollama run qwen2.5-coder:7b로 설치 가능.

Q. C# 스크립트 품질은 어떤가? A. 단순한 스크립트(이동, 충돌, UI)는 거의 완벽하다. 복잡한 게임 로직은 AI가 생성한 코드를 검토하고 수정하는 과정이 필요하다.

Q. 모바일(안드로이드/iOS) 빌드도 가능한가? A. 가능하다. Unity CLI에서 unity build android 명령어로 빌드할 수 있다.

관련 글:

• 로컬 AI 양자화 포맷 완전 정리
• 그래픽카드별 로컬 AI 모델 추천 완전 가이드
• LM 스튜디오 + Llama 설치 완벽 가이드