Unity MCP: Supported AI Clients (Cursor, Claude)
Which AI tools work with Unity MCP: one local unity-mcp server for Cursor, Claude Code, Codex, Windsurf, and Gemini CLI—shared Unity setup, smoke tests, and de…
- unity
- unity-mcp
- mcp
- cursor
- claude-code
- codex
- vberai
Which AI clients does Unity MCP support? Teams often assume each assistant needs its own Unity plugin. In practice Unity runs one local MCP Server (usually unity-mcp in the panel). Cursor, Claude Code, Codex, Windsurf, Cline, and Gemini CLI—any Model Context Protocol client—attach to the same bridge. What changes is client-side MCP config, not duplicate Unity packages.
Verify ports and labels against your VberAI Unity MCP build. Download: Unity MCP
Unity side: three steps for every client
- Package Manager → Add package from disk (Unity MCP install)
- Activate in Mcp Panel; Unity MCP Server shows Running (default port often 6589)
- Quick setup in the panel for your client, or paste endpoint / stdio into the client MCP list
If the server is not Running, every AI only sees disk .cs files, not Hierarchy / Console / selection.
Shared smoke test
- Read-only: list root GameObjects in the active scene
- Small write: create empty
MCP_SmokeTest, then delete - Commit before large agent edits; you still own Play mode and compile errors
Client comparison
| AI client | Typical hook-up | Deep dive |
|---|---|---|
| Cursor | Panel one-click → unity-mcp in Cursor MCP (Reload if needed) | Cursor + Unity MCP workflow |
| Claude Code | Quick setup → Copy CLI command | Claude Code + Unity MCP |
| Codex | After Running, add unity-mcp to Codex MCP settings (match panel) | FAQ below; active instances |
| Windsurf / Cline / Continue | MCP entry + Reload, same as Cursor pattern | Workflow guide |
| Gemini CLI | Quick setup → Gemini CLI → copy command | CLI flow in Claude install guide |
Best AI for Unity MCP? MCP is not tied to one LLM—use the client your repo already uses. Stable Running + visible tools beats switching models.
Shortest three steps per client (after Running)
Cursor
- Quick setup → Cursor → success toast
- Cursor Settings → MCP → unity-mcp + tools
- Read-only root node list
Claude Code
- Quick setup → Copy CLI command
- Run in Claude CLI environment
- Read-only root node list
Codex
- Copy panel URL or stdio
- Paste into Codex MCP config
- Restart Codex; empty tools → active instances
Scope
| In scope | Out of scope |
|---|---|
| Hierarchy, components, attach scripts, Console (per tools) | Builds, netcode, perf tuning |
| Swap clients on one server | One Unity plugin per AI brand |
| Wire UI after Studio import | Figma → Prefab without AI Studio |
Godot decision FAQ: Do you need Godot MCP?
Next steps
- Not installed → Unity MCP install
- Running → Quick setup + smoke test for your client
- Video walkthrough → Unity MCP plugin guide
FAQ
Which AI works with Unity MCP?
Any MCP client that reaches local unity-mcp—commonly Cursor, Claude Code, Codex, Windsurf, Cline, Gemini CLI. See comparison table.
Two Unity plugins for Cursor and Claude?
No. One server in Unity; register MCP in each client.
Codex does not see Unity tools?
Check Running, matching config, client restart; then active instances.
Do I have to hand-write all C#?
For everyday gameplay scripts, usually not: AI can create and edit C# through Unity MCP, attach scripts to GameObjects, and tweak Inspector fields (within the plugin’s tools). You focus on diff review, compile errors, and Play-mode checks. Architecture, netcode, and hot paths still deserve explicit human judgment—not because MCP cannot write code, but because those areas need careful ownership.
Keep reading
More guides you might like
Connect Claude Code to Unity MCP: Install, Configure & Verify
Use Claude with Unity MCP: Add package from disk, activate, start MCP Server (6589), copy Claude CLI command, verify Hierarchy read/write.Follow these five ste…
- unity
- mcp
- claude-code
- tutorial
Floating Damage Numbers: Handoff Acceptance and Engine Implementation
Fail criteria when popups blur, miss glyphs, sort wrong, or stutter; choosing TMP vs bitmap digits, pools and Canvas order, Unity UGUI acceptance steps, and ho…
- game-ui-design
- game-dev-ai
- ui-to-engine
- bitmap-font
How We Built a Real-Time MCP Server for Godot
Inside VberAI's Godot MCP architecture: how a real-time Model Context Protocol server bridges Godot's editor to AI clients without freezing the scene tree.
- vberai
- godot
- mcp
- architecture