Skip to content

Supported Agent Targets

Conductor Terminal can write, verify and remove the editor’s MCP client entry in each of the 26 targets below, covering 15 agents. Most are available in two scopes:

  • Project — the config file lives in your Unreal project directory and applies to that project only.
  • User — the config file lives in your home directory and applies everywhere. These targets carry a -user suffix.

Paths in the Config file column are relative to the project root or your home directory according to the Scope column. Each target has a Write to Project Config / Write to User Config button in Editor Preferences → Plugins → Conductor Terminal → Unreal MCP Client Config, except where noted.

Target Scope Config file Root key
claude Project .mcp.json mcpServers
claude-user User .claude.json mcpServers
cursor Project .cursor/mcp.json mcpServers
cursor-user User .cursor/mcp.json mcpServers
copilot Project .vscode/mcp.json servers — recognised by the writer but has no button in the panel; write it by hand
copilot-user User .copilot/mcp-config.json mcpServers
gemini Project .gemini/settings.json mcpServers
gemini-user User .gemini/settings.json mcpServers
qwen Project .qwen/settings.json mcpServers
qwen-user User .qwen/settings.json mcpServers
opencode Project opencode.json mcp
opencode-user User .config/opencode/opencode.json mcp
crush Project .crush.json mcp
crush-user User .config/crush/crush.json mcp
factory Project .factory/mcp.json mcpServers
factory-user User .factory/mcp.json mcpServers
openclaw Project config/mcporter.json mcpServers
openclaw-user User .mcporter/mcporter.json mcpServers
roo Project .roo/mcp.json mcpServers
auggie-user User .augment/settings.json mcpServers
kimi User .kimi/mcp.json mcpServers
antigravity User .gemini/config/mcp_config.json mcpServers
nanobot User .nanobot/config.json tools.mcpServers
Target Scope Config file Root key
codex Project .codex/config.toml mcp_servers
codex-user User .codex/config.toml mcp_servers
Target Scope Config file Root key
hermes User config.yaml inside the Hermes home mcp_servers

The Hermes home is resolved from HERMES_HOME, falling back to %LOCALAPPDATA%\hermes on Windows and ~/.hermes elsewhere.

Agents disagree about how an HTTP MCP server should be described. The writer emits the right shape per target:

Shape Targets
{ "type": "http", "url": ... } Claude, Cursor, Copilot, Roo, Auggie, OpenClaw, Crush, and the default for anything unlisted
{ "httpUrl": ... } Gemini, Qwen
{ "serverUrl": ... } Antigravity
{ "url": ... } Nanobot
{ "url": ..., "transport": "http" } Kimi
{ "type": "remote", "url": ..., "enabled": true } OpenCode
{ "type": "http", "url": ..., "disabled": false } Factory
[mcp_servers.unreal-mcp] + url = "..." Codex (TOML)
unreal-mcp: + url: "..." + enabled: true Hermes (YAML)
  • Merge, never clobber. Other MCP servers and unrelated settings in the file are preserved. JSON files are re-serialised (pretty-printed, UTF-8, no BOM), so their formatting may change; TOML and YAML are edited line by line.
  • Backup before write. The existing file is copied to <file>.bak, rotating to .bak.1, .bak.2 and so on, with no limit. For TOML and YAML a failed backup aborts the write; for JSON it is logged and the write proceeds. Removal does not take a backup.
  • Case-insensitive matching for JSON and TOML: an entry you wrote as Unreal-MCP is recognised and updated rather than duplicated. YAML matching is case-sensitive.
  • Comments and neighbours survive in TOML and YAML — those formats are edited block by block, not reserialised. A YAML mcp_servers written as an inline {} mapping is refused with an error asking you to edit by hand.
  • Clean removal. Removing the entry leaves the rest of the file intact, and deletes the file only if the entry was all it contained.

Each write reports one of: created, added, updated, unchanged, removed, not_found, file_not_found, deleted_empty_file, or error. The result is written to the Output Log, not shown as a toast; the green check on the agent’s row is the visible confirmation.