MCP 설정 파일 위치와 형식: Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline
각 AI 클라이언트가 MCP 설정을 어디에 저장하는지, 어떤 JSON 키(mcpServers 또는 servers)를 쓰는지, 원격 URL은 어떻게 적는지 한눈에 비교합니다.
빠른 참조
| 클라이언트 | 파일 | 최상위 키 | 원격 서버 필드 |
|---|---|---|---|
| Claude Desktop | claude_desktop_config.json (설정 → 개발자 → 구성 편집) | mcpServers | 원격 서버는 앱에서 커넥터로 추가 |
| Cursor | ~/.cursor/mcp.json / .cursor/mcp.json | mcpServers | url |
| VS Code | .vscode/mcp.json (.mcp.json도 가능) | servers (.vscode/mcp.json의 경우) | "type": "http" + url |
| Windsurf (Cascade) | mcp_config.json (Cascade → … → Open MCP config file) | mcpServers | serverUrl / url |
공통 mcpServers 형식
Claude Desktop, Cursor, Windsurf는 로컬 서버에 대해 같은 항목을 받습니다.
{
"mcpServers": {
"fetch": {
"command": "uvx",
"args": [
"mcp-server-fetch"
]
}
}
}VS Code (.vscode/mcp.json)
servers를 쓰고 항목마다 type을 지정합니다.
{
"servers": {
"fetch": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-server-fetch"
]
},
"socketlist": {
"type": "http",
"url": "https://socketlist.pages.dev/mcp"
}
}
}자세한 가이드
Claude Desktop · Cursor · VS Code · Windsurf · Claude Code · Codex · 설정 생성기