Kết nối với máy chủ MCP của Roblox Studio

Máy chủ MCP của Roblox Studio được tích hợp sẵn trong Roblox Studio. Nó thực hiện Giao thức Ngữ cảnh Mô hình (MCP), một tiêu chuẩn mở cho phép các công cụ AI giao tiếp an toàn với các ứng dụng bên ngoài. Khi đã kết nối, khách hàng AI của bạn có thể tương tác trực tiếp với phiên Studio đang mở của bạn, khám phá mô hình dữ liệu, viết kịch bản, chạy mã Luau và kiểm tra trò chơi của bạn trong chế độ chơi.

Hướng dẫn này cho bạn biết cách kết nối máy chủ MCP của Studio với các khách hàng AI phổ biến. Mặc dù cách thiết lập khác nhau tùy theo khách hàng, nhưng ý tưởng cốt lõi là giống nhau: bạn cấu hình khách hàng của mình để kết nối với máy chủ MCP và sau đó gửi lệnh từ khách hàng đến phiên Studio đang hoạt động của bạn.

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

Trước khi bạn có thể kết nối với máy chủ, hãy đảm bảo bạn đã cài đặt phiên bản mới nhất của Roblox Studio và khách hàng MCP ưa thích của bạn trên máy tính.

Cách máy chủ MCP của Studio hoạt động

Máy chủ chạy như một quy trình cục bộ trên máy của bạn và giao tiếp với khách hàng AI bằng cách sử dụng stdio transport, sử dụng các luồng đầu vào/đầu ra tiêu chuẩn. Tất cả các hành động đều được khởi xướng thông qua khách hàng AI của bạn, sau đó gửi yêu cầu qua kênh này để thực hiện các hành động bên trong phiên Studio của bạn.

Máy chủ cung cấp các công cụ sau:

Kích hoạt máy chủ MCP trong Studio

Để kích hoạt máy chủ MCP trong Studio:

1. Mở Trợ lý.
2. Nhấp vào … ⟩ Quản lý Máy chủ MCP.
3. Bật Kích hoạt Studio làm máy chủ MCP.

Khi đã được kích hoạt, bảng cài đặt hiển thị tùy chọn kết nối nhanh và hướng dẫn thiết lập cho các khách hàng khác nhau. Khi một khách hàng kết nối thành công, một chỉ báo màu xanh lá cây hiển thị số lượng khách hàng đã kết nối.

Kết nối khách hàng của bạn

Bạn có thể kết nối khách hàng của mình với máy chủ MCP của Studio bằng cách sử dụng kết nối nhanh, một cấu hình JSON hoặc một lệnh CLI.

• Sử dụng kết nối nhanh nếu khách hàng của bạn được hỗ trợ.
• Nếu không, hãy sử dụng cấu hình JSON nếu khách hàng của bạn hỗ trợ các tệp cấu hình MCP.
• Nếu không, hãy sử dụng một lệnh CLI.

Máy chủ MCP của Studio hoạt động với bất kỳ khách hàng nào hỗ trợ stdio transport. Sau khi thêm cấu hình, hãy làm theo tài liệu của khách hàng của bạn để hoàn tất thiết lập, sau đó khởi động lại khách hàng để áp dụng các thay đổi của bạn.

Kết nối nhanh

Kết nối nhanh hỗ trợ các khách hàng sau:

• Antigravity
• Codex CLI
• Claude Code
• Claude Desktop
• Cursor
• Gemini CLI
• Visual Studio Code

Để kết nối bằng cách sử dụng kết nối nhanh:

1. Đi đến Cài đặt Trợ lý ⟩ Máy chủ MCP.
2. Mở rộng danh sách thả xuống Kết nối nhanh để xem các khách hàng được cài đặt trên máy tính của bạn.
3. Bật khách hàng mà bạn đã chọn.

Nếu khách hàng bạn muốn không xuất hiện trong danh sách Kết nối nhanh, hãy cài đặt nó và khởi động lại Roblox Studio.

Cấu hình JSON

Hầu hết các khách hàng MCP hỗ trợ các tệp cấu hình JSON. Các ví dụ sau đây cho thấy các cấu hình hoàn chỉnh mà bạn có thể sử dụng.

Nếu Roblox Studio là máy chủ MCP duy nhất của bạn, hãy sử dụng các cấu hình này như là. Nếu bạn đang sử dụng nhiều máy chủ MCP, hãy sao chép mục Roblox_Studio và thêm nó vào từ điển mcpServers hiện có của bạn.

Cấu hình khác nhau tùy theo hệ điều hành:

{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "%LOCALAPPDATA%\\Roblox\\mcp.bat"
      ]
    }
  }
}

{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
    }
  }
}

Lệnh CLI

Một số khách hàng MCP yêu cầu một lệnh CLI thay vì một cấu hình JSON. Sử dụng lệnh phù hợp cho hệ điều hành của bạn:

cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat

/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP

Sử dụng nhiều thể hiện Studio

Bạn có thể kết nối một khách hàng MCP duy nhất với nhiều thể hiện Studio đang chạy cùng một lúc. Máy chủ tự động xác định thể hiện nào để sử dụng dựa trên ngữ cảnh (ví dụ, nếu bạn tham chiếu đến một trò chơi cụ thể hoặc một đối tượng chỉ tồn tại trong thể hiện đó).

Bạn có thể chuyển đổi thể hiện một cách thủ công bằng cách sử dụng list_roblox_studios và set_active_studio.

Xác minh kết nối của bạn

Sau khi thiết lập khách hàng của bạn, hãy xác minh rằng kết nối đang hoạt động trong Roblox Studio:

1. Mở Trợ lý.
2. Nhấp vào … ⟩ Quản lý Máy chủ MCP.
3. Dưới Kích hoạt Studio làm máy chủ MCP, kiểm tra chỉ báo màu xanh lá cây để xác nhận rằng khách hàng đã kết nối thành công.

Khắc phục sự cố

Nếu máy chủ không hiển thị, hoặc các công cụ không khả dụng:

• Khởi động lại cả Roblox Studio và khách hàng MCP của bạn.
• Xác minh rằng lệnh hoặc đường dẫn nhị phân là chính xác và tệp tồn tại.
• Kiểm tra cú pháp JSON của bạn. Ngay cả một dấu phẩy hoặc dấu ngoặc đơn bị thiếu cũng có thể ngăn cản cấu hình tải.