Unity MCP với Claude Code và Cursor: Vận hành Editor mà không cần viết tay từng thay đổi
Kết nối Claude Code, Cursor và Codex với Unity qua Model Context Protocol—cài cầu nối cục bộ, xem trước thay đổi và gỡ lỗi scene vượt xa chỉnh sửa tệp bằng AI.
- unity-mcp
- mcp-for-unity
- claude-unity-mcp
- unity-claude-code
- unity-ai
- claude-code
- cursor
- vberai
Giới hạn của “AI viết C# vào một thư mục”
Các công cụ lập trình dựa trên trò chuyện rất giỏi tạo script. AI chỉ chỉnh sửa tệp vẫn bỏ lỡ trạng thái editor trực tiếp—scene đang mở, GameObject được chọn, biến thể prefab, hành vi chế độ play và lỗi Console.
Nếu mô hình chỉ thấy tệp trên đĩa, nó đoán hệ thống phân cấp và không thể nhấn Play, đổi tên nút trong Hierarchy hoặc kiểm tra tham chiếu bị thiếu. Các nhóm cần trợ lý bên trong vòng lặp engine, không chỉ trong kho lưu trữ.
Model Context Protocol (MCP) là một cách tiêu chuẩn để các ứng dụng AI gọi công cụ. Một máy chủ Unity MCP phơi bày các hành động editor qua cầu nối cục bộ để các ứng dụng như Claude Code, Cursor và quy trình làm việc kiểu Codex có thể đọc và thay đổi dự án trong khi Unity đang chạy.
VberAI cung cấp plugin Unity MCP cho cầu nối đó. Hướng dẫn này là một lộ trình thiết lập và sử dụng thực tế—không phải là một bản liệt kê tính năng.
Unity MCP thay đổi gì trong công việc hàng ngày
| Không có MCP | Với Unity MCP |
|---|---|
| Dán script đã tạo, sau đó tự sửa lỗi biên dịch | Yêu cầu ứng dụng tạo script và gắn nó vào một GameObject có tên cụ thể |
| Tự động nhân bản các bảng UI | Nhắc: “Nhân bản Panel_Shop dưới Canvas và đổi tên các con” |
| Mô tả lỗi Console trong trò chuyện | Để ứng dụng đọc nhật ký gần đây / ngữ cảnh lựa chọn (nơi plugin phơi bày) |
| Đoán bố cục scene từ YAML | Truy vấn hệ thống phân cấp, sau đó chỉnh sửa với xác nhận |
Bạn vẫn xem xét các khác biệt và kết quả chế độ play. Bạn ngừng gõ từng cú nhấp editor mà một tác nhân có thể thực hiện an toàn.
Điều kiện tiên quyết
- Dự án Unity đang mở (khuyến nghị LTS cho công việc nhóm)
- Một ứng dụng hỗ trợ MCP: Claude Code, Cursor, Windsurf hoặc tương tự
- Truy cập mạng cục bộ tới
127.0.0.1(cầu nối thường nằm trên loopback) - Gói VberAI Unity MCP cho phiên bản Unity của bạn (tải xuống / tài liệu)
Tùy chọn nhưng hữu ích: một scene mẫu nhỏ (Canvas trống + hai nút) để các lời nhắc đầu tiên dễ xác minh.
Danh sách kiểm tra thiết lập
1. Cài đặt plugin Unity MCP
- Nhập gói vào dự án của bạn (hoặc cài đặt qua quy trình làm việc gói của nhóm bạn)
- Bật tiện ích mở rộng / mục menu (tên có thể thay đổi đôi chút theo bản dựng—hãy tìm MCP hoặc AI Bridge)
- Tải lại editor nếu Unity yêu cầu
2. Khởi động cầu nối MCP cục bộ
Mở bảng plugin và khởi động máy chủ. Xác nhận:
- Trạng thái hiển thị đang chạy
- Máy chủ là localhost (không phơi bày cổng công khai)
- Đường dẫn dự án khớp với dự án Unity bạn định chỉnh sửa
3. Đăng ký máy chủ trong ứng dụng AI của bạn
Trong Cursor hoặc Claude Code, thêm một mục máy chủ MCP trỏ tới cầu nối Unity cục bộ (stdio hoặc HTTP/SSE—theo tài liệu hiện tại của plugin).
Khởi động lại ứng dụng nếu các công cụ không xuất hiện. Bạn sẽ thấy các công cụ liên quan đến Unity được liệt kê (đọc scene, thao tác node, v.v.).
4. Chạy thử nghiệm chỉ đọc
Hỏi:
Liệt kê các GameObject gốc trong scene đang hoạt động.
Nếu câu trả lời khớp với Hierarchy, cầu nối hoạt động. Chỉ sau đó mới thử các hành động ghi.
5. Chạy một bài kiểm tra ghi nhỏ
Hỏi:
Tạo một GameObject trống tên
MCP_SmokeTestdưới gốc scene.
Tìm nó trong Hierarchy, sau đó xóa nó. Ưu tiên các bài kiểm tra có thể đảo ngược trước khi tái cấu trúc lớn.
Các mẫu lời nhắc hoạt động tốt
Cấu trúc trước
Hiển thị các con của
Canvas/HUDvà tóm tắt cái nào là LayoutGroup.
Ghi tập trung
Dưới
Canvas/Menu, đổi tênButtonthànhBtn_Startvà đặt văn bản nhãn TMP thànhStart.
Vòng lặp gỡ lỗi
Sau khi tôi nhấn Play, tóm tắt các lỗi Console liên quan đến
PlayerControllervà đề xuất sửa lỗi nhỏ nhất.
Kết hợp với UI được tạo
Nếu bạn đã nhập một màn hình từ AI Studio, hãy sử dụng MCP để gắn trình xử lý onClick hoặc căn chỉnh tên với quy ước C# của bạn—mà không cần xây dựng lại prefab bằng tay.
Thói quen an toàn
- Chỉ giữ cầu nối trên localhost
- Ưu tiên đọc → lập kế hoạch → ghi hơn một lời nhắc “xây dựng lại trò chơi” khổng lồ
- Cam kết trước khi chỉnh sửa lớn của tác nhân
- Không dán bí mật vào lời nhắc; MCP không thay thế kiểm soát truy cập
- Coi chế độ play và làm mới cơ sở dữ liệu tài sản là các điểm kiểm tra của con người
MCP giảm việc nhấp chuột engine thủ công. Nó không loại bỏ việc xem xét mã.
Điều này liên quan thế nào đến các trợ lý AI tích hợp của Unity
Các trợ lý Unity đi kèm và plugin Unity MCP của bên thứ ba giải quyết các công việc chồng chéo. Đánh giá chúng theo cùng cách:
- Công cụ có thể thấy trực tiếp Hierarchy / lựa chọn không?
- Nó có thể thực hiện các chỉnh sửa có thể đảo ngược mà bạn có thể kiểm tra không?
- Nó có hoạt động với ứng dụng AI mà nhóm bạn đã sử dụng (Claude Code, Cursor, …) không?
Unity MCP mạnh nhất khi nhóm của bạn đã sống trong các ứng dụng đó và muốn một giao thức duy nhất trên nhiều engine (nhiều studio cũng chạy Godot hoặc Cocos MCP với cùng thói quen).
Câu hỏi thường gặp
Tôi vẫn viết C# chứ?
Có. MCP tốt nhất cho các thao tác editor và khung. Hệ thống gameplay, mạng và hiệu suất vẫn cần kỹ sư.
Claude Code vs Cursor?
Cả hai đều hoạt động nếu chúng hỗ trợ MCP và bạn trỏ chúng tới cùng một máy chủ Unity cục bộ. Chọn ứng dụng mà repo của bạn đã sử dụng; cầu nối là phần dùng chung.
Điều này chỉ dành cho UI?
Không. Hierarchy, thành phần và thao tác scene áp dụng cho cả đối tượng gameplay. UI chỉ là bản demo đầu tiên dễ dàng.
Video hướng dẫn ở đâu?
Xem Unity Game Engine MCP Plugin (video guide) trên kênh VberAI để xem quá trình thiết lập được ghi lại.
Các bước tiếp theo
- Cài đặt Unity MCP trong một scene dùng thử
- Kết nối Claude Code hoặc Cursor và vượt qua bài kiểm tra chỉ đọc
- Tự động hóa một việc vặt bạn ghét (đổi tên hàng loạt, nhân bản bảng, gắn script)
Khi thiết kế đến prefab là nút thắt cổ chai thay vì thao tác editor, hãy kết hợp điều này với quy trình làm việc Figma → Unity AI Studio.
Đọc tiếp
Các bài hướng dẫn bạn có thể thích
VberAI là gì? MCP Plugins, AI Studio và AI Super Matting
Vị trí của Engine MCP (Unity / Godot / Cocos), AI Studio (UI từ thiết kế đến engine) và AI Super Matting trong quy trình sản xuất game.Các nhóm làm game thường…
- vberai
- mcp
- ai-studio
- ai-super-matting
AI Studio Lớp Âm Thanh: Nhạc Nền, Giọng Nói và Hiệu Ứng Âm Thanh Trên Cùng Một Khung Vẽ
Cách VberAI Studio xử lý âm thanh trò chơi: lớp âm thanh và công cụ nổi, nhạc/giọng nói/SFX, thư viện và quản lý tài sản, chỉnh sửa track; gắn âm thanh vào Spi…
- AI Studio
- VberAI
- game audio
- SFX
Hướng dẫn cài đặt Unity MCP: Thêm gói từ đĩa và kết nối AI IDE
Cài đặt VberAI Unity MCP Pro từng bước—Package Manager Add package from disk, kích hoạt tài khoản, khởi động MCP Server (cổng 6589), và xác minh kết nối trong …
- unity
- mcp
- cursor
- tutorial