Type to search the docs and updates.

Browse documentation

MCP reference

Per-tool details for the fields on the MCP servers page.

Target-only fields

TargetExtra fields
Codexenv_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
Crushenabled_tools, disabled_tools, sessionless, channel_enabled, channel_reply
Geminitrust, includeTools, excludeTools
Qodertrust, includeTools, excludeTools, alwaysAllow
KiroautoApprove, disabledTools, oauth, oauthScopes
Factoryx-factory.enabledTools, disabledTools, connectTimeout
Windsurf / Devin DesktopdisabledTools, oauthScopes (remote servers)
Claude CodealwaysLoad, bareElicitationCapability, headersHelper
CursorenvFile, auth
Copilot / VS CodeenvFile, dev, sandboxEnabled and sandbox (VS Code file only), tools (Copilot CLI files only)
ContinueconnectionTimeout, requestOptions
OpenHandsauth: 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.

TargetBehavior
Antigravity, Crush, Factory, Kiro, Qoder, WindsurfNative disabled
CodexMapped to enabled = false
Kilo Code, OpenCode, ZedMapped to "enabled": false
CopilotA 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 CodeMapped to project disabledMcpjsonServers in .claude/settings.json for servers written to .mcp.json. Import restores it
Cursor, Augment, Junie, Trae, WarpThe 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
EllipsisServer 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.

Targetenv and headersurl 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 }}
Ampheaders: ${NAME}. env: key left outurl: ${NAME}. args: server left out
Factory, Kiro, Ellipsis${NAME}Server left out
Codexenv: 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 outServer left out
Antigravity, Augment, Copilot, Junie, Kilo Code, Qoder, Trae, Warp, ZedKey left outServer left out