이 페이지는 영어에서 기계 번역되었습니다. 영어 원문 읽기.

엔진 · Unity

Unity사용 가능

AI Game Developer 플러그인을 Unity 프로젝트에 추가하고 AI로 에디터를 제어해 보세요.

Unity 2022.3 LTSUnity 2023Unity 6 (6000.x)모든 2022.3+ 버전
01

플러그인 설치

데스크톱 앱이 플러그인을 알아서 설정해 줍니다. 직접 설정하고 싶다면 아래 두 가지 방법 중 하나를 선택하세요.

가장 간편한 방법: AI Game Dev 앱

데스크톱 앱을 내려받아 Unity 프로젝트를 열고 Install Package를 클릭하세요. 플러그인 설치와 로그인, AI 에이전트 연결까지 한 번에 처리합니다. 터미널도 Node.js도 필요 없습니다.

CLI

unity-mcp-cli 도구로 설치합니다. 직접 다운로드할 필요 없이 터미널에서 명령어를 실행하세요.

1CLI 설치

npm에서 unity-mcp-cli 를 전역으로 설치합니다.

npm install -g unity-mcp-cli
2Unity 설치 (선택 사항)

CLI 로 Unity 에디터를 설치합니다. 이미 설치되어 있다면 건너뜁니다.

unity-mcp-cli install-unity 6000.3.1f1
3Unity 프로젝트 생성 (선택 사항)

새 Unity 프로젝트를 생성하거나 기존 프로젝트를 사용합니다.

unity-mcp-cli create-project ./MyUnityProject
4플러그인 설치

프로젝트에 Unity MCP 패키지를 설치합니다.

unity-mcp-cli install-plugin ./MyUnityProject
5Unity 프로젝트 열기

Unity 에디터에서 프로젝트를 엽니다.

unity-mcp-cli open ./MyUnityProject

설치 프로그램

.unitypackage 설치 프로그램을 다운로드해 Unity 프로젝트에 바로 가져오세요. 한 번만 추가하면 되는 설치입니다.

.unitypackage 다운로드
1Unity 설치 (선택 사항)

Unity Hub를 다운로드하고 Unity 2022.3 LTS 이상의 에디터를 설치합니다. 이미 설치되어 있다면 건너뛰세요.

2Unity 프로젝트 생성 (선택 사항)

Unity Hub로 새 Unity 프로젝트를 생성하거나 기존 프로젝트를 사용합니다.

3설치 프로그램 다운로드

위의 .unitypackage 다운로드 버튼을 사용해 AI-Game-Dev-Installer.unitypackage를 받으세요.

4패키지 가져오기

Unity 에서 Assets → Import Package → Custom Package… 를 열고 다운로드한 파일을 선택합니다.

패키지 레지스트리를 선호하시나요? 대신 OpenUPM으로 추가하세요: openupm add com.ivanmurzak.unity.mcp. 자세한 내용은 Unity 플러그인 설정 가이드를 참고하세요.

02

연결

호스팅된 클라우드 엔드포인트를 사용하거나 자체 서버를 지정하세요.

클라우드

기본

ai-game.dev에서 디바이스 코드 OAuth 흐름으로 연결하세요. 토큰을 직접 복사할 필요가 없습니다. AI Game Developer 창에서 Cloud 옵션을 선택하고 Authorize 버튼을 클릭한 뒤 브라우저에서 디바이스 코드를 승인하세요. 방화벽 환경에서도 작동하며 사용 분석을 제공합니다. 기본 방식이며 대부분의 사용자에게 권장합니다.

사용자 지정

모든 것을 로컬에서 실행하고 싶나요? 호스팅 엔드포인트 대신 자체 gamedev-mcp-server 인스턴스를 플러그인에 지정하세요. 그러면 AI 클라이언트가 바로 내 컴퓨터와 통신합니다. 클라이언트별 설정 스니펫은 MCP 엔드포인트 페이지에 있습니다.

클라이언트 설정 스니펫(Claude, Cursor, Copilot, Gemini 등)이 필요하신가요? MCP 엔드포인트 페이지 보기 →

03

AI 에이전트 구성

사용하는 AI 에이전트를 선택하고, Unity MCP 서버에 연결하는 정확한 unity-mcp-cli 명령을 복사하세요.

사용할 AI 에이전트

프로젝트에서 이 명령을 실행해 Unity용 Claude Code 구성을 완료하세요:

unity-mcp-cli setup-mcp claude-code ./MyUnityProject

구성 후에는 에이전트를 다시 시작하세요. 새 MCP 서버는 에이전트를 완전히 다시 시작해야만 인식됩니다. 창만 새로고침하지 말고 에이전트를 완전히 종료한 뒤 다시 여세요.

04

첫 실행

창을 열고 승인한 뒤 첫 프롬프트를 시도해 보세요.

  1. Unity 에디터에서 프로젝트를 연 뒤 Window → AI Game Developer — MCP로 이동하세요.
  2. 패널에서 Cloud를 선택하고 Authorize를 클릭해 기기 코드 흐름을 완료하세요.
  3. Unity 상태가 Connected로 표시될 때까지 기다린 다음 AI 클라이언트를 연결하세요.
  4. AI 클라이언트에서 아래와 같은 프롬프트를 사용해 보고, 에디터에서 어떻게 동작하는지 확인해 보세요.
예시 프롬프트
디렉셔널 라이트와 회전하는 큐브가 있는 새 씬을 만든 뒤 플레이 모드로 들어가세요.

더 많은 예시 프롬프트와 효과적인 AI 요청 패턴을 원하시나요? Unity 모범 사례 보기 →

05

Unity 가이드

첫 프롬프트 이후의 모든 내용은 Unity 위키에 있습니다.

Unity 플러그인은 AI 클라이언트에 72개 기능 (21개 MCP 도구 + RQL)를 제공합니다.

Unity 도구 카탈로그 둘러보기 →

더 많은 도구가 필요하신가요? Unity 확장 둘러보기 →