Quick Start

Quick Start

Get up and running with Unreal MCP in 5 minutes.

---

Prerequisites

Requirement	Version
Node.js	18+
Unreal Engine	5.0 - 5.7
AI Client	Claude Desktop, Cursor, Windsurf, etc.

---

Step 1: Copy Plugin to Your Project

The plugin is located at plugins/McpAutomationBridge in the repository.

Copy:  Unreal_mcp/plugins/McpAutomationBridge/
To:    YourProject/Plugins/McpAutomationBridge/

Regenerate project files after copying.

First-time tip: If you see "Plugin failed to load" when opening the project, just close and reopen. This is normal UE behavior.

---

Step 2: Enable Plugin in Unreal

1. Open your project in Unreal Editor
2. Go to Edit → Plugins
3. Search for "MCP Automation Bridge"
4. Enable it
5. Restart the editor

---

Step 3: Add MCP Config to Your AI Client

Just copy-paste this into your config file:

Claude Desktop

Config file location: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "unreal-engine": {
      "command": "npx",
      "args": ["unreal-engine-mcp-server"],
      "env": {
        "UE_PROJECT_PATH": "C:/Path/To/YourProject"
      }
    }
  }
}

Cursor

Config file location: ~/.cursor/mcp.json

{
  "mcpServers": {
    "unreal-engine": {
      "command": "npx",
      "args": ["unreal-engine-mcp-server"],
      "env": {
        "UE_PROJECT_PATH": "C:/Path/To/YourProject"
      }
    }
  }
}

Windsurf

Config file location: ~/.config/windsurf/mcp.json

Same as Cursor config above.

---

What You Need to Change

Only one line needs to be changed:

"UE_PROJECT_PATH": "C:/Path/To/YourProject"

Replace C:/Path/To/YourProject with your actual Unreal project folder path.

Examples:

• Windows: "C:/Users/John/Documents/Unreal/MyGame"
• Mac: "/Users/john/Unreal/MyGame"
• Linux: "/home/john/Unreal/MyGame"

---

How It Works

Part	What It Does
npx	Downloads and runs the MCP server automatically (no install needed)
unreal-engine-mcp-server	The package name from NPM
UE_PROJECT_PATH	Tells the server where your Unreal project is

---

Step 4: Test It

1. Open your Unreal project
2. Start Claude Desktop (or your AI client)
3. Ask:

List all assets in /Game

If you see your assets listed, it's working!

---

Example Commands

Task	Ask Your AI
Spawn actor	"Spawn a cube at location 0, 0, 100"
Create Blueprint	"Create an Actor Blueprint called BP_Enemy in /Game/Blueprints"
Add light	"Spawn a point light at 100, 200, 300"
Create material	"Create a material called M_Glow in /Game/Materials"
Screenshot	"Take a screenshot of the viewport"

---

Need Help?

• Installation - Detailed setup
• Configuration - All settings
• Troubleshooting - Common issues