Unity · manual setup

Unity plugin setup, step by step

Everything to go from an empty Unity project to an AI agent working in the Editor: install the plugin, sign in, connect your AI client and add the extensions you need. The Unity install page has the short version.

01

Before you start

Unity 2022.3 or newer, an ai-game.dev account and an AI client.

  • Unity 2022.3 or newer — Unity 6 is supported.
  • An ai-game.dev account for the default Cloud connection — create one if you have none.
  • An AI client — the AI Game Dev app, Claude Code, Cursor, Copilot, Gemini, Codex or any of the 14 supported MCP clients.
  • Internet access on first open — the plugin downloads its .NET packages from NuGet.
02

Install the plugin

With the app, the CLI, OpenUPM or the installer package — pick one.

Four ways to add the plugin, from the easiest:

Open your Unity project in the AI Game Dev app and click Install Package. The app installs the newest plugin from OpenUPM, signs it in and sets up your agent.

03

Open the window and sign in

Open the AI Game Developer window and sign in once with your account.

  1. In Unity choose Window → AI Game Developer — MCP (Ctrl+Alt+A, or Cmd+Option+A on macOS).
  2. Keep the Connection switch on Cloud and click Authorize.
  3. Your browser opens the ai-game.dev sign-in page with a short code. Check the code matches and approve it.
  4. The Unity status changes to Connected.

The sign-in is stored for the whole computer: if you already signed in with the app or unity-mcp-cli login, the Editor uses it and you can skip this step.

04

Connect your AI client

One command, or one click in the window, writes your client's config.

In the window, click Configure next to your AI agent — or run setup-mcp from a terminal. Both write the project-pinned URL and a project key into the client's config, so it connects straight away:

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

Restart the AI client after its config changes. For other clients and manual config, see Connecting AI clients and the MCP endpoint page.

05

Add extensions (optional)

Animation, Cinemachine, Terrain, Timeline and more — install only what you need.

Each extension is its own Unity package. It teaches the agent one area of Unity through RQL as soon as it is installed. A few popular ones:

  • AI Animation3 capabilities
    openupm add com.ivanmurzak.unity.mcp.animation
  • AI Cinemachine4 capabilities
    openupm add com.ivanmurzak.unity.mcp.cinemachine
  • AI Terrain4 capabilities
    openupm add com.ivanmurzak.unity.mcp.terrain
  • AI Timeline5 capabilities
    openupm add com.ivanmurzak.unity.mcp.timeline
All 10 Unity extensions →
?

Troubleshooting

Fixes for the problems people hit most. More in the Unity troubleshooting guide.