Installation Guide

Installation Guide

Setting up Unity-MCP is a two-step process: installing the plugin into your Unity project and configuring your AI client.

Important

Path Requirement: Your Unity Project path must not contain spaces.

• ✅ C:/Projects/MyGame
• ❌ C:/My Projects/My Game

Step 1: Install Unity Plugin

You can install the plugin via a Unity Package or OpenUPM.

Option A: Download Installer (Recommended)

1. Download the latest AI-Game-Dev-Installer.unitypackage.
2. Open your Unity Project.
3. Double-click the downloaded file (or go to Assets -> Import Package -> Custom Package).
4. Click Import.

Option B: OpenUPM CLI

If you use OpenUPM, run this command in your project folder:

openupm add com.ivanmurzak.unity.mcp

Option C: Git URL

You can also install directly from GitHub (for development builds):

1. Open Unity Package Manager (Window -> Package Manager).
2. Click + -> Add package from git URL....
3. Enter: https://github.com/IvanMurzak/Unity-MCP.git?path=/Unity-MCP-Plugin/Assets/root

---

Step 2: Install MCP Client

You need an AI client that supports MCP.

Client	Recommendation
Claude Desktop	⭐ Best Experience. Native MCP support with latest Claude 3.5 Sonnet.
Cursor	Excellent for coding. Integrated directly into the IDE.
Windsurf	Another great AI-native IDE.
VS Code	Supported via GitHub Copilot or MCP extensions.

---

Step 3: Configuration

Once the plugin is installed:

1. Open Unity.
2. Go to menu Window -> AI Game Developer (Unity-MCP).
3. This window shows your Server Configuration (Port, Transport).
4. Click the Configure button next to your preferred MCP Client (e.g., Claude) to automatically inject the config.

If automatic configuration doesn't work, see the Manual Configuration page.