
DINHDANH Creator · Bài K12 · Kỹ thuật
Cách A dấu / · Cách B backslash thoát · Sao chép
JSON MCP config gãy vì một dấu \ - bài cuối nhóm K hướng dẫn điền đúng ô Thư mục giải nén và copy mẫu path an toàn vào IDE.
Mục tiêu bài học: Cấu hình MCP bridge trên Windows không lỗi parse JSON; biết khi nào tải lại gói zip.
Thời lượng đọc: khoảng 11 phút
Điều kiện trước: H02 (MCP gateway), T12 (sandbox/token/bridge).
Bài trước → sau: K11 → K12 → nhóm X01-X13
Nhãn UI: Thư mục giải nén trên máy dev · Cách A - dấu / (khuyến nghị) · Cách B - backslash thoát · Sao chép · Tải gói DINHDANH Aura MCP (.zip)
1. Sơ đồ cấu hình path
C:/Users/.../appifio-aura-mcp-xxxC:\\Users\\...)C:\Users\...) → lỗi parsenode hoặc npx · mở lại IDE2. Thuật ngữ
| Thuật ngữ | Nghĩa |
|---|---|
| Thư mục giải nén trên máy dev | Ô nhập path thư mục chứa server.js sau khi giải nén zip MCP |
| Cách A - dấu / (khuyến nghị) | Path dạng C:/Users/Name/Desktop/... - an toàn trong JSON |
| Cách B - backslash thoát | Mỗi \ thành \\ trong JSON - dễ sai nếu gõ tay |
| Sao chép | Nút copy mẫu config đã escape đúng - dán thẳng vào IDE MCP settings |
| Tải gói DINHDANH Aura MCP (.zip) | Bridge local hết hạn ~24h - tải lại khi 403 (X09) |
3. Các bước trên Windows
- Hoàn tất H02: bật MCP, tạo phiên sandbox, token - theo T12.
- Tải gói DINHDANH Aura MCP (.zip) → giải nén vào thư mục không có space (tránh
Program Filescó khoảng trắng). - Dán path vào ô Thư mục giải nén trên máy dev - dùng dấu
/hoặc copy từ Explorer rồi đổi. - Nhấn Sao chép trên khối Cách A - dấu / (khuyến nghị) → dán vào Cursor/VS Code MCP config.
- Cài Node 18+; trong config dùng
nodehoặcnpx- khởi động lại IDE. - 403 sau ~24h hoặc token hết hạn → tải lại gói zip (X09).
4. Giải thích Cách A vs Cách B
Cách A (khuyến nghị):
"args": ["C:/Users/YourName/Desktop/appifio-aura-mcp-abc123/server.js"]
Cách B (backslash thoát):
"args": ["C:\\Users\\YourName\\Desktop\\appifio-aura-mcp-abc123\\server.js"]
Sai (JSON gãy): C:\Users\... - một backslash bị hiểu là escape sequence.
5. So sánh với MCP JSON nói chung
- Mọi MCP server trên Windows: cùng bẫy escape - không riêng DINHDANH.
- WSL path: có thể dùng
/mnt/c/...- vẫn theo Cách A. - macOS/Linux: ít gặp vì path không dùng backslash - bài K12 tập trung Windows.
6. Giới hạn kỹ thuật
Path có khoảng trắng (vd. C:/Users/Your Name/...) - dễ lỗi args/command; đặt thư mục không space.
Node < 18 - server.js có thể không chạy; nâng Node rồi restart IDE.
Gói zip ~24h - không phải bug path; tải lại từ panel MCP (X09).
7. Bảo mật
Token MCP trong config IDE là secret local - không commit lên Git công khai. Path zip chỉ trên máy dev; thu hồi token trong panel khi đổi máy (T12).
8. Vấn đề thường gặp
| Tình huống | Xử lý |
|---|---|
| IDE báo JSON invalid / parse error | Dùng Sao chép Cách A; kiểm tra không còn single \ |
| MCP server không start | Node 18+; path trỏ đúng server.js; không space trong path |
| 403 Forbidden sau một ngày | Tải lại gói zip + token mới (X09, H02) |
| IDE sửa xong site live chưa đổi | MCP chỉ sandbox - cần Lưu thay đổi trong Creator (T12) |
| Cursor không nhận MCP sau copy | Restart IDE; kiểm tra file mcp.json hợp lệ bằng JSON validator online |
9. Lời khuyên
- Luôn dùng nút Sao chép Cách A - đừng gõ path tay vào JSON.
- Đặt thư mục giải nén cố định (vd.
C:/dev/appifio-mcp) - dễ cập nhật khi tải zip mới. - Ghi chú ngày tải zip để renew trước hết hạn 24h.
10. Checklist tự kiểm · Kết thúc nhóm K
- Bạn copy được Cách A vào IDE không lỗi JSON?
- Path giải nén không có khoảng trắng và Node ≥ 18?
- Bạn biết tải lại zip khi 403 (X09)?
- Nhóm K hoàn chỉnh: pipeline an toàn (K02), guest form (K05), domain preview (K09), MCP path (K12).
Sau nhóm K
X01-X13 - Xử lý sự cố & FAQ
Tra cứu nhanh rate limit (X06), MCP 403 (X09), preview domain (X05) khi gặp lỗi production.
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · Bộ hướng dẫn người dùng · K12 · Tham chiếu H02, T12, X09