Unity MCP 설치 절차 on Mac

 

CoplayDev/unity-mcp 설치 가이드

사전 요구사항

• Unity 2021.3 LTS 이상 (Unity 6.4 사용 중이니 OK)
• Python 3.10+ 및 uv 패키지 매니저
• Claude Code CLI

1단계: Python uv 설치 (없다면)

터미널에서:

curl -LsSf https://astral.sh/uv/install.sh | sh

2단계: Unity 패키지 설치

Unity에서 PixelDefense 프로젝트를 연 뒤, Window → Package Manager → + → Add package from git URL에 아래를 붙여넣으세요:

https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main

3단계: Unity에서 MCP 서버 시작

1. Unity 메뉴에서 Window → MCP for Unity 열기
2. Start Server 클릭 (localhost:8080에서 서버 시작)
3. MCP Client 드롭다운에서 Claude Code 선택
4. Configure 클릭

4단계: Claude Code CLI에 MCP 수동 설정 (자동 설정 안 될 경우)

PixelDefense 프로젝트 폴더에서 터미널을 열고:

claude mcp add unityMCP --transport http http://localhost:8080/mcp

또는 stdio 방식을 쓰고 싶다면:

claude mcp add unityMCP -- uvx --from mcpforunityserver mcp-for-unity --transport stdio

5단계: 연결 확인

1. Unity의 MCP for Unity 창에서 🟢 "Connected ✓" 상태 확인
2. Claude Code에서 /mcp 명령어로 unityMCP가 목록에 있는지 확인

주의사항 (Mac)

macOS에서 Finder나 Unity Hub로 실행한 앱은 터미널의 PATH를 상속받지 못할 수 있어요. 이 경우 Unity MCP 창의 "Choose Claude Install Location" 기능으로 Claude CLI의 절대 경로를 직접 지정해 주세요. (which claude로 경로 확인 가능)

이제 프로젝트 폴더에서 claude code를 실행하고 다음과 같이 입력해 보세요.

"Hierarchy에 MainScene이라는 이름의 씬을 만들고, 그 안에 Player라는 이름의 Cube와 Ground라는 이름의 Plane을 배치해 줘. Plane의 스케일은 (10, 1, 10)으로 설정해."

END!!!