MCP 설정 생성기 FAQ
자주 묻는 7개 질문 · 2026 기준 클라이언트 형식 · 일반 참고 정보입니다.
자주 묻는 질문 (7)
MCP(Model Context Protocol)란 무엇인가요?
MCP는 Claude Desktop·Cursor·VS Code·Windsurf 같은 AI 앱이 파일시스템·데이터베이스·GitHub 등 외부 도구와 데이터에 연결하도록 하는 개방형 표준입니다. 각 클라이언트는 실행하거나 접속할 "MCP 서버" 목록을 담은 JSON 설정 파일을 읽어 도구를 사용합니다.
설정을 붙여넣었는데 왜 서버가 안 붙나요?
가장 흔한 원인은 claude_desktop_config.json 같은 파일의 JSON 문법 오류입니다. 줄 끝에 붙은 쉼표, 빠진 따옴표, 짝이 안 맞는 중괄호 하나면 서버 전체가 무시됩니다. 이 도구는 폼 입력을 유효한 JSON으로 대신 조립·검증하므로 구조는 항상 정확합니다. 남은 것은 파일 위치와 앱 재시작 확인뿐입니다.
클라이언트마다 설정 파일이 어디에 있나요?
Claude Desktop은 macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json 입니다. Cursor는 .cursor/mcp.json(프로젝트) 또는 ~/.cursor/mcp.json(전역), VS Code는 .vscode/mcp.json, Windsurf는 ~/.codeium/windsurf/mcp_config.json 을 사용합니다.
Claude Desktop과 VS Code의 형식은 어떻게 다른가요?
Claude Desktop·Cursor·Windsurf는 최상위 키가 mcpServers이고 stdio 서버에 type 필드가 없습니다. 반면 VS Code는 최상위 키가 servers이며 각 서버에 "type": "stdio" | "http" | "sse"를 반드시 명시해야 합니다. 이 도구의 클라이언트 탭을 바꾸면 같은 서버가 각 형식으로 자동 변환됩니다.
stdio 서버와 원격(SSE/HTTP) 서버는 무엇이 다른가요?
stdio 서버는 내 컴퓨터에서 로컬 프로세스를 실행합니다(command + args, 예: npx -y ...). 원격 서버는 URL로 SSE 또는 스트리밍 HTTP로 접속합니다. Cursor·VS Code는 url 키를, Windsurf는 serverUrl 키를 쓰며, Claude Desktop은 원격을 직접 지원하지 않아 npx mcp-remote 프록시로 감쌉니다.
입력한 API 키나 토큰이 외부로 전송되나요?
아니요. 모든 JSON 생성은 브라우저 안에서만 이뤄집니다. 입력값(env 시크릿 포함)은 이 브라우저의 localStorage와, 공유 링크를 복사할 때만 ?s= URL 토큰에 저장되며 어떤 서버로도 업로드되지 않습니다. 공유 링크에는 토큰이 그대로 담기므로 시크릿이 있으면 링크 공유에 주의하세요.
기존 설정 파일에 어떻게 병합하나요?
이미 다른 서버가 들어 있는 파일이라면 전체를 덮어쓰지 말고, 최상위 키(mcpServers 또는 servers) 객체 안에 새 서버 항목만 추가하세요. 예를 들어 mcpServers 안에 "filesystem": { ... } 항목을 한 줄 더 넣는 식입니다. 항목 사이 쉼표만 정확히 맞추면 됩니다.