Unity AI 오픈 베타: MCP 시작하기

May 11, 2026|5 분

Unity AI 오픈 베타용 아트웍. 검은색과 보라색의 그라데이션 배경 위에 겹쳐진 금속성 보라색의 줄무늬 모양 물체.

이 웹페이지는 이해를 돕기 위해 기계 번역으로 제공됩니다. 기계 번역으로 제공되는 콘텐츠에 대한 정확도나 신뢰도는 보장되지 않습니다. 번역된 콘텐츠의 정확도에 관해 의문이 있는 경우 웹페이지의 공식 영어 원문을 참고해 주시기 바랍니다.

여기를 클릭하세요.

오늘의 Unity AI 오픈 베타 관련 글에서는 Unity의 MCP(Model Context Protocol) 서버를 사용하여 Claude Code, GitHub Copilot 및 기타 AI 에이전트를 Unity 에디터에 직접 연결하는 방법을 알아보세요.

Unity AI의 MCP 서버는 IDE 내에서 AI 에이전트와 협업할 수 있는 새로운 방법을 제공합니다. 코드 편집기와 Unity 사이를 오갈 필요 없이, Claude Code, Cursor, Windsurf, VS Code Copilot과 같은 에이전트를 실행 중인 Unity 프로젝트에 직접 연결할 수 있습니다. 그러면 IDE가 씬 검사, 콘솔 출력 확인, 스크립트 편집, 에디터 액션 실행 등 프로젝트의 전체 컨텍스트를 파악할 수 있으므로, 사용자가 직접 컨텍스트를 복사하여 붙여넣을 필요가 없습니다.

이 글에서는 MCP가 무엇인지, 에이전트를 연결하는 방법, 사용할 수 있는 도구들, 그리고 이를 활용해 버그 수정이나 씬 관리와 같은 일반적인 개발 작업을 어떻게 효율적으로 수행할 수 있는지 단계별로 안내합니다.

모델 컨텍스트 프로토콜이란 무엇인가요?

모델 컨텍스트 프로토콜(MCP)은 AI 에이전트가 외부 도구 및 데이터 원본 / 데이터 출처 / 데이터 소스 / 자료 출처와 체계적인 방식으로 통신할 수 있도록 하는 개방형 표준입니다. Unity의 MCP 서버는 이 프로토콜을 구현하여, MCP와 호환되는 모든 AI 에이전트가 Unity 에디터에 연결하여 마치 호출 가능한 도구 세트인 것처럼 상호 작용할 수 있도록 합니다.

MCP가 없다면, IDE 내의 AI 에이전트는 사용자가 보여주는 것, 즉 열어 놓은 파일, 붙여넣은 코드, 또는 복사해 온 오류 메시지만 볼 수 있습니다. MCP를 사용하면 표준화된 프로토콜을 통해 Unity 프로젝트의 런타임 상태(씬 계층 구조, GameObject, 컴포넌트 값, 빌드 설정, 콘솔 메시지 등)에 실시간으로 접근할 수 있습니다.

AI Assistant 패키지에는 Unity의 공식 MCP 서버가 포함되어 있으며, 이를 사용하려면 Unity 구독이 필요합니다(단, Unity AI 크레딧은 소모되지 않습니다).

프로젝트 설정이 표시된 Unity MCP 서버 메뉴. — Unity MCP 서버의 프로젝트 설정

선행 조건

MCP를 시작하려면 사용자의 환경이 다음 요구 사항을 충족해야 합니다:

AI Assistant 패키지가 설치된 Unity 6 (6000.0) 이상
Claude Code, Cursor, Windsurf, Claude Desktop 등과 같은 MCP 호환 AI 클라이언트
Unity Cloud에 연결된 Unity 프로젝트
Unity AI의 유효한 평가판 또는 구독

AI 에이전트를 Unity에 통합하는 방법

Unity MCP 설정은 단 몇 분이면 충분합니다. 전체 과정은 다음과 같습니다:

1. Unity MCP 브리지가 실행 중인지 확인하십시오.

Unity 에디터에서 ‘편집(Edit)’ > ‘프로젝트 설정(Project Settings)’ > ‘Unity AI’ > ‘Unity MCP’로 이동합니다. Unity Bridge에 ‘실행 중’(녹색 표시등)으로 표시되는지 확인하십시오. 에디터가 로드되면 브릿지가 자동으로 실행됩니다. ‘중지됨’으로 표시되면 ‘시작’을 선택하세요.

Unity 에디터에서 Unity의 MCP 서버가 열려 있습니다. 사용자가 Unity Bridge가 실행 중인지 확인합니다. — Unity 브릿지가 정상적으로 작동 중입니다

2. AI 클라이언트 설정하기

Unity MCP 설정 페이지의 ‘통합(Integrations)’ 섹션에서는 지원되는 클라이언트를 자동으로 구성할 수 있습니다. ‘통합’을 펼친 다음, 사용하려는 클라이언트를 선택하고 ‘구성’을 클릭하세요. 사용 중인 Unity MCP 버전에 따라 Claude Code, Cursor, Windsurf 및 Claude Desktop 등이 지원되는 클라이언트에 포함될 수 있습니다.

3. 필요한 경우 Relay 경로를 수동으로 추가하십시오

클라이언트가 자동 구성 목록에 없는 경우, Unity Relay 바이너리를 가리키는 서버 항목을 추가하십시오. Unity가 시작되면 Relay가 ~/.unity/relay/에 설치됩니다. Relay 실행 파일에 --mcp를 명령줄 인수로 전달합니다.

4. Unity에서 연결 승인하기

에이전트가 처음 연결되면 Unity에 ‘연결 대기 중’ 메시지가 표시됩니다. ‘편집’ > ‘프로젝트 설정’ > ‘AI’ > ‘Unity MCP’로 이동하여 클라이언트 세부 정보를 확인한 후 ‘수락’을 선택하세요. 이전에 승인된 고객은 자동으로 다시 연결됩니다.

5. 연결 상태 확인

이제 담당자가 사용 가능한 Unity MCP 도구를 안내해 드릴 것입니다. “Unity 콘솔 메시지를 읽고 경고나 오류가 있는지 요약해 보세요”와 같은 간단한 명령어를 실행하여 연결이 정상적으로 작동하는지 확인해 보세요.

Unity 에디터에서 Unity MCP 서버가 열려 있습니다. MCP 서버는 Unity와 개발자가 선택한 LLM 간의 연결을 확인합니다. — MCP 서버가 Unity와 개발자가 선택한 LLM 간의 연결을 확인 중입니다

플랫폼별 Relay 경로

Relay 바이너리 경로는 운영 체제에 따라 다릅니다. 에이전트를 수동으로 구성할 때는 사용 중인 플랫폼에 맞는 경로를 사용하십시오:

macOS (Apple Silicon): ~/.unity/Relay/Relay_mac_arm64.app/Contents/MacOS/Relay_mac_arm64
macOS (Intel): ~/.unity/Relay/Relay_mac_x64.app/Contents/MacOS/Relay_mac_x64
Windows: %USERPROFILE%\.unity\Relay\Relay_win.exe
Linux: ~/.unity/relay/relay_linux

사용 가능한 도구

연결이 완료되면 AI 에이전트는 Unity MCP의 내장 도구 세트를 사용할 수 있게 됩니다. 이 도구들은 에이전트가 사용자로부터 명령을 받았을 때 호출하는 것들입니다. 에이전트는 Unity와 직접 상호작용하지 않고, 프로토콜을 통해 통신합니다.

주요 도구 범주는 다음과 같습니다:

씬 관리: 계층 구조 읽기, GameObject 생성/수정/삭제, 씬 관리
스크립트 편집: 프로젝트에서 C# 스크립트 생성, 열기 및 수정
콘솔 액세스: Unity 콘솔에서 로그, 경고 및 오류 확인
GameObject 검사: 특정 GameObject의 컴포넌트 값 읽기 및 쓰기
빌드 설정: 플랫폼 및 빌드 구성 확인

또한 C#을 사용하여 사용자 지정 MCP 도구를 등록함으로써 연결된 에이전트에게 자체 편집기 워크플로를 제공할 수 있습니다. 이는 프로젝트별 작업을 자동화하려는 팀에게 유용합니다.

Unity 에디터에서 사용할 수 있는 Unity MCP 서버 연동 기능 목록으로, Cursor, Claude Code, Windsurf, Claude Desktop, VSCode GitHub Copilot, Kiro, Codex 및 Gemini가 포함됩니다. — Unity AI는 Unity MCP에서 사용할 수 있는 연동 기능을 나열합니다.

AI 에이전트를 통해 Unity 제어하기

MCP 연결이 활성화된 상태에서는 AI 에이전트에 자연어 명령을 내릴 수 있으며, 에이전트는 Unity의 도구를 사용하여 해당 명령을 실행합니다. 몇 가지 예시:

“(0, 0, 0) 위치에 PlayerSpawn이라는 이름의 빈 GameObject를 새로 생성하세요”
“씬 계층 구조를 확인하고, 어떤 오브젝트에 구성 요소가 누락되었는지 알려주세요.”
“카메라가 플레이어를 따라가도록 하는 스크립트를 작성하고, 이를 메인 카메라에 연결하세요.”
“콘솔에서 오류가 있는지 확인하고, null 참조와 관련된 문제는 모두 수정하세요.”

에이전트는 MCP 도구를 사용하여 각 단계를 수행하며, 그 과정에서 추론 과정과 호출한 도구를 보여줍니다. 작업 내내 IDE 내에서 진행할 수 있으며, 결과를 확인하고자 할 때까지는 Unity로 전환할 필요가 없습니다.

MCP 서버를 통해 연결된 대규모 언어 모델(LLM)의 지시에 따라 씬을 변경하는 Unity AI 에이전트의 모습을 Unity 에디터에서 확인하세요. — MCP 서버를 통해 연결된 LLM의 지시에 따라 Unity의 씬을 수정하는 AI 에이전트

Unity MCP를 사용하여 콘솔 오류 해결하기

Unity MCP의 가장 실용적인 용도 중 하나는 에이전트가 콘솔 오류를 스스로 확인하고 수정할 수 있도록 하는 것입니다. 에이전트는 동일한 세션에서 콘솔을 확인하고 스크립트를 편집할 수 있으므로, 사용자가 별도로 내용을 복사할 필요 없이 오류 발생부터 해결까지 바로 진행할 수 있습니다:

1. 에이전트는 Unity_ReadConsole을 통해 콘솔을 읽습니다.

2. 관련 스크립트를 식별하고 그 내용을 읽습니다

3. 수정 사항을 적용하고 파일을 프로젝트에 다시 저장합니다

4. 콘솔을 다시 확인하여 오류가 해결되었는지 확인합니다

이를 통해 일반적으로 Unity AI 어시스턴트 간에 수동으로 복사-붙여넣기를 해야 했던 피드백 루프가 해소되며, 에이전트가 전 과정을 처리합니다.

콘솔 오류를 읽고 수정 조치를 적용하는 Unity AI 에이전트의 편집기 내 화면. — 콘솔 오류를 확인하고 해결책을 적용하는 AI 에이전트

Unity AI에 대해 더 알아보기

Unity AI 오픈 베타에서 제공되는 기능에 대해 더 자세히 알고 싶으시다면, 이 시리즈의 다른 글들도 읽어보시기 바랍니다:

지금 바로 Unity AI를 사용해 보세요

Unity AI 오픈 베타가 이제 모든 Unity 6 개발자에게 제공됩니다. 무료 체험판에 가입하고, Unity AI Assistant를 살펴보며, Unity AI Gateway를 통해 선호하는 도구를 연결한 다음, 프로젝트 인식 AI 에이전트가 내장된 환경에서 개발 워크플로가 어떻게 달라지는지 직접 체험해 보세요.

unity.com/features/ai에서 가입하고 요금제, 가격 및 데이터 개인정보 보호에 대해 자세히 알아보세요.

전체 문서는 에디터에서 링크된 Unity AI 문서나 docs.unity3d.com에서 확인할 수 있습니다.

Unity AI Assistant는 현재 오픈 베타 단계에 있습니다. 따라서 이 게시물에 설명된 기능, 동작 및 이용 가능 여부는 현재 활발히 개발 중이며, 사전 공지 없이 변경되거나 제한되거나 중단될 수 있습니다.