MCP Config File Locations
Where every major AI tool keeps its MCP servers, what the file looks like and how it reads secrets. Bookmark it for the next time a README only shows the config for some other tool.
Files and top-level keys
| Tool | Project file | User file | Top-level key | Guide |
|---|---|---|---|---|
| Claude Code | .mcp.json | ~/.claude.json (local and user scope) | mcpServers | Day 15 |
| Cursor | .cursor/mcp.json | ~/.cursor/mcp.json | mcpServers | Cursor guide |
| VS Code | .vscode/mcp.json | MCP: Open User Configuration | servers | Day 15 |
| Codex CLI | none | ~/.codex/config.toml (TOML) | [mcp_servers.<name>] | Codex guide |
| Gemini CLI | .gemini/settings.json (trusted folders only) | ~/.gemini/settings.json | mcpServers | Gemini guide |
| Claude Desktop | none | claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/) | mcpServers | Day 15 |
| JetBrains AI Assistant | Server level: project | Server level: global (set in Settings, Tools, AI Assistant, MCP) | mcpServers (pasted JSON) | JetBrains guide |
| Zed | none | Zed settings.json | context_servers | Zed guide |
Secrets: environment variable syntax
Never paste a token into a file you commit. Each tool has its own way to read one from the environment:
| Tool | Syntax | Example |
|---|---|---|
Claude Code .mcp.json | ${VAR}, ${VAR:-default} | "Authorization": "Bearer ${GITHUB_PAT}" |
| Cursor | ${env:VAR}, plus ${workspaceFolder}, ${userHome} | "Bearer ${env:GITHUB_PAT}" |
| VS Code | ${input:id} with an inputs entry (prompted once, stored securely) | "Bearer ${input:github_pat}" |
| Gemini CLI | $VAR, ${VAR}, ${VAR:-default} | -H 'Authorization: Bearer $GITHUB_PAT' |
| Codex CLI | bearer_token_env_var for remote servers, env table for local ones | bearer_token_env_var = "GITHUB_PAT" |
| Claude Desktop, JetBrains, Zed | No documented interpolation: values are literal | Keep the file private, prefer OAuth |
An unset variable is often passed through as literal text, so a server receives $GITHUB_PAT as the token and answers 401. Export the variable, then restart the tool.
Add a server, then check it
| Tool | Add a local server | Add a remote server | Check |
|---|---|---|---|
| Claude Code | claude mcp add <name> -- npx -y <pkg> | claude mcp add --transport http <name> <url> | claude mcp list, /mcp |
| Codex CLI | codex mcp add <name> -- npx -y <pkg> | codex mcp add <name> --url <url> | codex mcp list |
| Gemini CLI | gemini mcp add -s user <name> npx -y <pkg> | gemini mcp add -s user -t http <name> <url> | gemini mcp list, /mcp |
| Cursor | Edit mcp.json | Edit mcp.json | Customize panel, Output: MCP Logs |
| VS Code | MCP: Add Server | MCP: Add Server, then HTTP | MCP: List Servers |
| Zed | Settings, AI, MCP Servers, Add Server | Same, Add Remote Server | Green dot: "Server is active" |
Scopes: Claude Code --scope local|project|user (default local), Gemini CLI -s user|project (default project). OAuth sign-in: /mcp or claude mcp login <name> in Claude Code, codex mcp login <name> in Codex.
Entry shapes side by side
JSON (Claude Code, Cursor, Claude Desktop, Gemini CLI, JetBrains)
{
"mcpServers": {
"playwright": { "command": "npx", "args": ["-y", "@playwright/mcp@0.0.84"] },
"sentry": { "url": "https://mcp.sentry.dev/mcp" }
}
}Claude Code's .mcp.json and Gemini CLI add "type": "http" to remote entries.
VS Code
{
"servers": {
"playwright": { "type": "stdio", "command": "npx", "args": ["-y", "@playwright/mcp@0.0.84"] },
"sentry": { "type": "http", "url": "https://mcp.sentry.dev/mcp" }
}
}Zed
{
"context_servers": {
"playwright": { "command": "npx", "args": ["-y", "@playwright/mcp@0.0.84"], "env": {} },
"sentry": { "url": "https://mcp.sentry.dev/mcp" }
}
}Codex CLI (~/.codex/config.toml)
[mcp_servers.playwright]
command = "npx"
args = ["-y", "@playwright/mcp@0.0.84"]
[mcp_servers.sentry]
url = "https://mcp.sentry.dev/mcp"Don't want to convert by hand? The MCP config generator writes these for you.