Formats per client
- Claude Code:
claude mcp add --transport http <name> <url>, with--headerfor a static token and--scope userorproject. Project scope writes.mcp.jsonwith"type": "http". - Claude Desktop and claude.ai: remote servers are added in the app under Connectors, as a custom connector.
claude_desktop_config.jsonis for local (stdio) servers only. - Cursor:
~/.cursor/mcp.jsonor.cursor/mcp.jsonundermcpServerswith aurl, plus a one-clickcursor://install link. - VS Code (GitHub Copilot):
.vscode/mcp.jsonunderserverswith"type": "http"; secrets come from aninputsprompt. - OpenAI Codex:
~/.codex/config.toml, a[mcp_servers.<name>]table withurl, andbearer_token_env_varfor a static token. OAuth viacodex mcp login. - Gemini CLI:
~/.gemini/settings.jsonundermcpServerswithhttpUrlfor Streamable HTTP (urlmeans SSE). - Windsurf (Devin Desktop):
mcp_config.jsonundermcpServerswithurland"transport": "http". - Zed:
settings.jsonundercontext_serverswith aurl. - ChatGPT: add a custom MCP server in the app with the public HTTPS URL; there is no config file.
Formats checked against each client's documentation in November 2026. Hosting the server yourself? See MCP server hosting.