Install & connect

Two steps: enable the plugin in your project, then point your AI agent at the local endpoint. The in-editor setup screen can do the second step for you with one click.

1. Install the plugin

Fab / Launcher install: install the plugin to your target Unreal Engine version, then enable it from the editor's plugin browser.

Manual source install:

1. Copy EditorAutomationRpcGateway into your project's (or the engine's) Plugins directory.
2. Regenerate project files if you use a C++ source checkout.
3. Build your project's editor target if Unreal asks for a rebuild.
4. Open the Unreal Editor and enable the plugin.
5. Confirm settings under Project Settings → Plugins → Editor Automation RPC Gateway.

2. The endpoint

The editor runs a streamable HTTP MCP server at http://127.0.0.1:19880/mcp. The port is a fixed 19880 by default — identical on every machine, which keeps committed agent configs portable across a team. Register the server under the name editor-automation; it exposes exactly one MCP tool, call.

Running several projects/editors at once? Enable Auto-derive Port From Project Path in Project Settings to give each project a stable port in 19880–30119, or set a fixed HttpPort of your choice. Those ports are machine-specific — don't commit baked configs. Substitute your resolved port for 19880 in the snippets below.

3. Connect your agent

“Project root” means the UE project the plugin is installed into. Pick your agent:

Claude Code

Create or merge <project>/.mcp.json:

{
  "mcpServers": {
    "editor-automation": { "type": "http", "url": "http://127.0.0.1:19880/mcp" }
  }
}

Or via CLI: claude mcp add --transport http --scope project editor-automation http://127.0.0.1:19880/mcp

Codex CLI

Create or merge <project>/.codex/config.toml:

[mcp_servers.editor-automation]
url = "http://127.0.0.1:19880/mcp"
startup_timeout_sec = 5.0
tool_timeout_sec = 300.0

Or user-globally: codex mcp add editor-automation --url http://127.0.0.1:19880/mcp

Cursor

Merge into <project>/.cursor/mcp.json (no type key — Cursor auto-detects):

{
  "mcpServers": {
    "editor-automation": { "url": "http://127.0.0.1:19880/mcp" }
  }
}

Recent Cursor versions add project-file servers disabled — enable it in Settings → Tools & MCP.

Gemini CLI

Create or merge <project>/.gemini/settings.json (the key is httpUrl, not url):

{
  "mcpServers": {
    "editor-automation": { "httpUrl": "http://127.0.0.1:19880/mcp" }
  }
}

VS Code (GitHub Copilot)

Create or merge <project>/.vscode/mcp.json (top-level key is servers):

{
  "servers": {
    "editor-automation": { "type": "http", "url": "http://127.0.0.1:19880/mcp" }
  }
}

Other clients

• Windsurf — ~/.codeium/windsurf/mcp_config.json, a "mcpServers" entry { "serverUrl": "http://127.0.0.1:19880/mcp" } (user-level only).
• Cline — cline_mcp_settings.json, entry { "type": "streamableHttp", "url": "http://127.0.0.1:19880/mcp" }.
• Stdio-only MCP clients — bridge with npx mcp-remote http://127.0.0.1:19880/mcp.

Next: Quickstart →