
DINHDANH Creator · Bài H02 · Nâng cao
sandbox, token, cấu hình IDE
Bài này dành cho ai muốn dùng IDE quen tay (Cursor, v.v.) để AI chỉnh sửa app - vẫn phải hiểu rõ ranh giới sandbox vs live.
Mục tiêu bài học: Bật MCP đúng thứ tự, tạo token an toàn, cấu hình IDE thành công, và hiểu vì sao sửa qua IDE chưa lên live ngay.
Thời lượng đọc: khoảng 15 phút
Điều kiện trước: Đã hiểu tab Backend (F01); có IDE hỗ trợ MCP (ví dụ Cursor) và Node.js 18+ trên máy.
Bài trước → sau: F01 → H02 → H04 (History/DOM search khi làm việc song song)
1. Sơ đồ thứ tự bắt buộc
mcp-config.json.example → copy đúng path (Cách A "/" hoặc Cách B "\\\\") vào cài đặt MCP của IDE2. Thuật ngữ (nhãn UI VI chính xác)
| Nhãn UI | Nghĩa | Nơi thấy |
|---|---|---|
| Bật tích hợp MCP | Cờ bật/tắt gateway MCP cho app | Tab MCP hoặc CMS → Cài đặt → MCP |
| Tạo / resume phiên | Tạo hoặc tiếp tục phiên sandbox - bắt buộc trước Tạo token | Tab MCP |
| Tạo token | Sinh token bridge - hiện đầy đủ một lần, copy ngay | Sau khi có phiên sandbox |
| Tải gói DINHDANH Aura MCP (.zip) | Gói cấu hình IDE + bridge - hết hạn ~24h | Tab MCP |
| Lưu trạng thái MCP | Chốt cấu hình sau khi bật gateway + token | Cuối tab MCP |
| Thu hồi | Vô hiệu token lộ hoặc không dùng nữa | Bảng Token API |
3. Các bước chi tiết
- Mở tab "MCP" trong Creator (hoặc Cài đặt → MCP trong Aura CMS - cùng một tính năng, hai lối vào). Tick "Bật tích hợp MCP".
- Nhấn "Tạo / resume phiên" - hệ thống báo "Phiên MCP đã sẵn sàng." kèm Session ID, thời điểm tạo, số file đã nạp. Nếu cần làm mới hoàn toàn, dùng "Tạo phiên mới".
- Đặt Nhãn token (ví dụ "Máy dev") rồi nhấn "Tạo token". Copy ngay - hệ thống cảnh báo "Token đã tạo - sao chép ngay, sẽ không hiển thị lại."
- Điền "Thư mục giải nén trên máy dev" (không khoảng trắng, ví dụ
C:/Users/YourName/Desktop/appifio-aura-mcp-myshop), nhấn "Tải gói DINHDANH Aura MCP (.zip)". - Giải nén file zip vào đúng thư mục đã khai. Mở
mcp-config.json.example, copy nội dung vào cài đặt MCP của IDE - chọn Cách A (dấu /) khuyến nghị, hoặc Cách B (backslash thoát) nếu dùng đường dẫn Windows kiểu cũ. - "command" trong config có thể là
nodehoặcnpx- cần Node.js 18+ đã cài, mở lại IDE nếu vừa cài Node. - Nhấn "Lưu trạng thái MCP" để chốt lại toàn bộ cấu hình.
- Trong IDE, thử lệnh đơn giản (vd. "liệt kê file trong sandbox") để xác nhận MCP kết nối thành công trước khi refactor lớn.
- Nếu tab MCP trong Creator và tab MCP trong CMS (G05) đều có - cấu hình một nơi rồi Lưu trạng thái MCP; hai lối vào cùng một gateway.
- Khi token hết hạn (60 ngày) hoặc gói zip hết hạn (~24h): Thu hồi token cũ → tạo phiên mới nếu cần → Tạo token → tải lại gói .zip.
4. So sánh với công cụ khác
- Cursor/Claude Desktop MCP servers thông thường: cùng chuẩn Model Context Protocol; Aura MCP đặc thù ở việc AI trong IDE chỉ chạm được sandbox riêng của app, không phải file hệ thống máy bạn.
- GitHub Codespaces/VS Code Remote: tương tự về việc "IDE bên ngoài kết nối vào môi trường làm việc từ xa", nhưng ở đây môi trường là sandbox nội dung app, không phải máy chủ đầy đủ.
- Webflow/Framer: không có tương đương - đây là điểm khác biệt lớn của DINHDANH cho phép dev "thoát ra" khỏi Creator khi cần công cụ mạnh hơn.
5. Giới hạn kỹ thuật quan trọng
Sandbox không phải live: mọi sửa đổi AI làm qua IDE/MCP chỉ nằm trong phiên sandbox. Để khách thấy, bạn phải mở lại DINHDANH Creator và bấm "Lưu thay đổi" - MCP không tự publish.
Token tối đa 10/phiên, hết hạn 60 ngày. Gói bridge (.zip) hết hạn sau ~24 giờ - nếu IDE báo lỗi 403, tải lại gói mới từ Creator/CMS.
Đường dẫn thư mục giải nén không được chứa khoảng trắng; sai một dấu \ trong JSON trên Windows sẽ làm hỏng cấu hình - dùng đúng Cách A hoặc Cách B như hướng dẫn.
6. Bảo mật
- Giữ file zip và token riêng tư - nếu lộ, nhấn "Thu hồi" token ngay trong bảng Token API.
- Mỗi token chỉ hiển thị đầy đủ một lần lúc tạo - không có cách xem lại, chỉ có thể thu hồi và tạo token mới.
- Đặt Nhãn token rõ ràng theo máy/người dùng (vd. "Laptop Nam", "PC văn phòng") để dễ thu hồi đúng token khi cần, không ảnh hưởng người khác đang dùng.
7. Vấn đề thường gặp
| Tình huống | Xử lý |
|---|---|
| "Tạo phiên sandbox chỉnh sửa trước khi tạo token" (không tạo được token) | Quay lại bước "Tạo / resume phiên" trước, rồi mới tạo token |
| IDE báo lỗi 403 sau một ngày | Gói bridge đã hết hạn ~24h - tải lại gói MCP (.zip) mới |
| JSON lỗi trên Windows khi dán path | Không dùng một dấu \ đơn - chọn đúng Cách A (dấu /) hoặc Cách B (\\\\ escaped) |
| AI sửa trong IDE nhưng khách không thấy gì đổi | Đúng theo thiết kế - mở Creator, kiểm tra Thay đổi rồi Lưu thay đổi để publish |
8. Lời khuyên
- Chỉ bật MCP khi thật sự cần công cụ IDE mạnh hơn (refactor lớn, debug phức tạp) - với việc nhỏ, Creator + AI Agent thường nhanh hơn.
- Ghi chú ngày tạo token/gói zip để tự nhắc tải lại trước khi hết hạn 24h/60 ngày.
- Sau khi hoàn tất một phiên làm việc IDE, luôn quay lại Creator kiểm tra "Thay đổi" và Lưu thay đổi ngay - đừng để sandbox trôi quá lâu chưa publish.
9. Checklist tự kiểm
- Bạn thực hiện đúng thứ tự: Bật MCP → Tạo phiên → Tạo token → Tải gói → Cấu hình IDE?
- Bạn hiểu sandbox khác live, và MCP không tự publish?
- Bạn nhớ token chỉ hiện 1 lần và gói zip hết hạn sau ~24h?
Bài tiếp theo
H03 - Android Mock & hướng APK Capacitor
Xem thử app dưới dạng khung điện thoại Android ngay trong preview, và hiểu rõ giới hạn BETA khi xuất APK.
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · Bộ hướng dẫn người dùng · H02