Kết nối ứng dụng AI ngoài (MCP)

MCP (Model Context Protocol) là "cổng cắm" chung để các ứng dụng AI dùng được công cụ của ứng dụng khác. Khi bật MCP, bạn có thể mở Claude Desktop, Claude Code, Cursor, Codex… và nói bằng lời thường như "dựng cảnh hai người gặp nhau ở quán cà phê rồi quay phim 1080p" — AI sẽ tự làm trên dự án đang mở của adayroi studio, bạn nhìn thấy từng bước ngay trong app.

Cài đặt (chỉ làm một lần)#

1. Mở Cài đặt → Kết nối Agent bên ngoài (hoặc nút Kết nối trong khung Trợ lý AI trên canvas).
2. Mở một dự án canvas, rồi bật công tắc Kết nối AI bên ngoài (MCP). Dòng trạng thái chuyển sang Sẵn sàng.
3. Ở mục Ứng dụng AI, bấm Cài cạnh ứng dụng bạn dùng:
   • Claude Desktop — sau khi cài, thoát hẳn Claude Desktop (cả biểu tượng ở khay hệ thống) rồi mở lại.
   • Claude Code — mở phiên mới; gõ /mcp để thấy storyboard_canvas đã kết nối.
   • Cursor — mở lại Cursor; vào Settings → MCP để thấy công cụ.
4. Ứng dụng khác (Codex, Windsurf, VS Code…): bấm Ứng dụng khác (Codex, cấu hình thủ công), Sao chép đoạn cấu hình và dán vào tệp cấu hình MCP của ứng dụng đó theo đường dẫn hiển thị.

Kết nối vẫn dùng được khi bạn khởi động lại máy hay đổi dự án — không cần cài lại. Nếu app chưa mở, ứng dụng AI sẽ tự mở adayroi studio khi cần.

Câu đầu tiên nên nói#

Trong ứng dụng AI, gõ:

adayroi studio làm được những gì?

AI sẽ đưa ra thực đơn các việc có thể nhờ (dự án & thư mục, storyboard, dựng cảnh 3D, diễn xuất, giọng nói, quay phim, tạo ảnh/video…) kèm câu nói mẫu. Danh sách đầy đủ có trong bài Lệnh MCP và câu nói mẫu, và trong mục Bạn có thể nhờ AI làm gì ở màn hình cài đặt (bấm một câu mẫu để sao chép).

Mẫu lệnh có sẵn (quy trình làm sẵn)#

adayroi studio gửi kèm các mẫu lệnh — quy trình nhiều bước đã viết sẵn cho AI, bạn chỉ điền ý tưởng:

Cách gọi:

• Claude Code: gõ /mcp__storyboard_canvas__ rồi chọn, ví dụ /mcp__storyboard_canvas__director_scene.
• Claude Desktop: bấm nút + trong ô chat → chọn storyboard_canvas → chọn mẫu lệnh.
• Cursor và ứng dụng khác: chỉ cần nói tự nhiên, ví dụ "dùng mẫu fight_scene cho hai nhân vật đang chọn".

AI được tự làm những gì#

Ở mục AI được tự làm những gì, chọn mức bạn muốn:

• Luôn hỏi — mọi thay đổi đều chờ bạn bấm duyệt trong app.
• Thông minh (khuyên dùng) — sửa canvas và Director chạy ngay; việc tốn credit (tạo ảnh/video, thu giọng AI, làm mô hình AI) luôn hỏi trước và báo chi phí.
• Tự động hoàn toàn — cả việc tốn credit cũng chạy ngay, nhưng không vượt ngân sách Agent.
• Toàn quyền (không hỏi) — AI làm hết, kể cả xoá node và đổi cài đặt. Chỉ bật khi bạn tin tưởng hoàn toàn.

Ở mọi mức trừ Toàn quyền, xoá node và xoá dự án luôn hỏi bạn trước. Mọi thao tác hiện ở mục Hoạt động, và sửa trên canvas hoàn tác được bằng Ctrl+Z.

Mẹo để AI làm tốt#

• Nói mục tiêu thay vì từng bước: "quảng cáo cà phê 30 giây, sáng sớm, hai diễn viên".
• Để AI xem trước rồi mới quay phim thật: "quay bản xem trước nhẹ trước, ổn thì quay 1080p".
• Muốn tiết kiệm credit: dặn "chỉ dùng tính năng miễn phí" — dựng cảnh, diễn xuất, quay phim trên máy đều miễn phí.
• Đang chọn nhân vật/đồ vật trong Director Studio? Nói "hai người đang chọn" — AI đọc được lựa chọn của bạn.

Khắc phục sự cố#

• AI không thấy công cụ: kiểm tra công tắc MCP đang bật và đã mở một dự án; khởi động lại hẳn ứng dụng AI; bấm Cài lại nếu dòng ứng dụng báo đã cũ.
• AI báo "đang chờ duyệt": mở adayroi studio và duyệt thẻ yêu cầu (hoặc đổi sang mức Thông minh).
• Xuất video chậm khi AI quay: giữ cửa sổ adayroi studio ở phía trước trong lúc quay.
• Vẫn lỗi? Nói với AI "kiểm tra sức khoẻ app" — nó sẽ dùng công cụ chẩn đoán và báo kết quả cho bạn.