Cocos Creator 3.x MCP 설치 가이드: 확장 프로그램 가져오기 및 AI IDE 연결

이 가이드에서 다루는 내용

다음의 5단계를 따라 Cocos Creator 3.x MCP (VberAI Pro)를 로컬 Creator 프로젝트에 연결하면 Cursor (또는 다른 MCP 지원 AI IDE—동일한 방식)가 디스크의 스크립트를 편집하는 것뿐만 아니라 에디터를 조작하고, 미리 보고, 디버깅할 수 있습니다.

완료하면 다음을 수행할 수 있어야 합니다:

• 확장 관리자를 통해 cocos-mcp-server 가져오기 및 활성화
• VberAI 계정 또는 이메일 + 활성화 코드로 활성화
• 로컬 Cocos MCP Server 시작 (기본 포트 3000)
• 빠른 구성 → 자동 구성을 사용하여 Cursor에 서버를 등록하고 연결 확인

제품 페이지: VberAI Cocos MCP 3.x

이 문서는 Cursor를 예시로 사용합니다. Claude Code, Windsurf, Cline 및 기타 MCP 클라이언트도 유사한 흐름을 따릅니다.

사전 요구 사항

항목	참고
Cocos Creator	3.0 이상 (모든 3.x 프로젝트)
플러그인 패키지	공식 사이트의 Cocos Creator 3.x MCP Pro 아카이브
활성화	VberAI 계정 + 비밀번호 또는 이메일 + 활성화 코드
AI IDE	Cursor 권장; 다른 MCP 클라이언트도 작동
로컬 네트워크	MCP 브리지는 일반적으로 127.0.0.1에서 실행—포트를 공개적으로 노출하지 마세요

1단계: Cocos Creator 3.x MCP 다운로드

VberAI 사이트에서 Pro 빌드를 다운로드하세요:

다운로드 페이지: https://www.vberai.com/game-engines/cocos?ch=CQZLC2FG

권장 흐름:

1. 페이지를 열고 계정 권한으로 Cocos MCP 3.x Pro를 다운로드하세요.
2. 아카이브를 로컬에 저장하세요—아직 프로젝트에 압축을 풀 필요는 없습니다 (다음 단계에서 아카이브를 가져옵니다).
3. 프로젝트가 Creator 3.0 이상인지 확인하세요; 2.x 패키지와 혼용하지 마세요.

OSS vs Pro 차이점 및 청구는 현재 사이트 사본을 따릅니다.

2단계: 확장 프로그램 가져오기

1. Cocos Creator 3.x 프로젝트를 엽니다.
2. 메뉴: 확장 → 확장 관리자 → 확장 가져오기
3. 방금 다운로드한 Cocos Creator 3.x MCP 아카이브를 선택합니다.
4. 가져오기가 성공하면 확장 목록에 cocos-mcp-server가 활성화됨으로 표시되어야 합니다.

비활성화된 것으로 표시되면 계속하기 전에 활성화하세요.

3단계: cocos-mcp-server 활성화

1. 메뉴: 확장 → Cocos MCP Server → Mcp 패널 열기
2. 활성화 화면에서 다음 중 하나를 사용하세요:
   • VberAI 계정 + 비밀번호
   • 이메일 + 활성화 코드
3. 활성화가 성공하면 MCP 서버 설정 페이지를 엽니다 (다음 단계).

활성화하지 않으면 서버가 일반적으로 시작되지 않습니다. 요금제 또는 코드가 현재 Pro 빌드와 일치하는지 확인하세요.

4단계: cocos-mcp-server 시작

1. 활성화 후 MCP 서버 설정을 엽니다.
2. 필요에 따라 조정하세요:
   • 포트: 기본값 3000
   • 언어: UI 기본 설정에 맞춤
   • 시작: 패널 옵션 사용 (예: 가능한 경우 에디터와 함께 자동 시작)
3. 서비스 시작을 클릭합니다.
4. 패널에 실행 중이 표시되면 Cocos MCP Server가 실행 중입니다.

이제 로컬 MCP 브리지가 준비되었습니다. 다음으로 AI IDE에 연결하세요.

5단계: 원클릭 AI IDE 설정 (Cursor 예시)

1. 도구 관리자를 엽니다.
   • Cocos MCP Server가 노출하는 도구를 검토합니다.
   • AI가 사용할 도구만 활성화합니다.
2. 빠른 구성을 엽니다.
   • IDE를 선택합니다 (예: Cursor)
   • 자동 구성을 클릭합니다.
   • UI에 구성됨 상태가 표시되는지 확인합니다.
3. Cursor를 엽니다.
   • MCP/도구 목록에 cocos-creator (또는 패널에 표시된 이름)가 연결된 것으로 표시되어야 합니다.
   • 없는 경우 Cursor에서 다시 로드 (또는 해당 MCP 다시 로드)를 클릭하고 다시 확인합니다.

다른 IDE도 동일한 경로를 따릅니다—빠른 구성에서 다른 클라이언트를 선택하기만 하면 됩니다.

연결 후 빠른 확인

Cursor에서 읽기 전용 확인으로 시작하세요, 예:

Cocos Creator에서 현재 열려 있는 씬의 루트 노드를 나열하세요.

응답이 에디터 계층 구조와 일치하면 브리지가 작동하는 것입니다. 그런 다음 작은 쓰기 작업 (임시 노드를 만들고 삭제)을 시도하여 권한과 도구 선택을 확인하세요.

FAQ

가져오기가 실패했거나 목록에 cocos-mcp-server가 없나요? 공식 3.x 아카이브를 사용하세요 (2.x 아님). Creator는 3.0 이상이어야 합니다. 비활성화된 상태로 유지되면 확장 관리자에서 활성화하고 Creator를 다시 시작하세요.

활성화가 계속 실패하나요? Pro 권한을 확인하거나 활성화 코드가 유효하고 올바른 이메일에 연결되어 있는지 확인하세요. 사이트의 계정 센터를 확인한 후 패널에서 다시 시도하세요.

서비스 시작을 클릭했지만 실행 중이 표시되지 않나요? 포트 3000 (또는 사용자 지정 포트)이 비어 있는지, localhost가 차단되지 않았는지 확인하세요. 3단계가 성공적으로 완료되었는지 확인하세요.

Cursor에 cocos-creator가 표시되지 않나요? Creator에서 서버가 여전히 실행 중인지 확인하고, 빠른 구성 → 자동 구성을 다시 실행한 다음 Cursor에서 MCP를 다시 로드하세요. 여전히 실패하면 Cursor의 MCP 구성에 로컬 브리지 주소가 포함되어 있는지 확인하세요.

다음 단계

• 자연어로 씬을 쿼리하거나 작은 편집을 수행하여 도구 경계를 파악하세요.
• 큰 변경 전에 커밋하고 브리지를 localhost에서만 유지하세요.
• 디자인-엔진 UI의 경우 VberAI Studio와 함께 사용한 다음 MCP로 에디터에서 반복하세요.

Creator 2.x의 경우 Cocos Creator 2.x MCP 설치 가이드를 따르세요—패키지를 혼용하지 마세요. 능력 경계와 모호한 “Cocos Creator AI”와의 차이를 먼저 보려면 Cocos Creator MCP란을 참고하세요. 더 많은 MCP 컨텍스트는 Cocos Creator MCP 비디오 가이드를 참조하세요.