MCP 설정 생성기 — Claude, Cursor, VS Code, Windsurf, Codex

MCP 서버를 한 번만 정의하면 Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Codex용 정확한 설정 파일이나 명령어를 얻을 수 있습니다.

인기 서버 추가

서버 이름

전송 방식

명령

실행 파일만 입력: npx, uvx, docker, node 또는 전체 경로.

환경 변수

한 줄에 KEY=value 하나. 셸의 변수를 참조하려면 ${VAR}로 쓰세요.

인수(한 줄에 하나)

각 줄이 배열 항목 하나가 됩니다. 공백이 있는 경로도 괜찮습니다.

서버 이름

전송 방식

서버 URL

OAuth 로그인을 쓰는 서버라면 헤더를 비워 두세요.

HTTP 헤더

한 줄에 Name: value 하나.

비밀 값을 파일에 넣지 마세요: 모든 환경 변수 값을 같은 이름의 셸 변수 참조로 바꿉니다(예: GITHUB_TOKEN=${GITHUB_TOKEN}).

claude_desktop_config.json

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/you/projects"
      ]
    },
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.githubcopilot.com/mcp/",
        "--header",
        "Authorization:${MCP_HEADER_1}"
      ],
      "env": {
        "MCP_HEADER_1": "Bearer ${GITHUB_PAT}"
      }
    }
  }
}

파일: macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json(설정 > 개발자 > 구성 편집에서 열 수 있습니다). 저장한 뒤 Claude를 완전히 종료했다가 다시 여세요.
원격 서버는 mcp-remote로 연결합니다(Node.js 필요). 유료 요금제에서는 대신 설정 > 커넥터에 URL을 추가할 수 있으며, 이 경우 OAuth를 자동으로 처리합니다.
Claude Desktop은 이 파일의 ${VAR}를 확장하지 않습니다. 플레이스홀더를 실제 값으로 바꾸세요.

모든 처리는 브라우저 안에서 이루어집니다. 설정에는 API 토큰이 들어 있는 경우가 많으므로, 입력하거나 붙여 넣은 내용은 업로드되거나 저장되지 않습니다. 모든 무료 도구 보기.

문제를 발견하셨거나 개선할 점이 있나요? 모든 메시지를 읽고 빠르게 고칩니다.

이 MCP 설정 생성기는 하나의 양식으로 모든 주요 AI 클라이언트용 Model Context Protocol 서버 설정을 작성합니다. 클라이언트마다 원하는 파일이 조금씩 다릅니다. Claude Desktop과 Cursor는 "mcpServers" 객체를, VS Code는 "type"이 필수인 "servers"를 쓰고, Windsurf는 원격 URL을 "serverUrl"이라고 부르며, Claude Code는 원격 항목에 "type"이 필요하고, Codex는 TOML 테이블을 씁니다. 명령어나 URL을 한 번만 입력하고 사용하는 도구에 맞는 버전을 복사하세요.

검사기는 반대 방향으로 작동합니다. 불러와지지 않는 설정을 붙여 넣으면 JSON 오류, 누락된 필드, 클라이언트가 읽지 않는 키를 짚어 주고, 서버를 양식으로 불러와 변환할 수 있게 해 줍니다. 구조만 검사하며 서버 패키지가 존재하는지나 토큰이 유효한지는 확인하지 않습니다. 그래도 서버가 실패하면 클라이언트의 MCP 로그를 확인하세요.

사용 방법

Filesystem이나 GitHub 같은 프리셋을 클릭하거나 빈 서버를 추가하세요.
로컬 서버는 command(npx, uvx, docker)를 설정하고 인수를 한 줄에 하나씩 넣으세요. 원격 서버는 URL과 필요한 헤더를 설정하세요.
원한다면 비밀 정보를 파일에 넣지 않고 값을 ${VAR} 참조로 바꾸는 옵션을 체크하세요.
클라이언트를 고른 뒤 출력을 복사하거나 다운로드해 그 아래 표시된 경로에 저장하세요.
설정을 다시 읽도록 클라이언트를 재시작하세요(Claude Desktop은 완전히 종료). 기존 파일을 고치려면 검사 및 변환에 붙여 넣으세요.

자주 묻는 질문

claude_desktop_config.json은 어디에 있나요?

macOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows에서는 %APPDATA%\Claude\claude_desktop_config.json입니다. 가장 쉽게 여는 방법은 Claude Desktop의 Settings > Developer > Edit Config입니다. 파일은 시작할 때만 읽으므로 저장한 뒤 Claude를 완전히 종료했다가 다시 여세요.

Claude Code의 .mcp.json과 claude mcp add의 차이는 무엇인가요?

claude mcp add는 터미널에서 서버를 등록합니다. 기본 local 범위에서는 나와 현재 프로젝트 전용으로 ~/.claude.json에 저장되고, --scope user는 모든 프로젝트에서 쓸 수 있게 하며, --scope project는 프로젝트 루트의 .mcp.json에 기록해 버전 관리로 팀과 공유합니다. .mcp.json의 각 항목에는 "type"(stdio, http, sse)이 있어야 합니다. url은 있지만 type이 없는 항목은 stdio로 읽혀 실패합니다.

VS Code가 mcpServers 설정을 무시하는 이유는 무엇인가요?

VS Code는 최상위 키가 "mcpServers"가 아닌 "servers"인 .vscode/mcp.json을 읽으며, 각 서버에 "type": "stdio", "http", "sse"가 필요합니다. 그래서 Claude나 Cursor README에서 복사한 파일로는 아무것도 불러와지지 않습니다. 검사기에 붙여 넣고 VS Code 형식으로 변환하세요.

MCP 설정에 API 키를 넣지 않으려면 어떻게 하나요?

값을 붙여 넣는 대신 환경 변수를 참조하세요. Claude Code는 ${VAR}와 ${VAR:-default}를 확장하고, Cursor와 Windsurf는 ${env:VAR}를 쓰며, VS Code는 ${env:VAR}와 비밀 정보를 안전하게 저장하는 ${input:id} 프롬프트를 지원하고, Codex는 env_vars, env_http_headers, bearer_token_env_var로 변수를 전달합니다. Claude Desktop은 설정에서 변수를 확장하지 않으므로 값을 그대로 넣어야 합니다.

Claude Desktop에 원격 MCP 서버를 추가하려면 어떻게 하나요?

Claude Desktop의 설정 파일은 로컬 명령어만 실행합니다. 유료 요금제에서는 Settings > Connectors에서 원격 서버 URL을 추가할 수 있으며, OAuth 로그인도 처리됩니다. 그 외에는 mcp-remote로 연결하세요. 명령어는 npx이고 인수는 -y, mcp-remote, 서버 URL이며, 인증에는 --header 옵션을 더합니다. Claude Desktop을 고르면 생성기가 이 연결 설정을 대신 작성합니다.

stdio, HTTP, SSE 전송 방식의 차이는 무엇인가요?

stdio 서버는 클라이언트가 시작하고 표준 입출력으로 통신하는 로컬 프로세스로 실행되며, 파일을 읽거나 내 컴퓨터에서 실행되는 도구에 적합합니다. Streamable HTTP 서버는 URL로 원격에서 실행되며, 호스팅 서버의 현재 표준입니다. SSE는 이전 원격 전송 방식으로, Claude Code는 이를 지원 중단 예정으로 표시하고 Codex는 streamable HTTP만 지원하므로, 서버가 둘 다 제공하면 HTTP를 쓰세요.

MCP 설정 파일 위치와 형식

• Claude Desktop: ~/Library/Application Support/Claude(macOS) 또는 %APPDATA%\Claude(Windows)의 claude_desktop_config.json. 최상위 "mcpServers", 항목에는 command, args, env.

• Claude Code: 프로젝트 루트의 .mcp.json(project 범위) 또는 ~/.claude.json(local·user 범위, claude mcp add로 관리). 최상위 "mcpServers", 각 항목에 "type".

• Cursor: 프로젝트의 .cursor/mcp.json 또는 전역 ~/.cursor/mcp.json. "mcpServers", 원격 항목은 "url"과 "headers" 사용.

• VS Code: 워크스페이스의 .vscode/mcp.json 또는 "MCP: Open User Configuration"으로 여는 사용자 수준 파일. 최상위 "servers"와 선택적 "inputs".

• Windsurf: ~/.codeium/windsurf/mcp_config.json. Windsurf 문서는 이제 Devin Desktop 아래에 있으며, Devin Desktop은 ~/.config/devin/mcp_config.json(macOS/Linux) 또는 %APPDATA%\devin\mcp_config.json을 씁니다. 원격 항목은 "serverUrl" 사용.

• Codex: ~/.codex/config.toml 또는 신뢰할 수 있는 프로젝트의 .codex/config.toml. 서버마다 [mcp_servers.<name>] 테이블 하나, command/args/env 또는 url과 bearer_token_env_var, http_headers.

MCP 서버가 불러와지지 않는 흔한 원인

• 전체 명령어가 "command"에 들어 있음("npx -y @scope/server"). 클라이언트는 그 전체 이름을 가진 실행 파일을 찾습니다. command에는 npx를, 나머지는 args에 항목 하나씩 넣으세요.

• JSON에 끝 쉼표나 // 주석이 있음. 주석은 VS Code의 mcp.json만 허용하며, 다른 클라이언트는 엄격한 JSON이 필요합니다.

• npx나 uvx를 찾을 수 없음. macOS의 GUI 앱은 셸 PATH를 항상 물려받지는 않으므로 `which npx`로 확인한 전체 경로를 command로 쓰세요.

• 잘못된 최상위 키: Claude나 Cursor 파일에 "servers", VS Code에 "mcpServers".

• Claude Code의 .mcp.json에서 "type"이 없는 원격 항목. 로컬 명령어로 처리됩니다.

• 클라이언트를 재시작하지 않음. Claude Desktop은 시작할 때만 파일을 읽고, Cursor와 VS Code는 MCP 설정 패널에서 서버 상태를 보여 줍니다.

서버를 추가하기 전 보안 참고 사항

MCP 서버는 내 권한으로 실행됩니다. 파일 시스템 서버는 지정한 모든 폴더를 읽고 바꿀 수 있고, 데이터베이스 서버는 제공한 자격 증명으로 쿼리를 실행할 수 있습니다. 프로젝트 폴더 하나, 읽기 전용 데이터베이스 사용자, 필요한 저장소로만 제한한 세분화된 GitHub 토큰처럼 작동하는 가장 좁은 범위만 부여하세요.

서버는 공식 배포처에서 설치하고, 운영 환경에 닿는 것은 버전을 고정하며, 파일에 붙여 넣는 장기 토큰보다는 OAuth를 쓰는 원격 서버를 선택하세요. 도구 출력은 신뢰할 수 없는 입력으로 취급하세요. 서버가 가져온 웹 페이지나 이슈에 모델을 겨냥한 지시가 들어 있을 수 있습니다.