MCP 클라이언트 설정 레퍼런스
MCP 클라이언트마다 서버를 읽는 위치와 사용하는 키가 다르며, 설정 형식도 다를 수 있습니다. 이 표에서 각 클라이언트가 설정을 찾는 위치와 필요한 형식, 원격 서버의 OAuth를 지원하는지 확인하세요.
| 클라이언트 | 설정 파일 | 최상위 키 | 형식 | 원격 OAuth | CLI로 추가 |
|---|---|---|---|---|---|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json | mcpServers | json | 예 | 아니요 |
| Claude Code | .mcp.json | mcpServers | json | 예 | 예 |
| Cursor | .cursor/mcp.json | mcpServers | json | 예 | 아니요 |
| VS Code (GitHub Copilot) | .vscode/mcp.json (key 'servers') or portable .mcp.json (key 'mcpServers') | servers | json | 예 | 예 |
| Windsurf / Devin Desktop | .devin/mcp_config.json (Devin CLI / Devin Local project scope) | mcpServers | json | 예 | 예 |
| Zed | ~/.config/zed/settings.json | context_servers | json | 예 | 아니요 |
| OpenAI Codex CLI | .codex/config.toml (trusted projects only) | mcp_servers | toml | 예 | 예 |
| Gemini CLI | .gemini/settings.json | mcpServers | json | 예 | 예 |
| ChatGPT | 설정 화면에서만 가능 | — | — | 예 | 아니요 |
| OpenClaw | ~/.openclaw/openclaw.json | mcp.servers | json5 | 예 | 예 |
| Cline | ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json | mcpServers | json | 문서화되지 않음 | 예 |
| Continue | .continue/mcpServers/<name>.yaml (or drop a Claude/Cursor/Cline-style mcp.json into .continue/mcpServers/) | mcpServers | yaml | 문서화되지 않음 | 아니요 |
| JetBrains AI Assistant | 설정 화면에서만 가능 | mcpServers | json (pasted in UI) | 문서화되지 않음 | 아니요 |
설정을 망가뜨리는 차이점
VS Code는 servers를 사용합니다
.vscode/mcp.json은 항목을 mcpServers가 아닌 servers 아래에 지정하므로 Cursor 또는 Claude 설정을 그대로 붙여 넣으면 로드되지 않습니다. 최신 포터블 설정 파일인 .mcp.json과 ~/.copilot/mcp-config.json은 mcpServers를 사용합니다.
Gemini CLI에서는 url이 아니라 httpUrl을 사용합니다
Gemini CLI는 필드 이름으로 전송 방식을 결정합니다. httpUrl은 Streamable HTTP, url은 이전 SSE 전송 방식, command는 stdio를 뜻합니다. 최신 원격 서버에는 httpUrl을 사용하세요.
OpenClaw와 Cline은 기본적으로 SSE를 사용합니다
원격 항목에서 전송 방식을 지정하지 않으면 두 클라이언트 모두 이전 SSE로 대체됩니다. OpenClaw에서는 transport를 streamable-http로, Cline에서는 type을 streamableHttp로 설정하세요.
Claude Code에는 type이 필요합니다
.mcp.json에서 url은 있지만 type이 없는 원격 항목은 오류입니다. url 옆에 type http를 추가하세요. stdio 항목에는 type stdio를 사용합니다.
Codex는 TOML이며 서버마다 테이블 하나를 사용합니다
Codex에는 JSON 파일이 없습니다. 각 서버는 config.toml의 자체 [mcp_servers.<name>] 테이블에 정의합니다. args는 TOML 배열이며, env_vars를 사용하면 이름으로 셸의 secret을 전달할 수 있습니다.
Continue에는 YAML 목록이 필요합니다
Continue에서 mcpServers는 이름을 키로 사용하는 맵이 아니라, 각 항목에 name이 있는 목록입니다. 각 블록 파일의 맨 위에도 name, version, schema: v1이 있어야 합니다.