Hướng dẫn cài đặt Cocos Creator 2.x MCP: Cài qua packages và kết nối AI IDE

Nội dung hướng dẫn này bao gồm

Thực hiện theo năm bước sau để kết nối Cocos Creator 2.x MCP (VberAI Pro) với dự án Creator 2.x cục bộ để Cursor (hoặc AI IDE hỗ trợ MCP khác—cùng ý tưởng) có thể thao tác, xem trước và gỡ lỗi trình chỉnh sửa—không chỉ chỉnh sửa script trên đĩa.

Khi hoàn tất, bạn sẽ có thể:

• Giải nén plugin vào thư mục packages của dự án
• Khởi động lại Creator, sau đó kích hoạt bằng tài khoản VberAI hoặc email + mã kích hoạt
• Khởi động Cocos MCP Server cục bộ
• Sử dụng Quick configure → Auto configure để đăng ký máy chủ trong Cursor và xác nhận kết nối

Trang sản phẩm: VberAI Cocos MCP 2.x

Bài viết này sử dụng Cursor làm ví dụ. Claude Code, Windsurf, Cline và các MCP client khác có quy trình tương tự.

Điều kiện tiên quyết

Mục	Ghi chú
Cocos Creator	2.4.x+ / các dự án 2.x khác (không trộn với gói 3.x)
Gói plugin	Bản lưu trữ Cocos Creator 2.x MCP Pro từ trang web chính thức
Kích hoạt	Tài khoản VberAI + mật khẩu, hoặc email + mã kích hoạt
AI IDE	Cursor được khuyến nghị; các MCP client khác cũng hoạt động
Mạng cục bộ	Cầu nối MCP thường chạy trên 127.0.0.1—không công khai cổng

Bước 1: Tải Cocos Creator 2.x MCP

Tải bản Pro từ trang web VberAI:

Trang tải xuống: https://www.vberai.com/game-engines/cocos2x?ch=CQZLC2FG

Quy trình đề xuất:

1. Mở trang và tải Cocos MCP 2.x Pro với quyền tài khoản của bạn
2. Lưu tệp lưu trữ cục bộ và chuẩn bị giải nén
3. Xác nhận dự án là Creator 2.x—không trộn với gói 3.x MCP

Sự khác biệt giữa OSS và Pro cũng như thanh toán tuân theo nội dung trang web hiện tại.

Bước 2: Cài đặt plugin (Vào packages)

Khác với 3.x (Extension Manager → Import Extension), 2.x cài đặt bằng cách đặt tệp vào dự án:

1. Giải nén tệp lưu trữ trên máy của bạn
2. Di chuyển thư mục plugin đã giải nén vào thư mục packages tại gốc dự án Cocos Creator
   • Nếu packages chưa tồn tại, hãy tạo nó trước
3. Xác nhận cấu trúc là packages/<plugin-name>/ và không lồng thêm một cấp giải nén nào

Không cấu hình ngay: khởi động lại Creator để tiện ích mở rộng tải đúng cách (bước tiếp theo).

Bước 3: Kích hoạt cocos-mcp-server

1. Khởi động lại hoàn toàn Cocos Creator và mở dự án chứa plugin
2. Menu: Extension → MCP Server
3. Trên màn hình kích hoạt, sử dụng một trong hai:
   • Tài khoản VberAI + mật khẩu
   • Email + mã kích hoạt
4. Sau khi kích hoạt thành công, mở trang cài đặt MCP Server (bước tiếp theo)

Nếu không kích hoạt, máy chủ thường sẽ không khởi động. Xác nhận gói hoặc mã của bạn khớp với bản Pro hiện tại.

Bước 4: Khởi động cocos-mcp-server

1. Sau khi kích hoạt, mở cài đặt MCP Server
2. Điều chỉnh khi cần:
   • Cổng: sử dụng mặc định của bảng điều khiển hoặc quy ước cục bộ của bạn
   • Ngôn ngữ: khớp với sở thích giao diện của bạn
   • Khởi động: sử dụng tùy chọn bảng điều khiển (ví dụ: tự động khởi động với trình chỉnh sửa, nếu có)
3. Nhấp Start service
4. Khi bảng điều khiển hiển thị Running, Cocos MCP Server đã sẵn sàng

Bây giờ bạn có một cầu nối MCP cục bộ. Tiếp theo, chuyển nó cho AI IDE của bạn.

Bước 5: Thiết lập AI IDE một cú nhấp chuột (Ví dụ Cursor)

1. Mở Tool manager
   • Xem xét các công cụ được Cocos MCP Server hiển thị
   • Chỉ bật những gì bạn muốn AI sử dụng
2. Mở Quick configure
   • Chọn IDE của bạn (ví dụ Cursor)
   • Nhấp Auto configure
   • Xác nhận giao diện hiển thị trạng thái configured
3. Mở Cursor
   • Trong danh sách MCP / công cụ, bạn sẽ thấy cocos-creator (hoặc tên hiển thị trong bảng điều khiển) được kết nối
   • Nếu thiếu, nhấp Reload (hoặc tương đương MCP reload) trong Cursor và kiểm tra lại

Các IDE khác cũng làm tương tự—chỉ cần chọn client khác trong Quick configure.

Xác minh nhanh sau khi kết nối

Trong Cursor, bắt đầu bằng kiểm tra chỉ đọc, ví dụ:

Liệt kê các nút gốc của scene hiện đang mở trong Cocos Creator.

Nếu phản hồi khớp với hệ thống phân cấp của trình chỉnh sửa, cầu nối hoạt động. Sau đó thử một thao tác ghi nhỏ (tạo một nút tạm thời và xóa nó) để xác nhận quyền và lựa chọn công cụ.

Câu hỏi thường gặp

Tệp đã nằm trong packages, nhưng không có menu Extension → MCP Server?
Xác nhận bạn đã khởi động lại hoàn toàn Creator (không chỉ tải lại scene). Kiểm tra thư mục nằm ở packages/<plugin-name>/ mà không có thêm lớp zip lồng nhau. Xác nhận bạn đã tải gói 2.x, không phải 3.x.

Kích hoạt liên tục thất bại?
Xác nhận quyền Pro, hoặc mã kích hoạt hợp lệ và được liên kết với email đúng. Kiểm tra trung tâm tài khoản trên trang web, sau đó thử lại trong bảng điều khiển.

Tôi nhấp Start service nhưng không thấy Running?
Xác nhận cổng trống và localhost không bị chặn. Đảm bảo Bước 3 hoàn tất thành công.

Cursor không hiển thị cocos-creator?
Trong Creator, xác nhận máy chủ vẫn Running, chạy Quick configure → Auto configure lại, sau đó tải lại MCP trong Cursor. Nếu vẫn thất bại, kiểm tra cấu hình MCP của Cursor bao gồm địa chỉ cầu nối cục bộ.

Bước tiếp theo

• Sử dụng ngôn ngữ tự nhiên để truy vấn scene hoặc chỉnh sửa nhỏ để tìm hiểu ranh giới công cụ
• Cam kết trước khi thay đổi lớn; giữ cầu nối chỉ trên localhost
• Để chuyển đổi từ thiết kế sang engine UI, kết hợp với VberAI Studio, sau đó lặp lại trong trình chỉnh sửa với MCP

Để làm rõ ranh giới khả năng và khác biệt với “Cocos Creator AI” mơ hồ, xem Cocos Creator MCP là gì. Đối với Creator 3.x, hãy làm theo hướng dẫn cài đặt Cocos Creator 3.x MCP—không trộn các gói. Để biết thêm ngữ cảnh MCP, xem hướng dẫn video Cocos Creator MCP.