unity-mcp 워크플로우

기본 패턴

README 기준 기본 흐름
1. Unity 패키지 설치
2. Window > MCP for Unity 열기
3. Start Server
4. MCP 클라이언트 연결
5. 씬, 에셋, 스크립트 작업을 도구 호출로 실행

설명

• unity-mcp는 Unity를 단순 셸 제어 대상이 아니라, 에이전트가 호출할 수 있는 구조화된 도구 집합으로 여는 접근입니다.
• 이런 방식은 "씬에서 카메라 찾기", "특정 오브젝트 검색", "스크립트 생성", "테스트 실행"처럼 Unity 작업을 의미 단위의 툴 호출로 나누고 싶을 때 유리합니다.
• README 기준으로 MCP 서버는 기본적으로 localhost:8080에서 동작하며, 클라이언트 설정이 되면 Unity와 에이전트 사이의 도구 브리지 역할을 합니다.
• 멀티 프로젝트 환경에서는 인스턴스 리소스를 먼저 읽고 활성 인스턴스를 고른 뒤 작업하는 흐름이 중요합니다. 그렇지 않으면 다른 에디터 인스턴스를 잘못 조작할 수 있습니다.
• 따라서 이 방식은 준비가 조금 더 들더라도, 장기적으로 Unity 작업을 에이전트 워크플로우로 구조화하고 싶을 때 적합합니다.

짧은 예제

잘 맞는 작업
- 씬 구조와 게임오브젝트를 질의형으로 탐색
- 스크립트 생성/수정과 검증을 도구 단계로 분리
- 테스트 실행과 콘솔 읽기를 워크플로우에 편입
- 여러 Unity 인스턴스를 명시적으로 전환하며 작업

빠른 정리

주의할 점