Docs · Unity Plugin Setup

From zero to AI-driven Editor
in ten minutes.

Install the AI Game Developer plugin, verify it loaded, connect your favourite AI client, and bolt on domain extensions. No CLI dance — the plugin auto-downloads its native MCP server on first run.

Prerequisites

Unity 6000.x or 2022.3 LTS, an ai-game.dev account, and an MCP-compatible AI client.

Unity — 6000.x (preferred) or 2022.3 LTS. Older versions may work but aren’t tested.
An ai-game.dev account — sign up if you don’t have one.
An AI client — Claude Desktop, Cursor, GitHub Copilot, Gemini, Codex, or any of the 12 supported MCP clients.
Internet access from the Unity Editor (the plugin downloads its native MCP server binary on first run).

Install the plugin

Add the OpenUPM scope and install the package, or download the installer .unitypackage.

Three install paths — pick whichever fits your workflow:

Cleanest install — uses Unity Package Manager with the OpenUPM scoped registry.

openupm add com.ivanmurzak.unity.mcp

No CLI? Add this scoped registry manually under Edit → Project Settings → Package Manager:

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

Verify the plugin loaded

Open the AI Game Developer panel in the Unity Editor and confirm the green status.

After installation completes, open the AI Game Developer panel:

In Unity, go to Window → AI Game Developer.
You should see the panel dock with a ● Ready indicator.
The panel reports the MCP server port (deterministic per project — derived from your project path).

✓Panel docks under Window → AI Game Developer.

✓Status reads Ready (green).

✓Port number is shown — usually in the 20000–29999 range.

✓No errors in the Unity Console with the AI-Game-Dev tag.

Connect your AI client

Drop one config snippet into your AI client. Tools, prompts, resources are negotiated automatically.

Two modes are supported:

Direct (local) — your client talks straight to the Unity-MCP server on its deterministic port. Great for local-only development.
Through ai-game.dev (recommended) — your client talks to https://ai-game.dev/mcp, which routes to your Editor over a persistent SignalR connection. Works across firewalls, gives you usage analytics, and the same config works on every machine you log in from.

Full client-by-client config snippets live on the MCP endpoint page.

Add domain extensions (optional)

Animation, ParticleSystem, ProBuilder — drop in only what you need.

Extensions are standalone Unity packages. Once installed, the plugin auto-registers their tools and your AI client picks them up on its next connect.

AI Animation6 tools

AnimationClip + AnimatorController authoring.

openupm add com.ivanmurzak.unity.mcp.animation

AI ParticleSystem2 tools · 24 modules

Inspect & modify every particle module.

openupm add com.ivanmurzak.unity.mcp.particlesystem

AI ProBuilder13 tools

Mesh modeling — extrude, bevel, bridge, UVs.

openupm add com.ivanmurzak.unity.mcp.probuilder

⚠

Troubleshooting

The fixes for the six most common gotchas, drawn straight from our support channel.

Next stop

Browse the tool catalog →80+ MCP tools across Scene, Asset, Editor, and more.Connect a client →Config snippets for all 12 supported AI clients.5-minute quickstart →The condensed version, if you want it on one page.

From zero to AI-driven Editorin ten minutes.

Next stop

From zero to AI-driven Editor
in ten minutes.