[Unity] Unity에서 AI 활용하기, MCP for Unity

AI 성능이 향상되면서 코드 작성이나 리소스 제작에 Ai를 많이 활용하고 있는데요.

 

이번에는 명령에 따라 AI가 직접 Unity 에디터에 접근하여 수정하는 방법을 알아보겠습니다.

 

 

간단한 사전지식(몰라도 진행가능)

- mcp란

: GPT, Gemini, claude, cursor 등 AI모델(LLM)과 외부 도구(Unity)를 연결하는 인터페이스입니다.

Unity와 claude가 표준화된 방식으로 데이터를 주고받게 하는 장치라고 생각하면 될 것 같습니다.

 

1) Unity에서 MCP 패키지 받기

https://github.com/CoplayDev/unity-mcp

GitHub - CoplayDev/unity-mcp: Unity MCP acts as a bridge, allowing AI assistants (like Claude, Cursor) to interact directly with

해당 깃헙 링크에서 패키지를 받을 건데, 이 패키지를 사용하기 위해선

- 파이썬 3.10 버전 이상

- uv (https://docs.astral.sh/uv/getting-started/installation/)

설치를 해주셔야합니다.

 

모두 준비되었다면 Unity > Window > Packge Manager에서 왼쪽 상단에  [ + ] 모양 드롭다운 바에서 github url로 다운받기를 클릭합니다.

 

URL 입력란에 [ https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main ]를 입력하여 패키지를 다운받으면

Window 탭에 MCP for Unity 탭이 추가된 걸 확인하실 수 있습니다.

 

 

 

2) 세팅 점검

Window > MCP for Unity > Local setup window에서 파이썬과 uv가 버전을 확인하고 모두 초록불이면 넘어갑니다.

 

 

 

3. claude 설치 

만약 사용중인 ai가 없다면 Unity개발에서 많이 사용되는 claude나 cursor를 추천드립니다.

claude는 유료, cursor는 무료로 사용해볼 수 있습니다.

 

여러 AI를 사용가능하지만 예시에선 claude를 사용할 것이고, 설치에 참고하실만한 글을 남겨두었습니다.

https://codegear.tistory.com/146

 

* cursor의 경우 desktop 앱 설치 + 로그인 후 5번으로 넘어가 Client = cursor를 선택하시면 됩니다.

 

 

4. claude 열기

claude가 설치되어있다면 프로젝트 위치에서 cmd를 열고 claude를 입력하여 실행할 수 있습니다.

 

안된다면

npm install -g @anthropic-ai/claude-code

 

를 먼저 입력하고 다시 시도해봅니다.

 

claude에 처음 접속하면 테마를 설정하고 계정과 연결하고 과정을 거쳐서 이용이 가능하고 모든 설정을 마쳤다면 다음으로 넘어갑니다.

 

 

 

5. claude 연결하기

Window > MCP for Unity > Toggle MCP window를 누르면 MCP For Unity라는 창이 뜨는데 이 창에서 AI 클라이언트에서 연결이 이루어집니다.

 

처음 보이는 창 하단에 Configure All Detected Clients를 누르면 로딩을 하다가 LLM들을 찾아내고 Client를 claude로 설정하고  Register 버튼을 누릅니다.

옆에 빨간불이 초록불로 바뀌며 Configure이라고 뜨는데, 연결되었지만 빨간불로 뜨는 버그도 있다고 하니 일단 진행해봅니다.

 

 

 

6. 사용하기

이젠 Unity와 claude가 연결된 상태이고, 이제 오브젝트 생성, 코드 생성, 애니메이션 생성등을 직접 claude에서 명령하고 바로 에디터에서 실행되는 것을 확인할 수 있으실겁니다.

 

 

 

 

참고 영상

https://www.youtube.com/watch?v=5nEUSJKgfzM