Hướng dẫn cài đặt Unity MCP: Thêm gói từ đĩa và kết nối AI IDE

Hướng dẫn này bao gồm những gì

Thực hiện theo năm bước sau để kết nối Unity MCP (VberAI Pro) với một dự án Unity cục bộ để Cursor (hoặc một AI IDE hỗ trợ MCP khác—các bước tương tự) có thể điều khiển, 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ể:

• Nhập Unity MCP qua Package Manager Add package from disk
• Kích hoạt bằng tài khoản VberAI hoặc email + mã kích hoạt
• Khởi động Unity MCP Server cục bộ (cổng mặc định 6589)
• Sử dụng Quick Setup → Auto configure để đăng ký máy chủ trong Cursor và xác nhận kết nối

Trang sản phẩm: VberAI Unity MCP

Hướng dẫn này sử dụng Cursor làm ví dụ. Claude Code, Windsurf, Cline và các máy khách MCP khác tuân theo nguyên tắc tương tự.

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

Mục	Ghi chú
Unity	2022.3+ / Unity 6 được khuyến nghị (theo ghi chú hỗ trợ hiện tại trên trang web)
Gói plugin	Gói Unity MCP Pro từ trang web chính thức, đã giải nén
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 máy khách MCP khác cũng hoạt động
Mạng cục bộ	Cầu MCP thường chạy trên 127.0.0.1—không công khai cổng

Bước 1: Tải Unity MCP

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

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

Quy trình đề xuất:

1. Mở trang và tải Unity MCP 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à giải nén vào một thư mục cố định (bước tiếp theo cần package.json bên trong)
3. Xác nhận package.json tồn tại trong thư mục đã giải nén trước khi mở Unity

Sự khác biệt giữa OSS và Pro cũng như giá cả tuân theo tài liệu chính thức hiện tại.

Bước 2: Nhập gói

1. Mở dự án Unity mục tiêu của bạn
2. Menu Window → Package Manager
3. Nhấp + ở góc trên bên trái của bảng Package Manager
4. Chọn Add package from disk
5. Chọn tệp package.json từ thư mục đã giải nén ở Bước 1

Sau khi nhập thành công, gói Unity MCP sẽ xuất hiện trong danh sách Package Manager.

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

1. Menu Window → Unity MCP → Mcp Panel
2. Trên màn hình kích hoạt, thực hiện một trong hai:
   • Đăng nhập bằng tài khoản VberAI + mật khẩu
   • Hoặc nhập email + mã kích hoạt
3. 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, dịch vụ 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 unity-mcp-server

1. Sau khi kích hoạt, mở trang cài đặt Unity MCP Server
2. Điều chỉnh khi cần:
   • Cổng: mặc định 6589
   • Ngôn ngữ: khớp với tùy chọn giao diện của bạn
   • Khởi động: làm theo tùy chọn bảng (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 hiển thị Running, Unity MCP Server đã hoạt động

Bây giờ bạn có một cầu 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 management
   • Xem lại các công cụ do Unity MCP Server cung cấp
   • Chỉ bật những gì bạn muốn mô hình sử dụng
2. Mở Quick setup
   • Chọn IDE của bạn (ví dụ Cursor)
   • Nhấp Auto configure
   • Xác nhận giao diện hiển thị Configured
3. Mở Cursor
   • MCP / công cụ sẽ liệt kê unity-mcp là đã kết nối
   • Nếu không, nhấp Reload (hoặc tương đương tải lại MCP) trong Cursor và kiểm tra lại

Các IDE khác sử dụng cùng quy trình Quick setup—chỉ cần chuyển máy khách.

Kiểm tra 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 đối tượng gốc trong Hierarchy của scene hiện đang mở trong Unity.

Nếu phản hồi khớp với trình chỉnh sửa, cầu nối hoạt động tốt. Sau đó thử một thao tác ghi nhỏ (tạo một GameObject trống 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

Add package from disk không tìm thấy package.json?
Xác nhận Bước 1 đã giải nén hoàn toàn tệp lưu trữ và bạn đã chọn package.json ở gốc của thư mục đó—không phải thư mục lồng nhau.

Kích hoạt vẫn thất bại?
Kiểm tra quyền Pro, thời hạn mã và liên kết email trong tài khoản chính thức của bạn, sau đó thử lại trong Mcp Panel.

Đã khởi động dịch vụ nhưng không Running?
Đảm bảo cổng 6589 (hoặc cổng tùy chỉnh của bạn) trống và localhost không bị chặn. Xác nhận Bước 3 kích hoạt thành công.

Cursor không hiển thị unity-mcp?
Xác nhận Unity vẫn hiển thị Running, chạy Quick setup → Auto configure lại, sau đó tải lại MCP trong Cursor. Nếu cần, xác minh cấu hình MCP của Cursor trỏ đến cầu cục bộ.

Các bước tiếp theo

• Thử truy vấn scene bằng ngôn ngữ tự nhiên hoặc chỉnh sửa nhỏ để hiểu ranh giới công cụ
• Cam kết trước khi thay đổi lớn; chỉ giữ cầu trên localhost
• Đối với giao diện thiết kế đến engine, kết hợp với VberAI Studio để bàn giao Figma / PSD, sau đó lặp lại với MCP

Thêm ngữ cảnh Unity + MCP: Hướng dẫn video Unity MCP, Unity MCP với Claude Code và Cursor.