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

엔진 · Unity

Unity사용 가능

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

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

플러그인 설치

프로젝트에 플러그인을 추가하는 두 가지 방법 중 워크플로에 맞는 방식을 선택하세요.

권장

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.9f1
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로 이동하세요.
  2. 패널에서 Cloud를 선택하고 Authorize를 클릭해 기기 코드 흐름을 완료하세요.
  3. 상태 배지가 Ready(녹색)로 표시될 때까지 기다린 뒤 AI 클라이언트를 연결하세요.
  4. AI 클라이언트에서 아래와 같은 프롬프트를 사용해 보고, 에디터에서 어떻게 동작하는지 확인해 보세요.
예시 프롬프트
디렉셔널 라이트와 회전하는 큐브가 있는 새 씬을 만든 뒤 플레이 모드로 들어가세요.

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

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

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

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