Cocos Creator 2.x MCP 설치 가이드: 패키지로 설치하고 AI IDE에 연결하기

이 가이드가 다루는 내용

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

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

• 플러그인을 프로젝트 packages 폴더에 압축 해제
• Creator를 재시작한 후 VberAI 계정 또는 이메일 + 활성화 코드로 활성화
• 로컬 Cocos MCP Server 시작
• 빠른 구성 → 자동 구성을 사용하여 Cursor에 서버를 등록하고 연결 확인

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

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

사전 요구 사항

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

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

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

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

권장 흐름:

1. 페이지를 열고 계정 권한으로 Cocos MCP 2.x Pro를 다운로드하세요
2. 아카이브를 로컬에 저장하고 추출할 준비를 하세요
3. 프로젝트가 Creator 2.x인지 확인하세요—3.x MCP 패키지와 혼용하지 마세요

OSS와 Pro의 차이점 및 결제는 현재 사이트 사본을 따릅니다.

2단계: 플러그인 설치 (packages에)

3.x(확장 관리자 → 확장 가져오기)와 달리 2.x는 파일을 프로젝트에 배치하여 설치합니다:

1. 아카이브를 컴퓨터에 추출하세요
2. 추출된 플러그인 폴더를 Cocos Creator 프로젝트 루트의 packages 디렉토리로 이동하세요
   • packages가 아직 없으면 먼저 생성하세요
3. 레이아웃이 packages/<plugin-name>/이고 추가 압축 해제 수준이 중첩되지 않았는지 확인하세요

아직 구성하지 마세요: 확장이 올바르게 로드되도록 Creator를 재시작하세요(다음 단계).

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

1. Cocos Creator를 완전히 재시작하고 플러그인이 포함된 프로젝트를 여세요
2. 메뉴: 확장 → MCP Server
3. 활성화 화면에서 다음 중 하나를 사용하세요:
   • VberAI 계정 + 비밀번호
   • 이메일 + 활성화 코드
4. 활성화가 성공하면 MCP Server 설정 페이지를 여세요(다음 단계)

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

4단계: cocos-mcp-server 시작

1. 활성화 후 MCP Server 설정을 여세요
2. 필요에 따라 조정하세요:
   • 포트: 패널 기본값 또는 로컬 규칙 사용
   • 언어: 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

파일이 packages에 있는데 Extension → MCP Server 메뉴가 없나요?
Creator를 완전히 재시작했는지 확인하세요(씬만 다시 로드하지 마세요). 폴더가 추가 zip 중첩 없이 packages/<plugin-name>/에 있는지 확인하세요. 2.x 패키지를 다운로드했는지 확인하세요(3.x 아님).

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

서비스 시작을 클릭했는데 실행 중이 표시되지 않나요?
포트가 사용 가능하고 localhost가 차단되지 않았는지 확인하세요. 3단계가 성공적으로 완료되었는지 확인하세요.

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

다음 단계

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

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