Referentie voor MCP-clientconfiguratie
Elke MCP-client haalt servers op uit een eigen locatie, onder een eigen sleutel en soms in een eigen indeling. Deze tabel laat zien waar elke client zoekt, welke structuur die verwacht en of OAuth voor externe servers wordt ondersteund.
| Client | Configuratiebestand | Hoofdsleutel | Indeling | OAuth op afstand | Toevoegen via CLI |
|---|---|---|---|---|---|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json | mcpServers | json | Ja | Nee |
| Claude Code | .mcp.json | mcpServers | json | Ja | Ja |
| Cursor | .cursor/mcp.json | mcpServers | json | Ja | Nee |
| VS Code (GitHub Copilot) | .vscode/mcp.json (key 'servers') or portable .mcp.json (key 'mcpServers') | servers | json | Ja | Ja |
| Windsurf / Devin Desktop | .devin/mcp_config.json (Devin CLI / Devin Local project scope) | mcpServers | json | Ja | Ja |
| Zed | ~/.config/zed/settings.json | context_servers | json | Ja | Nee |
| OpenAI Codex CLI | .codex/config.toml (trusted projects only) | mcp_servers | toml | Ja | Ja |
| Gemini CLI | .gemini/settings.json | mcpServers | json | Ja | Ja |
| ChatGPT | Alleen via het instellingenscherm | — | — | Ja | Nee |
| OpenClaw | ~/.openclaw/openclaw.json | mcp.servers | json5 | Ja | Ja |
| Cline | ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json | mcpServers | json | Niet gedocumenteerd | Ja |
| Continue | .continue/mcpServers/<name>.yaml (or drop a Claude/Cursor/Cline-style mcp.json into .continue/mcpServers/) | mcpServers | yaml | Niet gedocumenteerd | Nee |
| JetBrains AI Assistant | Alleen via het instellingenscherm | mcpServers | json (pasted in UI) | Niet gedocumenteerd | Nee |
Verschillen die configuraties laten mislukken
VS Code gebruikt servers
.vscode/mcp.json bevat vermeldingen onder servers, niet onder mcpServers. Een Cursor- of Claude-configuratie werkt dus niet als je die ongewijzigd plakt. De nieuwere, draagbare bestanden .mcp.json en ~/.copilot/mcp-config.json gebruiken wel mcpServers.
Gemini CLI: httpUrl, niet url
Gemini CLI bepaalt het transport op basis van de veldnaam. httpUrl staat voor Streamable HTTP, url voor het verouderde SSE-transport en command voor stdio. Voor een moderne externe server heb je httpUrl nodig.
OpenClaw en Cline gebruiken standaard SSE
Als je het transport weglaat bij een externe server, vallen beide terug op het verouderde SSE. Stel in OpenClaw transport in op streamable-http en in Cline type op streamableHttp.
Claude Code vereist een type
In .mcp.json is een remote entry met een url maar zonder type ongeldig. Voeg type http toe naast de url; stdio-entries gebruiken type stdio.
Codex gebruikt TOML, één tabel per server
Codex gebruikt geen JSON-bestand. Elke server heeft een eigen [mcp_servers.<name>]-tabel in config.toml. args is een TOML-array en env_vars geeft secrets op basis van hun naam door vanuit je shell.
Continue verwacht een YAML-lijst
In Continue is mcpServers een lijst met entries die elk een name bevatten, geen map met namen als sleutels. Elk blokbestand moet bovenaan ook name, version en schema: v1 bevatten.