Install the Unreal-MCP plugin into your C++ project and drive the editor with AI.
Unreal Engine 5.5+Tested on 5.5–5.8C++ project
01
Install the plugin
The desktop app sets the plugin up for you. Prefer to do it yourself? Pick one of the paths below.
Easiest: the AI Game Dev app
Download the desktop app, open your Unreal Engine project and click Install Package: it installs the plugin, signs it in and connects your AI agent. No terminal, no Node.js.
Install via the unreal-mcp-cli tool on npm. Works with any UE 5.5+ C++ project on Windows, macOS and Linux.
1Install the CLI
Install unreal-mcp-cli globally from npm.
npm install -g unreal-mcp-cli
2Install the plugin
Install the Unreal-MCP plugin into your project.
unreal-mcp-cli install-plugin ./YourProject
3Authorize
Sign in once on this machine so the plugin can connect through ai-game.dev.
unreal-mcp-cli login
4Open the project
Open the project in the Unreal Editor.
unreal-mcp-cli open ./YourProject
OR
◆
Fab / Epic Marketplace
Get the plugin from its Fab listing and install it into your engine with the Epic Games Launcher — precompiled, nothing to build. The Fab build ships no executables, so you install the bridge once from the editor.
Add the listing to your Fab library, then in the Epic Games Launcher open Unreal Engine → Library → Fab Library and click Install to Engine for your engine version.
2Enable the plugin
In the editor: Edit → Plugins, find Unreal MCP (AI Game Developer) and enable it.
3Install the bridge
Open the AI Game Developer window from the Tools menu and click Get bridge: it opens the release page. Extract the zip for your platform into the folder that Open bridge folder shows, then click Connect. Repeat this after each plugin update.
02
Connect
Run through the hosted cloud endpoint, or point at your own server.
Using the AI Game Dev app? It installs, signs in and connects the Unreal Engine plugin for you, so skip steps 02 and 03 below: they connect your own MCP client, such as Claude Code, Cursor or Copilot.
Cloud
Default
Connect through ai-game.dev using the device-code OAuth flow — no tokens to copy by hand. From the AI Game Developer window choose Cloud, click Authorize, and approve the device code in your browser. Works across firewalls and gives you usage analytics. This is the default and what we recommend for most users.
Custom
Prefer to run everything locally? Point the plugin at your own gamedev-mcp-server instance instead of the hosted endpoint. Your AI client then talks straight to your machine. Client-by-client config snippets live on the MCP endpoint page.
Restart your agent after configuring. The new MCP server is only picked up on a full restart of the agent — quit it completely and reopen it (not just reload the window).
04
First run
Open the window, authorize, and try your first prompt.
1Open the AI Game Developer window from the editor Tools menu.
2Choose Cloud and click Authorize to complete the device-code flow.
3Wait for the connection to go green, then connect your AI client.
4Try a prompt like the one below and watch it act in the editor.
Example prompt
Create a new Actor blueprint with a static mesh cube and place three of them in the level.