Unity 플러그인 설정, 단계별 안내

• Unity 2022.3 이상 — Unity 6도 지원합니다.
• 기본 Cloud 연결에 필요한 ai-game.dev 계정 — 없다면 계정을 만드세요.
• AI 클라이언트 — AI Game Dev 앱, Claude Code, Cursor, Copilot, Gemini, Codex 또는 지원되는 MCP 클라이언트 14개 중 아무거나 사용할 수 있습니다.
• 처음 열 때 인터넷 연결 — 플러그인이 NuGet에서 .NET 패키지를 내려받습니다.

쉬운 방법부터 네 가지로 플러그인을 추가할 수 있습니다:

npm install -g unity-mcp-cli
unity-mcp-cli install-plugin ./MyUnityProject

openupm add com.ivanmurzak.unity.mcp

{
  "scopedRegistries": [
    {
      "name": "package.openupm.com",
      "url": "https://package.openupm.com",
      "scopes": ["com.ivanmurzak", "extensions.unity"]
    }
  ]
}

1. Unity에서 Window → AI Game Developer — MCP를 선택합니다(Ctrl+Alt+A, macOS에서는 Cmd+Option+A).
2. Connection 스위치를 Cloud에 둔 채 Authorize를 클릭합니다.
3. 브라우저에 짧은 코드와 함께 ai-game.dev 로그인 페이지가 열립니다. 코드가 일치하는지 확인하고 승인합니다.
4. Unity 상태가 Connected로 바뀝니다.

로그인 정보는 컴퓨터 전체에 저장됩니다. 앱이나 unity-mcp-cli login으로 이미 로그인했다면 에디터가 그 정보를 그대로 사용하므로 이 단계는 건너뛸 수 있습니다.

창에서 AI 에이전트 옆의 Configure를 클릭하거나 터미널에서 setup-mcp를 실행합니다. 둘 다 프로젝트에 고정된 URL과 프로젝트 키를 클라이언트 설정에 기록하므로 곧바로 연결됩니다:

# Claude Code — use your agent's id (cursor, codex, gemini, vscode-copilot, …)
unity-mcp-cli setup-mcp claude-code ./MyUnityProject

설정이 바뀐 뒤에는 AI 클라이언트를 다시 시작합니다. 다른 클라이언트와 수동 설정은 AI 클라이언트 연결과 MCP 엔드포인트 페이지를 참고하세요.

각 확장은 독립적인 Unity 패키지입니다. 설치되는 즉시 RQL을 통해 에이전트가 Unity의 한 영역을 익히도록 합니다. 인기 있는 확장 몇 가지는 다음과 같습니다:

• AI Animation기능 3개

  openupm add com.ivanmurzak.unity.mcp.animation

• AI Cinemachine기능 4개

  openupm add com.ivanmurzak.unity.mcp.cinemachine

• AI Terrain기능 4개

  openupm add com.ivanmurzak.unity.mcp.terrain

• AI Timeline기능 5개

  openupm add com.ivanmurzak.unity.mcp.timeline