FAQ

FAQ

Frequently asked questions about Unreal MCP.

---

General Questions

What is Unreal MCP?

Unreal MCP lets you control Unreal Engine using natural language through AI assistants like Claude, Cursor, and Windsurf. Just ask your AI to create actors, import assets, build levels, and more.

Which Unreal versions are supported?

Unreal Engine 5.0 through 5.7 are fully supported.

Which platforms work?

Windows, macOS, and Linux are all supported.

Do I need to know programming?

No! You interact through natural language. Just tell your AI what you want to do.

Is it free?

Yes! Open-source under MIT License. Completely free.

Can I use it in a shipped game?

No. This is an Editor-only tool. It cannot be used in packaged games.

---

Setup Questions

Do I need to install the MCP server?

No installation needed! When you use npx unreal-engine-mcp-server, it downloads and runs automatically. Just add the config to your AI client.

What's the minimum config I need?

Just this:

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

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

Where is my MCP config file?

AI Client	Location
Claude Desktop (Windows)	%APPDATA%/Claude/claude_desktop_config.json
Claude Desktop (Mac)	~/Library/Application Support/Claude/claude_desktop_config.json
Cursor	~/.cursor/mcp.json
Windsurf	~/.config/windsurf/mcp.json

Plugin failed to load on first open?

Just close and reopen your project. This is normal Unreal Engine behavior when a plugin is rebuilt for the first time.

---

Usage Questions

How do I spawn an actor?

Just ask your AI:

Spawn a point light at location 100, 200, 300

How do I create a Blueprint?

Create an Actor Blueprint called BP_Enemy in /Game/Blueprints

How do I import an asset?

Import the FBX file at C:/Models/character.fbx into /Game/Characters

How do I list assets?

List all assets in /Game/Characters

---

Troubleshooting Questions

Connection refused?

1. Make sure Unreal Editor is running
2. Confirm MCP Automation Bridge plugin is enabled
3. Check port 8091 isn't blocked by firewall

Tool not working?

1. Make sure required plugin is enabled (see Installation)
2. Check your spelling
3. Restart Unreal Editor

See Troubleshooting for more solutions.

---

More Help

Resource	Link
Quick Start	5-minute setup
Installation	Full guide
All Tools	36 tools reference
Issues	GitHub Issues
Community	Discussions