MCP reference
Per-tool details for the fields on the MCP servers page.
Target-only fields
| Target | Extra fields |
|---|---|
| Codex | env_vars, env_http_headers, http_headers_helper, auth, required, startup_timeout_sec, startup_timeout_ms, tool_timeout_sec, default_tools_approval_mode, scopes, oauth_resource, environment_id, enabled_tools, disabled_tools |
| Crush | enabled_tools, disabled_tools, sessionless, channel_enabled, channel_reply |
| Gemini | trust, includeTools, excludeTools |
| Qoder | trust, includeTools, excludeTools, alwaysAllow |
| Kiro | autoApprove, disabledTools, oauth, oauthScopes |
| Factory | x-factory.enabledTools, disabledTools, connectTimeout |
| Windsurf / Devin Desktop | disabledTools, oauthScopes (remote servers) |
| Claude Code | alwaysLoad, bareElicitationCapability, headersHelper |
| Cursor | envFile, auth |
| Copilot / VS Code | envFile, dev, sandboxEnabled and sandbox (VS Code file only), tools (Copilot CLI files only) |
| Continue | connectionTimeout, requestOptions |
| OpenHands | auth: oauth, or a truthy oauth, which sets auth: "oauth" on a remote server in an agent's mcp_servers |
Codex environment ID and target overrides
Codex environment_id is the ID of a configured executor and defaults to local. The older experimental_environment still loads: sync writes local as environment_id = "local" and leaves remote out, since Codex no longer reads that key. lint and project sync say so. agnostic-ai migrate --only mcps rewrites local.
The Crush and Claude Code fields also work under x-crush or x-claude, which wins, and other tools leave them out. On Amp, set x-amp.includeTools. x-factory, x-kilo, and x-continue override the matching top-level options for that target. Each target page gives the details: Factory tool lists, Crush channels, and Claude Code flags.
disabled support by target
This table covers project files. For user files written by sync --global, see global MCP servers.
| Target | Behavior |
|---|---|
| Antigravity, Crush, Factory, Kiro, Qoder, Windsurf | Native disabled |
| Codex | Mapped to enabled = false |
| Kilo Code, OpenCode, Zed | Mapped to "enabled": false |
| Copilot | A disabledMcpServers entry in .github/copilot/settings.json for Copilot CLI. The key is removed from both MCP files with a note. Disable the server in VS Code yourself |
| Claude Code | Mapped to project disabledMcpjsonServers in .claude/settings.json for servers written to .mcp.json. Import restores it |
| Cursor, Augment, Junie, Trae, Warp | The key is removed with a note, and the server stays in the file. Disable the server in the tool itself; Warp starts a project server only when you start it |
| Ellipsis | Server left out, since a listed server is always available. Written into the environment file, not an MCP file |
Environment references by target
How sync writes a ${NAME} reference for each tool. Where the cell says "left out", the note names the server, key, and variable. See environment references.
| Target | env and headers | url and args |
|---|---|---|
| Claude Code, Crush, OpenHands, Gemini | ${NAME}, ${NAME:-default} | ${NAME}, ${NAME:-default} |
| Cursor, Windsurf | ${env:NAME} | ${env:NAME} |
| OpenCode | {env:NAME} | {env:NAME} |
| Continue | ${{ secrets.NAME }}, in env on stdio servers and under requestOptions.headers | ${{ secrets.NAME }} |
| Amp | headers: ${NAME}. env: key left out | url: ${NAME}. args: server left out |
| Factory, Kiro, Ellipsis | ${NAME} | Server left out |
| Codex | env: KEY: ${KEY} adds KEY to env_vars. headers: Authorization: Bearer ${NAME} sets bearer_token_env_var, and another header of exactly ${NAME} joins env_http_headers. Any other reference: key left out | Server left out |
| Antigravity, Augment, Copilot, Junie, Kilo Code, Qoder, Trae, Warp, Zed | Key left out | Server left out |