Supported agents
Every coding agent add-mcp can install MCP servers to, with config paths and scopes.
MCP servers can be installed to any of these agents. Project paths are relative to your working directory; agents without a project path are global-only.
| Agent | --agent |
Project path | Global path |
|---|---|---|---|
| Antigravity | antigravity |
— | ~/.gemini/config/mcp_config.json (shared by Antigravity, Antigravity IDE, and Antigravity CLI) |
| Cline VSCode Extension | cline |
— | ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json |
| Cline CLI | cline-cli |
— | ~/.cline/data/settings/cline_mcp_settings.json |
| Claude Code | claude-code |
.mcp.json |
~/.claude.json |
| Claude Desktop | claude-desktop |
— | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Codex | codex |
.codex/config.toml |
~/.codex/config.toml |
| Cursor | cursor |
.cursor/mcp.json |
~/.cursor/mcp.json |
| fx | fx |
— | ~/.fx/mcp.json |
| Gemini CLI | gemini-cli |
.gemini/settings.json |
~/.gemini/settings.json |
| Goose | goose |
.goose/config.yaml |
~/.config/goose/config.yaml |
| GitHub Copilot CLI | github-copilot-cli |
.vscode/mcp.json |
~/.copilot/mcp-config.json |
| Grok Build | grok-build |
.grok/config.toml |
$GROK_HOME/config.toml (defaults to ~/.grok/config.toml) |
| Kilo Code | kilo-code |
kilo.json (or existing .kilo/, .kilocode/, or root kilo.jsonc config) |
~/.config/kilo/kilo.json (or existing ~/.config/kilo/kilo.jsonc) |
| Kimi Code | kimi-code |
.kimi-code/mcp.json |
$KIMI_CODE_HOME/mcp.json (defaults to ~/.kimi-code/mcp.json) |
| Kiro CLI | kiro-cli |
.kiro/settings/mcp.json |
~/.kiro/settings/mcp.json (shared with the Kiro IDE) |
| MCPorter | mcporter |
config/mcporter.json |
~/.mcporter/mcporter.json (or existing ~/.mcporter/mcporter.jsonc) |
| OpenCode | opencode |
opencode.jsonc (or existing opencode.json / .opencode/ config) |
~/.config/opencode/opencode.jsonc (or existing opencode.json) |
| VS Code | vscode |
.vscode/mcp.json |
~/Library/Application Support/Code/User/mcp.json |
| Windsurf | windsurf |
— | ~/.codeium/windsurf/mcp_config.json |
| Zed | zed |
.zed/settings.json |
~/Library/Application Support/Zed/settings.json |
Aliases
| Alias | Resolves to |
|---|---|
codeium, cascade |
windsurf |
cline-vscode |
cline |
gemini |
gemini-cli |
github-copilot |
vscode |
grok |
grok-build |
kilo, kilocode |
kilo-code |
kimi |
kimi-code |
kiro |
kiro-cli |
Troubleshooting
Some agents and editors, like Claude Code, require a restart to load a new MCP server. Others, like Cursor, require you to navigate to the MCP settings page and toggle the new server as enabled.
Kimi Code only loads a project-level .kimi-code/mcp.json after you trust the folder in the CLI, so a project install may not take effect until then. Its MCP config is also validated as a whole: if another entry in the file is invalid, Kimi Code disables every MCP server, including a newly added one.
fx reads MCP servers only from ~/.fx/mcp.json. A project file cannot add a server. A running session applies the change with /mcp reload.