{ "_description_ko": "Claude Desktop MCP 서버 등록 예시 — Unity MCP stdio(uvx) 방식. Claude Desktop은 HTTP url 방식을 공식 지원하지 않으므로 stdio가 유일한 선택.", "_중요_경고": [ "Claude Desktop은 {\"url\": \"...\"} HTTP 방식 MCP를 거부한다 (\"유효한 MCP 서버 구성이 아닙니다\" 경고).", "stdio(uvx) 방식만 사용 가능.", "Unity 쪽 Transport도 stdio로 설정해야 한다 (MCP for Unity 창 → Transport 드롭다운)." ], "_설치_경로": { "Windows": "%APPDATA%\\Claude\\claude_desktop_config.json", "macOS": "~/Library/Application Support/Claude/claude_desktop_config.json", "Linux": "~/.config/Claude/claude_desktop_config.json" }, "_권장_방법": [ "1. Unity Editor 실행 + EerieVillage 프로젝트 열기", "2. MCP for Unity Package 설치 (Package Manager, git URL: https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main)", "3. Unity 상단 메뉴 'Window → MCP for Unity' 창 열기", "4. Transport 드롭다운을 stdio로 변경", "5. 'Start Server' 클릭", "6. Client 드롭다운을 Claude Desktop 선택", "7. 'Configure' 버튼 클릭 — Unity가 claude_desktop_config.json을 자동으로 정확하게 덮어씀", "8. Claude Desktop 완전 재시작 (트레이 Quit → 재실행)" ], "_수동_설정_참고": "위 자동 Configure 가 어려우면 아래 unityMCP 블록을 수동으로 mcpServers에 추가. uvx.exe 경로는 'Get-Command uvx | Select-Object Source' 로 확인 후 교체.", "mcpServers": { "unityMCP": { "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Microsoft\\WinGet\\Packages\\astral-sh.uv_Microsoft.Winget.Source_8wekyb3d8bbwe\\uvx.exe", "args": [ "--from", "mcpforunityserver", "mcp-for-unity", "--transport", "stdio" ] } }, "_함께_권장": { "_설명": "BT 조직 Claude Desktop 기본 설정에 함께 고려할 수 있는 항목. 필수 아님.", "mcp-installer": { "command": "npx", "args": ["@anaisbetts/mcp-installer"] } }, "_사전_워밍업_필수": [ "Claude Desktop에서 자동 시동 전, 아래 명령을 수동 실행하여 uv cache에 패키지 사전 설치.", "미수행 시 pywin32 설치 중 Windows Defender 실시간 검사·이전 프로세스 락으로 'Server disconnected' 반복 발생.", "", "PowerShell:", " & 'C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Microsoft\\WinGet\\Packages\\astral-sh.uv_Microsoft.Winget.Source_8wekyb3d8bbwe\\uvx.exe' --from mcpforunityserver mcp-for-unity --help", "", "3~5분 소요. --help 출력이 뜨면 성공." ] }