Tab MCP: duong dan unzip folder va Download package
Duong dan MCP tren Windows

DINHDANH Creator · Bài K12 · Kỹ thuật

MCP path trên Windows
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

Hoàn tất H02/T12 → Tải gói DINHDANH Aura MCP (.zip)
→ Giải nén vào path không khoảng trắng (vd. Desktop)
Panel MCP → ô Thư mục giải nén trên máy dev
→ Dán C:/Users/.../appifio-aura-mcp-xxx
→ Nhấn Sao chép trên mẫu Cách A - dấu / (khuyến nghị)
→ Hoặc Cách B - backslash thoát (C:\\Users\\...)
❌ Một dấu \ trong JSON (C:\Users\...) → lỗi parse
Cài Node 18+ · command: node hoặc npx · mở lại IDE

2. 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átMỗi \ thành \\ trong JSON - dễ sai nếu gõ tay
Sao chépNú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

  1. Hoàn tất H02: bật MCP, tạo phiên sandbox, token - theo T12.
  2. Tải gói DINHDANH Aura MCP (.zip) → giải nén vào thư mục không có space (tránh Program Files có khoảng trắng).
  3. 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.
  4. 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.
  5. Cài Node 18+; trong config dùng node hoặc npx - khởi động lại IDE.
  6. 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ốngXử lý
IDE báo JSON invalid / parse errorDùng Sao chép Cách A; kiểm tra không còn single \
MCP server không startNode 18+; path trỏ đúng server.js; không space trong path
403 Forbidden sau một ngàyTải lại gói zip + token mới (X09, H02)
IDE sửa xong site live chưa đổiMCP chỉ sandbox - cần Lưu thay đổi trong Creator (T12)
Cursor không nhận MCP sau copyRestart 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

  1. Bạn copy được Cách A vào IDE không lỗi JSON?
  2. Path giải nén không có khoảng trắng và Node ≥ 18?
  3. Bạn biết tải lại zip khi 403 (X09)?
  4. 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.

DINHDANH Creator · Bộ hướng dẫn người dùng · K12 · Tham chiếu H02, T12, X09