Unity MCP Install Guide: Add Package from Disk and Connect an AI IDE

What This Guide Covers

Follow these five steps to connect Unity MCP (VberAI Pro) to a local Unity project so Cursor (or another MCP-capable AI IDE—steps are similar) can operate, preview, and debug the editor—not just edit scripts on disk.

When you finish, you should be able to:

• Import Unity MCP via Package Manager Add package from disk
• Activate with a VberAI account or email + activation code
• Start the local Unity MCP Server (default port 6589)
• Use Quick Setup → Auto configure to register the server in Cursor and confirm the connection

Product page: VberAI Unity MCP

This guide uses Cursor as the example. Claude Code, Windsurf, Cline, and other MCP clients follow the same idea.

Prerequisites

Item	Notes
Unity	2022.3+ / Unity 6 recommended (follow the current site support notes)
Plugin package	Unity MCP Pro archive from the official site, already unzipped
Activation	VberAI account + password, or email + activation code
AI IDE	Cursor recommended; other MCP clients also work
Local network	The MCP bridge usually runs on 127.0.0.1—do not expose the port publicly

Step 1: Download Unity MCP

Download the Pro build from the VberAI site:

Download page: https://www.vberai.com/game-engines/unity?ch=CQZLC2FG

Suggested flow:

1. Open the page and download Unity MCP Pro with your account permissions
2. Save the archive locally and unzip it to a fixed folder (next step needs package.json inside)
3. Confirm package.json exists in the unzipped folder before opening Unity

OSS vs Pro differences and pricing follow the current official docs.

Step 2: Import the package

1. Open your target Unity project
2. Menu Window → Package Manager
3. Click + in the top-left of the Package Manager panel
4. Choose Add package from disk
5. Select the package.json file from the unzipped folder in Step 1

After a successful import, the Unity MCP package should appear in the Package Manager list.

Step 3: Activate unity-mcp

1. Menu Window → Unity MCP → Mcp Panel
2. On the activation screen, either:
   • Sign in with VberAI account + password
   • Or enter email + activation code
3. After activation succeeds, open the MCP Server settings page (next step)

Without activation the service usually will not start. Confirm your plan or code matches the current Pro build.

Step 4: Start unity-mcp-server

1. After activation, open the Unity MCP Server settings page
2. Adjust as needed:
   • Port: default 6589
   • Language: match your UI preference
   • Startup: follow panel options (e.g. auto-start with the editor, if available)
3. Click Start service
4. When the panel shows Running, Unity MCP Server is up

You now have a local MCP bridge—next, hand it to your AI IDE.

Step 5: One-click AI IDE setup (Cursor example)

1. Open Tool management
   • Review tools exposed by Unity MCP Server
   • Enable only what you want the model to use
2. Open Quick setup
   • Pick your IDE (e.g. Cursor)
   • Click Auto configure
   • Confirm the UI shows Configured
3. Open Cursor
   • MCP / tools should list unity-mcp as connected
   • If not, click Reload (or the equivalent MCP reload) in Cursor and check again

Other IDEs use the same Quick setup flow—just switch the client.

Quick check after connecting

In Cursor, start with a read-only check, for example:

List the root objects in the Hierarchy of the scene currently open in Unity.

If the reply matches the editor, the bridge is healthy. Then try a small write (create a temporary empty GameObject and delete it) to confirm permissions and tool selection.

FAQ

Add package from disk cannot find package.json?
Confirm Step 1 fully unzipped the archive and you selected package.json at the root of that folder—not a nested extract.

Activation keeps failing?
Check Pro entitlement, code expiry, and email binding in your official account, then retry in Mcp Panel.

Started the service but not Running?
Ensure port 6589 (or your custom port) is free and localhost is not blocked. Confirm Step 3 activation succeeded.

Cursor does not show unity-mcp?
Confirm Unity still shows Running, run Quick setup → Auto configure again, then reload MCP in Cursor. If needed, verify Cursor’s MCP config points at the local bridge.

Next steps

• Try a natural-language scene query or small edit to learn tool boundaries
• Commit before large changes; keep the bridge on localhost only
• For design-to-engine UI, pair with VberAI AI Studio for Figma / PSD handoff, then iterate with MCP

More Unity + MCP context: Unity MCP video guide, Unity MCP with Claude Code and Cursor.