2026-04-21 14:41:33 +00:00
|
|
|
{
|
2026-04-21 16:06:38 +00:00
|
|
|
"_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 드롭다운)."
|
|
|
|
|
],
|
2026-04-21 14:41:33 +00:00
|
|
|
"_설치_경로": {
|
2026-04-21 16:06:38 +00:00
|
|
|
"Windows": "%APPDATA%\\Claude\\claude_desktop_config.json",
|
2026-04-21 14:41:33 +00:00
|
|
|
"macOS": "~/Library/Application Support/Claude/claude_desktop_config.json",
|
|
|
|
|
"Linux": "~/.config/Claude/claude_desktop_config.json"
|
|
|
|
|
},
|
2026-04-21 16:06:38 +00:00
|
|
|
"_권장_방법": [
|
|
|
|
|
"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 → 재실행)"
|
2026-04-21 14:41:33 +00:00
|
|
|
],
|
2026-04-21 16:06:38 +00:00
|
|
|
"_수동_설정_참고": "위 자동 Configure 가 어려우면 아래 unityMCP 블록을 수동으로 mcpServers에 추가. uvx.exe 경로는 'Get-Command uvx | Select-Object Source' 로 확인 후 교체.",
|
2026-04-21 14:41:33 +00:00
|
|
|
|
|
|
|
|
"mcpServers": {
|
|
|
|
|
"unityMCP": {
|
2026-04-21 16:06:38 +00:00
|
|
|
"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"]
|
2026-04-21 14:41:33 +00:00
|
|
|
}
|
2026-04-21 16:06:38 +00:00
|
|
|
},
|
|
|
|
|
|
|
|
|
|
"_사전_워밍업_필수": [
|
|
|
|
|
"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 출력이 뜨면 성공."
|
|
|
|
|
]
|
2026-04-21 14:41:33 +00:00
|
|
|
}
|
