MCP 서버 설정 빌더 & 검증기 (mcp.json)
Windows cmd /c npx 자동 래핑이 포함된 검증된 claude_desktop_config.json 및 .cursor/mcp.json 파일을 생성합니다.
MCP 클라이언트 설정 워크벤치
스키마 유효함 (POSIX 표준)
호스트 설정 파일 경로
- Claude Desktop (macOS):
~/Library/Application Support/Claude/claude_desktop_config.json - Claude Desktop (Windows):
%APPDATA%\Claude\claude_desktop_config.json - Cursor & VS Code 워크스페이스:
.cursor/mcp.json및.vscode/mcp.json
자주 묻는 질문
macOS와 Windows에서 claude_desktop_config.json은 어디에 있나요?
macOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json을 여세요.
Windows에서는 %APPDATA%\Claude\claude_desktop_config.json 경로에 파일을 저장한 뒤 호스트 앱을 재시작하세요.
데스크톱 MCP 호스트에서 npx가 ENOENT 또는 shim 오류로 실패하는 이유는 무엇인가요?
macOS GUI 앱은 .zshrc의 NVM 경로를 상속하지 않으며(필요 시 /opt/homebrew/bin/npx 같은 절대 바이너리 경로 사용),
Windows에서는 CreateProcess 하에서 .cmd shim이 정상 해석되도록 cmd /c npx -y가 필요합니다.
환경 변수에 입력한 API 토큰이 서버로 전송되나요?
아니요. JSON 조립과 KEY=VALUE 검증은 전적으로 브라우저 탭 안에서만 실행되며 로컬 기기 밖으로 절대 나가지 않습니다.
도구 정의의 토큰 오버헤드는 언제든 토큰 비용 원장에서 산정할 수 있습니다.