# Unity — AI Game Developer Unity 6에 AI Game Developer 플러그인을 설치합니다. unity-mcp-cli 및 .unitypackage 설치 프로그램, 이렇게 두 가지 설치 경로와 AI 클라이언트 연결 방법, 첫 프롬프트 실행 방법을 안내합니다. 이 페이지는 영어에서 기계 번역되었습니다. [영어 원문 읽기](https://ai-game.dev/engines/unity). 엔진 · Unity AI Game Developer 플러그인을 Unity 프로젝트에 추가하고 AI로 에디터를 제어해 보세요. Unity 2022.3 LTS Unity 2023 Unity 6 (6000.x) 모든 2022.3+ 버전 01 ## 플러그인 설치 프로젝트에 플러그인을 추가하는 두 가지 방법 중 워크플로에 맞는 방식을 선택하세요. 권장 ### CLI unity-mcp-cli 도구로 설치합니다. 직접 다운로드할 필요 없이 터미널에서 명령어를 실행하세요. 1 CLI 설치 npm에서 unity-mcp-cli 를 전역으로 설치합니다. `npm install -g unity-mcp-cli` 2 Unity 설치 (선택 사항) CLI 로 Unity 에디터를 설치합니다. 이미 설치되어 있다면 건너뜁니다. `unity-mcp-cli install-unity 6000.3.9f1` 3 Unity 프로젝트 생성 (선택 사항) 새 Unity 프로젝트를 생성하거나 기존 프로젝트를 사용합니다. `unity-mcp-cli create-project ./MyUnityProject` 4 플러그인 설치 프로젝트에 Unity MCP 패키지를 설치합니다. `unity-mcp-cli install-plugin ./MyUnityProject` 5 Unity 프로젝트 열기 Unity 에디터에서 프로젝트를 엽니다. `unity-mcp-cli open ./MyUnityProject` ### 설치 프로그램 .unitypackage 설치 프로그램을 다운로드해 Unity 프로젝트에 바로 가져오세요. 한 번만 추가하면 되는 설치입니다. [.unitypackage 다운로드](https://github.com/IvanMurzak/Unity-MCP/releases/latest/download/AI-Game-Dev-Installer.unitypackage) 1 Unity 설치 (선택 사항) [Unity Hub](https://unity.com/download)를 다운로드하고 Unity 2022.3 LTS 이상의 에디터를 설치합니다. 이미 설치되어 있다면 건너뛰세요. 2 Unity 프로젝트 생성 (선택 사항) 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 플러그인 설정 가이드](https://ai-game.dev/docs/unity-plugin-setup)를 참고하세요. 02 ## 연결 호스팅된 클라우드 엔드포인트를 사용하거나 자체 서버를 지정하세요. ### 클라우드 기본 **ai-game.dev**에서 디바이스 코드 OAuth 흐름으로 연결하세요. 토큰을 직접 복사할 필요가 없습니다. AI Game Developer 창에서 **Cloud** 옵션을 선택하고 **Authorize** 버튼을 클릭한 뒤 브라우저에서 디바이스 코드를 승인하세요. 방화벽 환경에서도 작동하며 사용 분석을 제공합니다. 기본 방식이며 대부분의 사용자에게 권장합니다. ### 사용자 지정 모든 것을 로컬에서 실행하고 싶나요? 호스팅 엔드포인트 대신 자체 `gamedev-mcp-server` 인스턴스를 플러그인에 지정하세요. 그러면 AI 클라이언트가 바로 내 컴퓨터와 통신합니다. 클라이언트별 설정 스니펫은 [MCP 엔드포인트 페이지](https://ai-game.dev/mcp-endpoint-info)에 있습니다. 클라이언트 설정 스니펫(Claude, Cursor, Copilot, Gemini 등)이 필요하신가요? [MCP 엔드포인트 페이지 보기 →](https://ai-game.dev/mcp-endpoint-info) 03 ## AI 에이전트 구성 사용하는 AI 에이전트를 선택하고, Unity MCP 서버에 연결하는 정확한 `unity-mcp-cli` 명령을 복사하세요. 사용할 AI 에이전트 **Claude Code** 프로젝트에서 이 명령을 실행해 Unity용 **Claude Code** 구성을 완료하세요: `unity-mcp-cli setup-mcp claude-code ./MyUnityProject` **Claude Desktop** 프로젝트에서 이 명령을 실행해 Unity용 **Claude Desktop** 구성을 완료하세요: `unity-mcp-cli setup-mcp claude-desktop ./MyUnityProject` **Cursor** 프로젝트에서 이 명령을 실행해 Unity용 **Cursor** 구성을 완료하세요: `unity-mcp-cli setup-mcp cursor ./MyUnityProject` **VS Code (Copilot)** 프로젝트에서 이 명령을 실행해 Unity용 **VS Code (Copilot)** 구성을 완료하세요: `unity-mcp-cli setup-mcp vscode-copilot ./MyUnityProject` **Visual Studio (Copilot)** 프로젝트에서 이 명령을 실행해 Unity용 **Visual Studio (Copilot)** 구성을 완료하세요: `unity-mcp-cli setup-mcp vs-copilot ./MyUnityProject` **GitHub Copilot CLI** 프로젝트에서 이 명령을 실행해 Unity용 **GitHub Copilot CLI** 구성을 완료하세요: `unity-mcp-cli setup-mcp github-copilot-cli ./MyUnityProject` **Codex** 프로젝트에서 이 명령을 실행해 Unity용 **Codex** 구성을 완료하세요: `unity-mcp-cli setup-mcp codex ./MyUnityProject` **Gemini** 프로젝트에서 이 명령을 실행해 Unity용 **Gemini** 구성을 완료하세요: `unity-mcp-cli setup-mcp gemini ./MyUnityProject` **Cline** 프로젝트에서 이 명령을 실행해 Unity용 **Cline** 구성을 완료하세요: `unity-mcp-cli setup-mcp cline ./MyUnityProject` **Rider (Junie)** 프로젝트에서 이 명령을 실행해 Unity용 **Rider (Junie)** 구성을 완료하세요: `unity-mcp-cli setup-mcp rider-junie ./MyUnityProject` **Kilo Code** 프로젝트에서 이 명령을 실행해 Unity용 **Kilo Code** 구성을 완료하세요: `unity-mcp-cli setup-mcp kilo-code ./MyUnityProject` **Open Code** 프로젝트에서 이 명령을 실행해 Unity용 **Open Code** 구성을 완료하세요: `unity-mcp-cli setup-mcp open-code ./MyUnityProject` **Antigravity** 프로젝트에서 이 명령을 실행해 Unity용 **Antigravity** 구성을 완료하세요: `unity-mcp-cli setup-mcp antigravity ./MyUnityProject` **Unity AI** 프로젝트에서 이 명령을 실행해 Unity용 **Unity AI** 구성을 완료하세요: `unity-mcp-cli setup-mcp unity-ai ./MyUnityProject` **구성 후에는 에이전트를 다시 시작하세요.** 새 MCP 서버는 에이전트를 완전히 다시 시작해야만 인식됩니다. 창만 새로고침하지 말고 에이전트를 완전히 종료한 뒤 다시 여세요. 04 ## 첫 실행 창을 열고 승인한 뒤 첫 프롬프트를 시도해 보세요. 1. Unity 에디터에서 프로젝트를 연 뒤 **Window → AI Game Developer**로 이동하세요. 2. 패널에서 **Cloud**를 선택하고 **Authorize**를 클릭해 기기 코드 흐름을 완료하세요. 3. 상태 배지가 **Ready**(녹색)로 표시될 때까지 기다린 뒤 AI 클라이언트를 연결하세요. 4. AI 클라이언트에서 아래와 같은 프롬프트를 사용해 보고, 에디터에서 어떻게 동작하는지 확인해 보세요. 예시 프롬프트 ```text 디렉셔널 라이트와 회전하는 큐브가 있는 새 씬을 만든 뒤 플레이 모드로 들어가세요. ``` 더 많은 예시 프롬프트와 효과적인 AI 요청 패턴을 원하시나요? [Unity 모범 사례 보기 →](https://ai-game.dev/docs/best-practices/unity) [Unity 플러그인은 AI 클라이언트에 **72개 기능 (21개 MCP 도구 + RQL)**를 제공합니다.](https://ai-game.dev/docs/tools/unity) Unity 도구 카탈로그 둘러보기 → 더 많은 도구가 필요하신가요? [Unity 확장 둘러보기 →](https://ai-game.dev/docs/extensions/unity) --- Source (HTML): https://ai-game.dev/ko/engines/unity Machine-translated (ko) from the English page: https://ai-game.dev/engines/unity