Connecting Your CLI Agent

Your agent needs one thing: an MCP client entry pointing at the editor’s local server. Conductor Terminal can write that for you, or you can do it by hand in about thirty seconds.

The endpoint

Read the values from Project Settings → Plugins → Model Context Protocol:

	Default
Host	127.0.0.1
Port	8000
URL path	/mcp
Server name	unreal-mcp

Giving http://127.0.0.1:8000/mcp.

On UE 5.7 and earlier

The equivalent was Epic’s ECABridge, on port 3000, with the server name Epic-Coding-Assistant. Conductor Terminal requires 5.8+, but the code path is aware of both.

Auto-configuration

The plugin’s connection panel lists every supported target and can write, check, or remove your entry for each one. See the full list in Supported Agent Targets — 25+ agents are recognised, most in both project and user scope.

What it does:

• Merges rather than overwrites. Your other MCP servers and hand-written settings survive.
• Backs up first. The existing file is copied to .bak, rotating to .bak.1, .bak.2 if needed.
• Writes the right shape per agent. Some want url, some httpUrl, some serverUrl, some need a type field or an enabled flag; Codex needs TOML and Hermes needs YAML. The writer knows the difference.
• Can check without touching anything. A non-mutating probe reports whether your entry is already present.
• Can remove itself cleanly. The remove path strips the entry back out and deletes the file if it was the only thing in it.

By hand

Most agents use the same JSON shape. Project scope means a file in your Unreal project directory; user scope means one in your home directory.

Claude Code — .mcp.json (project) or ~/.claude.json (user)

{
  "mcpServers": {
    "unreal-mcp": {
      "type": "http",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

Codex — .codex/config.toml

[mcp_servers.unreal-mcp]
url = "http://127.0.0.1:8000/mcp"

Gemini CLI / Qwen — .gemini/settings.json

{
  "mcpServers": {
    "unreal-mcp": {
      "httpUrl": "http://127.0.0.1:8000/mcp"
    }
  }
}

GitHub Copilot — .vscode/mcp.json

{
  "servers": {
    "unreal-mcp": {
      "type": "http",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

OpenCode — opencode.json

{
  "mcp": {
    "unreal-mcp": {
      "type": "remote",
      "url": "http://127.0.0.1:8000/mcp",
      "enabled": true
    }
  }
}

Supported Agent Targets has the config path and root key for every recognised agent.

Checking it worked

Start the agent in a terminal pane and ask it what tools it has. You are looking for Epic’s editor toolsets and a toolset called Cndctr Terminal.

If nothing Unreal-related appears:

1. Is the editor running? The MCP server is in-process — no editor, no server.
2. Is Auto Start Server on? Without it the server waits to be started by hand.
3. Did you restart the agent after writing the config? Most read MCP config only at startup.
4. Does the port match? Check Project Settings → Plugins → Model Context Protocol.

More in Troubleshooting.