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.
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.
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.
Install the CLI from npm, then add the plugin to your project (it edits Packages/manifest.json for you):
npm install -g unity-mcp-cli
unity-mcp-cli install-plugin ./MyUnityProjectWith the OpenUPM CLI, run this in the project folder:
openupm add com.ivanmurzak.unity.mcpNo OpenUPM CLI? Add the scoped registry to Packages/manifest.json, then add the package in Window → Package Manager:
{
"scopedRegistries": [
{
"name": "package.openupm.com",
"url": "https://package.openupm.com",
"scopes": ["com.ivanmurzak", "extensions.unity"]
}
]
}Download the installer and import it with Assets → Import Package → Custom Package…. It adds the OpenUPM registry and the package to your project, so later updates come from the Package Manager.
⬇ Download AI-Game-Dev-Installer.unitypackageOpen the window and sign in
Open the AI Game Developer window and sign in once with your account.
- In Unity choose Window → AI Game Developer — MCP (
Ctrl+Alt+A, orCmd+Option+Aon macOS). - Keep the Connection switch on Cloud and click Authorize.
- Your browser opens the ai-game.dev sign-in page with a short code. Check the code matches and approve it.
- 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.
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 ./MyUnityProjectRestart the AI client after its config changes. For other clients and manual config, see Connecting AI clients and the MCP endpoint page.
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
Troubleshooting
Fixes for the problems people hit most. More in the Unity troubleshooting guide.
/mcp) or restart it. If it still lists nothing, click Configure for your agent again and restart the client.gamedev-mcp-server to Library/mcp-server/<platform>/. If a firewall or proxy blocked it, the window shows a server error with a Download / Retry button. In Cloud mode no local server is needed.unity-mcp-cli install-unity.