Để Claude hoặc ChatGPT làm game cho bạn: máy chủ MCP hosted để làm game
Ngôn ngữ khác: English · Español · Deutsch · Français · Português · Italiano · Nederlands · Svenska · Norsk · Bahasa Indonesia · Türkçe · Polski · Русский · 日本語 · 한국어 · 繁體中文
Để Claude hoặc ChatGPT làm game cho bạn, hãy kết nối nó với mcp.shinygen.ai, máy chủ MCP hosted của Shiny Gen. Không cần cài gì: không engine, không plugin cho trình chỉnh sửa, không máy chủ cục bộ. Khi đã kết nối, trợ lý của bạn đọc dự án Shiny Gen đang mở, viết GDScript, và tạo hình ảnh, mô hình 3D và âm thanh. Rồi nó làm phần thường vẫn là việc của bạn: chạy game, chụp màn hình, bấm các nút điều khiển, đọc lỗi khi chạy và sửa những gì nó làm hỏng.
MCP (Model Context Protocol) là một chuẩn mở để trao công cụ cho trợ lý AI. Shiny Gen cung cấp engine, các trình chỉnh sửa và các mô hình tạo nội dung dưới dạng công cụ MCP, nên trợ lý nào nói được MCP cũng dùng được chúng. Bài này hướng dẫn cài đặt từng bước, những gì công cụ cho phép trợ lý làm, chi phí, và các giới hạn.
Có hai cách kết nối. Bạn có thể mở kết nối cho trợ lý từ ứng dụng Shiny Gen đang mở (các bước bên dưới), và nó hoạt động khi ứng dụng đó còn mở. Hoặc bạn có thể đưa cho AI của bạn một liên kết phiên agent: nó mở Shiny Gen trong trình duyệt riêng và làm việc ở đó, phía bạn không cần mở gì. Cách thứ hai nằm ở phần dưới.
Bạn cần gì
- Một tài khoản Shiny Gen (miễn phí) và một game đang mở trong Shiny Gen, trên trình duyệt tại shinygen.ai/play hoặc trong ứng dụng.
- Một MCP client. Ứng dụng có các bước cho Claude (trên web, trong ứng dụng máy tính và trong Claude Code), ChatGPT, Grok, Cursor và opencode. Mọi MCP client khác đều dùng được với cùng địa chỉ, kể cả client do bạn tự viết.
Cài đặt
1. Mở bộ chọn mô hình
Trong Shiny Gen, mở game bạn muốn làm (hoặc bắt đầu game mới bằng nút +). Mở thẻ Agent ở cuối trình chỉnh sửa và chạm vào tên mô hình bên cạnh ô trò chuyện. Danh sách Chọn mô hình kết thúc bằng Kết nối mô hình bên ngoài qua MCP: hãy chọn nó.
2. Nhấn Mở kết nối agent ngoài
Màn hình Dùng AI của riêng bạn mở ra. Trong Kết nối AI của bạn với thẻ này, nhấn Mở kết nối agent ngoài. Ứng dụng sẽ hiện "Đang chờ AI của bạn kết nối".
Với cách này, bước đó là bắt buộc và phải làm trước: cho đến khi bạn nhấn, máy chủ sẽ từ chối trợ lý của bạn và bảo nó nhờ bạn nhấn đúng nút này. Bạn làm việc này một lần mỗi phiên, và kết nối vẫn mở khi Shiny Gen còn mở. (Nút Tạo liên kết phiên agent trên cùng màn hình là cách còn lại, không cần ứng dụng của bạn mở.)
3. Thêm máy chủ vào trợ lý
Địa chỉ là:
https://mcp.shinygen.ai/mcpHãy giữ đường dẫn /mcp; chỉ tên máy chủ thôi thì không phải là endpoint. Sau đó, trong client của bạn:
- Claude Code: chạy lệnh này một lần, rồi gõ
/mcpđể đăng nhập.
claude mcp add --transport http shinygen https://mcp.shinygen.ai/mcp- Claude trên web hoặc máy tính: mở Settings, rồi Connectors, rồi Add custom connector, và dán địa chỉ vào.
- ChatGPT: mở Settings, rồi Connectors, và bật Developer mode trong Advanced. Chọn Create, đặt tên là Shiny Gen, dán địa chỉ, và giữ tùy chọn đăng nhập.
- Cursor: trong Settings, tìm MCP và thêm một máy chủ mới với địa chỉ này, hoặc thêm vào file
mcp.json. - Client khác: dán cùng địa chỉ đó vào nơi client của bạn thêm máy chủ MCP hoặc connector.
4. Chấp thuận quyền truy cập
Lần đầu một client kết nối, trình duyệt sẽ mở trang đồng ý của Shiny Gen. Đăng nhập và chấp thuận. Việc đăng nhập dùng OAuth, và trợ lý yêu cầu ba quyền:
- projects.read: xem dự án của bạn: thứ đang hiện trên màn hình, tài liệu đang mở và trạng thái hiện tại của nó.
- projects.write: viết và sửa code game và tài liệu tài nguyên.
- assets.generate: chạy tạo nội dung bằng AI (hình ảnh, mô hình 3D, hoạt ảnh sprite, cùng hình ảnh, nhạc và hành vi viết dưới dạng code). Đây là quyền tiêu ngọc.
Bạn có thể ngắt kết nối bất cứ lúc nào, và Shiny Gen có một công tắc để chặn mọi trợ lý kết nối vào tài khoản của bạn.
5. Yêu cầu một game
Bắt đầu trò chuyện với trợ lý và nói cần xây gì: "Làm một game đua xe nhìn từ trên xuống, ba vòng đua với hai xe máy. Phím mũi tên để lái. Hiện số vòng." Giữ thẻ Shiny Gen ở chỗ bạn nhìn thấy được: các thay đổi hiện ra trực tiếp ở đó khi trợ lý làm việc, và bạn có thể chơi game bất cứ lúc nào.
Trợ lý làm được gì
Các công cụ chia thành năm nhóm. Trợ lý tự chọn chúng.
- Đọc dự án. Xem thứ đang hiện trên màn hình, đọc và tìm trong code game, xem cây scene, và tra tài liệu ngôn ngữ cùng API của Shiny Gen. Tài liệu đến qua connector, nên bạn không cần dạy trợ lý gì hay dán tài liệu vào.
- Viết code. Thay thế hoặc vá GDScript của game. Game được biên dịch và báo lỗi lại kèm số dòng.
- Chơi thử. Chạy game, chạy trong một khoảng thời gian game hoặc đến khi một điều kiện trong script đúng, đọc lỗi trực tiếp và output được in ra, chụp màn hình (kể cả chụp liên tiếp nhiều khung hình để kiểm tra chuyển động), và bấm phím, chạm và thao tác tay cầm, kể cả chuỗi thao tác có canh giờ khi một động tác cần hai nút cùng lúc. Với game 3D, nó còn kiểm tra được cảnh có các mặt chồng lên nhau gây nhấp nháy.
- Tạo tài nguyên. Tạo hình ảnh, biến một bức ảnh thành mô hình 3D có texture hoặc sprite sheet hoạt ảnh, xóa nền ảnh, và xem hoặc khôi phục các phiên bản trước. Mô hình 3D, hình ảnh 2D, bản nhạc và hành vi của từng thực thể cũng có thể viết dưới dạng code: trợ lý tự viết tài liệu miễn phí, hoặc nhờ một mô hình tạo ra với giá bằng ngọc, và dù cách nào bạn cũng có một tài liệu có thể tiếp tục chỉnh sửa.
- Quản lý game. Bắt đầu game mới, liệt kê game của bạn, mở một game ("quay lại game đi cảnh"), remix một game, và lấy liên kết chia sẻ.
Vòng lặp viết, chạy, nhìn và bấm đó chính là điểm mấu chốt. Một trợ lý chỉ biết viết code phải đoán xem game có chạy không; một trợ lý nhìn và chơi được thì sẽ biết.
Chi phí
- Kết nối là miễn phí.
- Code trợ lý viết không tốn ngọc. Nó chạy trên gói AI của riêng bạn, nên bạn trả nhà cung cấp AI cho mô hình, còn Shiny Gen không tính phí sửa code.
- Tạo nội dung tốn ngọc: hình ảnh, mô hình 3D, hoạt ảnh, và bất cứ thứ gì trợ lý nhờ một mô hình tạo ra. Mỗi kết quả trả phí đều báo số ngọc trước đó, đã dùng và còn lại.
- Giới hạn ngọc hằng ngày giới hạn số ngọc một trợ lý đã kết nối có thể tiêu trong một ngày, nên một trợ lý để chạy liên tục không thể tiêu sạch số dư của bạn.
- Hạn mức hằng tuần cho gói miễn phí. Lần kết nối đầu tiên bắt đầu thời gian dùng thử 30 ngày không giới hạn hạn mức. Sau đó, tài khoản miễn phí có hạn mức hằng tuần cho các thao tác làm thay đổi gì đó (viết code, tạo nội dung, chạy game), hiện là 300 mỗi tuần, đặt lại vào mỗi thứ Hai (UTC). Việc đọc không bao giờ bị giới hạn. Ai đã từng mua hàng, từ gói khởi đầu $2.99, thì hoàn toàn không bị hạn mức này. Trợ lý của bạn có thể kiểm tra trạng thái hiện tại qua connector.
Shiny Gen cũng có agent riêng tích hợp trong ứng dụng, với cùng khả năng. Khác biệt là ai chạy mô hình: agent tích hợp chạy trên Shiny Gen và mỗi bước của nó tiêu ngọc, còn trợ lý bên ngoài chạy trên gói của bạn. Xem trang bảng giá để biết giá ngọc.
Máy chủ hosted khác gì máy chủ MCP cầu nối trên máy tính
Phần lớn máy chủ MCP cho engine game là cầu nối cục bộ. Bạn cài engine và một plugin cho trình chỉnh sửa của nó, chạy một máy chủ nhỏ trên máy tính, và trỏ trợ lý tới đó bằng một lệnh. Trợ lý khi đó điều khiển trình chỉnh sửa trên chính máy đó. Cách này hợp khi bạn đã làm việc trong một engine trên máy tính: nó với tới toàn bộ trình chỉnh sửa, và engine có thể tạo bản build gốc cho game của bạn.
Một máy chủ hosted hoạt động khác:
- Không cần cài gì. Bạn thêm một URL và đăng nhập. Nó hoạt động với trợ lý trên trình duyệt, trong ứng dụng máy tính, hoặc trong terminal.
- Game chạy ở nơi bạn nhìn thấy, trong thẻ hoặc ứng dụng Shiny Gen, và bạn xem từng thay đổi được áp dụng.
- Không gắn với một máy tính. Kết nối thuộc về tài khoản của bạn, nên thẻ Shiny Gen và trợ lý có thể ở trên các máy khác nhau, miễn là cả hai cùng đăng nhập một tài khoản.
- Có sẵn tài nguyên. Công cụ hình ảnh, 3D và âm thanh nằm trong cùng máy chủ, tính bằng ngọc, không cần lập tài khoản riêng.
Những đánh đổi cũng giống như của chính Shiny Gen: dự án chạy trên bản fork Godot có sandbox của chúng tôi, nên trình chỉnh sửa Godot gốc không mở được chúng, và hiện chưa có bản build gốc cho game của bạn.
Giới hạn
- Khi mở kết nối từ ứng dụng, nó hoạt động khi ứng dụng đó còn mở. Nếu bạn đóng Shiny Gen hoặc nó mất kết nối, kết nối cho agent cũng dừng theo; hãy nhấn Mở kết nối agent ngoài lần nữa và kết nối lại. Để AI làm việc khi ứng dụng đã đóng, hãy đưa nó một liên kết phiên agent (phần tiếp theo).
- Nó không thể mua ngọc hay thay đổi tài khoản của bạn. Máy chủ từ chối việc mua hàng, cài đặt và thay đổi tài khoản.
- Nó chỉ làm việc trên game của bạn. Nó có thể duyệt danh mục công khai và remix từ đó, nhưng không bao giờ thay đổi game của người khác.
Hoặc để AI tự chạy Shiny Gen
Với liên kết phiên agent, AI của bạn chạy Shiny Gen trong trình duyệt riêng của nó, và phía bạn không cần mở gì.
- Tạo liên kết. Với game mới, nhấn + rồi Liên kết trong Dùng agent của riêng bạn. Với game đang mở, mở bộ chọn mô hình, chọn Kết nối mô hình bên ngoài qua MCP, rồi Tạo liên kết phiên agent.
- Chọn thời lượng phiên: 1 giờ hoặc 24 giờ.
- Nhấn Sao chép liên kết và dán cho AI của bạn. Bản sao có kèm một ghi chú ngắn chỉ nó cách mở liên kết. Giờ bạn có thể đóng Shiny Gen.
AI mở liên kết trong trình duyệt riêng của nó (một trình duyệt headless do code của nó khởi động cũng tính) và có được một trình chỉnh sửa Shiny Gen trên game đó cùng một token cho cùng máy chủ MCP, không cần bước đăng nhập hay đồng ý. Các giới hạn: liên kết chỉ dùng được một lần, trong vòng một giờ; tài khoản của bạn chỉ có một phiên agent đang chạy mỗi lúc, nên liên kết mới hơn sẽ kết thúc phiên cũ; trong khi phiên chạy, bản game đó của chính bạn mở ở chế độ chỉ đọc với nút Kết thúc phiên agent; và bạn có thể xem và thu hồi các phiên trong Agent access and spending. Ngọc hoạt động giống như trên. Tài liệu MCP có chi tiết, cùng cách tự viết MCP client.
Nếu không kết nối được
- "Not hosting": nhấn Mở kết nối agent ngoài trong ứng dụng, rồi kết nối lại.
- Không thấy cửa sổ đăng nhập: cho phép cửa sổ bật lên cho trang của AI client và thử lại.
- Kết nối thất bại ngay lập tức: kiểm tra rằng địa chỉ kết thúc bằng
/mcp. - "Agent access is switched off": bật "Cho phép agent AI kết nối" trong ứng dụng hoặc trên trang đồng ý.
Câu hỏi thường gặp
Có máy chủ MCP cho Godot không?
Có, thuộc hai loại. Máy chủ cầu nối cục bộ kết nối trợ lý với trình chỉnh sửa Godot trên máy tính của bạn, qua một plugin cho trình chỉnh sửa. Máy chủ của Shiny Gen tại mcp.shinygen.ai là hosted: nó điều khiển một game Godot chạy trong Shiny Gen, trên trình duyệt hoặc ứng dụng, không cần cài gì.
Mình có cần cài gì không?
Không. Bạn thêm địa chỉ https://mcp.shinygen.ai/mcp vào trợ lý và đăng nhập. Game chạy trong Shiny Gen trên trình duyệt hoặc ứng dụng.
Nó có dùng được với ChatGPT không?
Có. Trong ChatGPT, bật Developer mode trong Settings, Connectors, Advanced, rồi tạo một connector với địa chỉ này. Claude, Grok, Cursor, opencode và mọi MCP client khác cũng dùng được.
Chi phí bao nhiêu?
Kết nối và sửa code không tốn ngọc. Tạo hình ảnh, mô hình 3D, hoạt ảnh và âm thanh tốn ngọc, có giới hạn hằng ngày. Tài khoản miễn phí có 30 ngày dùng thử, sau đó là hạn mức thao tác hằng tuần (hiện là 300); một lần mua bất kỳ từ $2.99 sẽ bỏ hạn mức này.
Nó có chạy khi Shiny Gen đã đóng không?
Có, với liên kết phiên agent: AI của bạn chạy Shiny Gen trong trình duyệt riêng của nó, nên phía bạn không cần mở gì. Nếu bạn kết nối bằng cách mở kết nối từ ứng dụng (Mở kết nối agent ngoài), ứng dụng phải luôn mở trong khi trợ lý làm việc.
Mình có tự xây client được không?
Có. Máy chủ dùng Streamable HTTP và OAuth 2.1 với PKCE, có đăng ký client động cho public client. Tài liệu MCP có chi tiết.