Docs · Quickstart

From install to first tool call —
five minutes flat.

Four steps. Copyable commands. Snippets for 12 AI clients. By the end your AI agent is driving the Unity Editor in real time.

1
2
3
4

Install the Unity plugin

Three install paths — pick whichever fits your workflow. Most people use OpenUPM.

openupm add com.ivanmurzak.unity.mcp
No OpenUPM CLI? Use the scoped registry instead.

Under Edit → Project Settings → Package Manager add this scoped registry, then install the package by name.

{
  "scopedRegistries": [
    {
      "name": "package.openupm.com",
      "url": "https://package.openupm.com",
      "scopes": [ "com.ivanmurzak" ]
    }
  ]
}
Prefer a one-time drop-in? Use the .unitypackage installer.

Grab the latest installer from GitHub Releases ↗ and import via Assets → Import Package → Custom Package…

Need the full setup walkthrough with prerequisites and version notes? Open the deep dive →

Open Unity & verify the plugin

After installation completes, open the AI Game Developer panel and confirm it’s ready.

  1. In Unity, go to Window → AI Game Developer.
  2. The panel should dock with a ● Ready indicator.
  3. It will report 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

Anything that speaks MCP works. Pick yours below and copy the snippet — the bearer token comes from your API keys page.

{
  "mcpServers": {
    "ai-game-dev": {
      "url": "https://ai-game.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Run your first tool

Ask your AI client to call a tool. If it works, you’re done — your AI agent is now driving the Unity Editor in real time.

▸ Try one of these prompts
  • “List every GameObject in the active scene.”
  • “Create a cube called Player at the world origin and add a Rigidbody.”
  • “Take a screenshot of the game view.”

Your client should report calling tools like scene-get-data, gameobject-create, or screenshot-game. Want to see what else is available?

Browse the 81-tool catalog →

Common issues

The four most-reported gotchas. Bigger troubleshooting list lives in the Unity setup page.

Where to next?