Thiết lập Unity MCP

Hiểu cầu nối editor

CoplayDev/unity-mcp kết nối client MCP với server và package phía editor. Dịch vụ model là phụ thuộc riêng. Project ghi nhận công cụ làm việc với scene, script, asset và test, nhưng năng lực được liệt kê không phải bằng chứng nó hoạt động trong project của bạn.

Ghi process sở hữu từng phần kết nối. Điều này quan trọng khi client tới được server nhưng không thao tác được editor. Giữ credential tài khoản, giấy phép editor, tương thích package và model khả dụng là các kiểm tra setup riêng. Đổi model không sửa được mismatch instance editor.

Rà soát đường cài đặt và chính sách pin

Hướng dẫn cài project ghi nhận thêm package qua Unity Package Manager và dùng giao diện setup để cấu hình server cùng client. Rà soát điều kiện Unity, Python và uv nêu cho revision đã chọn trước khi cài.

Để tái lập, giữ revision package đã giải quyết, version editor, version server và hồ sơ phụ thuộc sau setup. URL branch di động là đường phát hiện, không phải danh tính thí nghiệm bất biến. Rà soát download cùng đổi package trước khi áp dụng vào game hiện có và giữ state hoạt động trước để thử kết nối còn hoàn tác được.

https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main

Ghép endpoint HTTP local với client

Hướng dẫn cài duy trì ghi nhận ví dụ HTTP local bên dưới. Nó giả định server đã chạy tại địa chỉ đó. Xác nhận transport và địa chỉ được cấu hình thực trong giao diện setup editor trước khi dùng. URL MCP không phải base URL API LLM.

Dùng format cấu hình client ghi nhận. Một số client dùng root key hoặc khai báo transport khác, nên ví dụ mcpServers chung không phải tệp dán được cho mọi agent. Giữ server local trừ khi setup từ xa riêng đã rà soát, và không thêm credential model vào kết nối editor không liên quan.

{
  "mcpServers": {
    "unityMCP": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

Chứng minh instance editor nào nhận việc

Mở project dự kiến và kiểm tra trạng thái kết nối qua giao diện package. Sau đó dùng thao tác đọc client phát hiện để lấy ngữ cảnh project và scene. So thông tin với project local trước khi duyệt sửa. Nhiều project mở khiến cổng này đặc biệt quan trọng.

Ghi resource và schema tool thực từ version đã cài. Đừng bịa tool call từ tên nhớ của release khác. Kết quả đầu hữu ích xác định scene dự kiến và object hiện có mà không đổi chúng. Nếu state trả về cũ hoặc mơ hồ, dừng và giải quyết routing thay vì mutation hiển thị để tìm target.

Dùng edit có thể hoàn tác làm miniflow đầu

Chọn scene bỏ được thuộc bạn, ghi state ban đầu và yêu cầu một thay đổi đơn giản có hệ quả hiển thị. Kiểm tra scene cùng diff tệp đã lưu, chờ editor sẵn sàng và chạy scene. Giữ hành vi quan sát cùng lỗi console.

Sau đó mở lại scene để xác nhận thay đổi tồn tại. Điều này phân biệt hiệu ứng editor trong memory với đổi project đã lưu. Giữ flow đủ nhỏ để chẩn đoán một ranh giới: routing, mutation, compile, execute hay persistence. Khôi phục scene bỏ được sau rà soát và dùng cấu hình hoạt động đã ghi cho tác vụ sau.

Khắc phục transport trước game

Khi client không kết nối, xác minh URL và server local có chạy. Khi server chạy nhưng editor vắng, kiểm tra kết nối package và log editor. Khi editor đúng đã kết nối nhưng thiếu tool, kiểm tra nhóm tool version đã cài cung cấp.

Chỉ khi ranh giới đó hoạt động mới chẩn đoán compile hoặc gameplay. Giữ đoạn log riêng cho startup client, routing server, editor ready và action scene lỗi. Nhờ vậy báo cáo giải thích được dừng ở đâu thay vì quy mọi lỗi cho model hoặc cài lại lặp khi không có bằng chứng.

Bảo vệ project khỏi tự động hóa rộng

Kết nối editor có thể sửa scene, script và asset. Giới hạn thí nghiệm đầu vào thư mục đã biết và yêu cầu rà soát thao tác xóa resource, đổi phụ thuộc hay chạm scene không liên quan. Giữ state có thể khôi phục trước thay đổi đầu.

Đừng công khai dịch vụ phát triển local chỉ để xử lý vấn đề cấu hình client. Coi nội dung asset bên thứ ba và output tool là input không tin cậy, giữ credential ngoài log chia sẻ. Kết nối thành công không phải quyền upload build hay đổi bản ghi cửa hàng. Xuất bản là workflow riêng với biên ủy quyền riêng.

Bàn giao hồ sơ kết nối có thể tái lập

Ghi editor, project, revision package và server, version client, transport, bề mặt tool quan sát cùng miniflow hoàn tất. Giữ scene diff chính xác và kết quả runtime. Nêu compile, hành vi PlayMode, test và target export đã kiểm tra hay còn chờ.

Cấu hình theo tài liệu project duy trì; xác minh với package và client đã cài. Với sản xuất game, tiếp tục hướng dẫn Unity và test vòng hoàn chỉnh. Giữ giới hạn đã biết trong handoff để developer khác phân biệt lỗi kết nối với lỗi project và tái tạo setup hoạt động.

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