Panel MCP Connect Download package va tuy chon bridge
Khoi phuc MCP 403

DINHDANH Creator · Bài X09 · Xử lý sự cố

MCP 403 / hết hạn bridge
(~24h) & token 60 ngày

IDE báo 403 Forbidden sau ~một ngày, hoặc MCP “chết” đột ngột - thường là bridge zip hết hạn hoặc token bị thu hồi/hết hạn. Đây là giới hạn có chủ đích, không phải bug ngẫu nhiên.

Mục tiêu: Phân biệt lỗi bridge (~24h) vs token (60 ngày); làm đúng thứ tự UI; biết khi nào Thu hồi.

Trước: T12, H02, K12 · Sau: X10

UI tab MCP: Bật tích hợp MCP · Lưu trạng thái MCP · Tạo / resume phiên · Tạo token · Thu hồi · Tải gói DINHDANH Aura MCP (.zip)

1. Sơ đồ chẩn đoán 403

IDE / Cursor MCP → 403 Forbidden sau ~24h?
→ Gói bridge hết hạn (~24h)
→ Tab MCP → Tải gói DINHDANH Aura MCP (.zip) lại → cập nhật config IDE (K12)
403 ngay / token cũ / nghi lộ?
→ Thu hồi token cũ → Tạo token mới (copy 1 lần duy nhất)
“Tạo phiên sandbox… trước khi tạo token”?
→ Nhấn Tạo / resume phiên trước
no_api_key / Backend trống?
→ Tab Backend - tạo API key trước (T06)

2. Hai loại hết hạn

Thành phầnThời hạnTriệu chứngSửa
Bridge zip~24 giờ403 sau ~1 ngày làm việc; server.js trong zip không còn hợp lệTải zip mới + cập nhật path IDE
Token MCP60 ngày403 sớm; token > 60 ngày; hoặc đã Thu hồiThu hồi (nếu lộ) → Tạo token mới
Sandbox sessionTheo phiên“Chưa có phiên”; tool MCP không list fileTạo / resume phiên

3. Các bước khôi phục (đúng thứ tự)

  1. Tab "Backend" - xác nhận có API key backend (hex 32 ký tự). Thiếu → tạo trong cài đặt tài khoản trước.
  2. Tab "MCP" → bật "Bật tích hợp MCP" → "Lưu trạng thái MCP".
  3. "Tạo / resume phiên" - đợi Session ID hiện (không còn “Chưa có phiên”).
  4. Nếu token cũ hết hạn hoặc nghi lộ: "Thu hồi" → xác nhận → "Tạo token" → sao chép ngay (chỉ hiện 1 lần).
  5. Nhấn "Tải gói DINHDANH Aura MCP (.zip)" - giải nén vào thư mục không có khoảng trắng (K12).
  6. Cập nhật mcp-config trong Cursor/IDE - token mới + path zip mới (Cách A dùng / trên Windows).
  7. Khởi động lại MCP server trong IDE → thử list file sandbox.
  8. Sau khi sửa qua IDE: mở Creator → "Thay đổi" → "Lưu thay đổi" để lên live (T12).

4. So sánh · Bảo mật

  • SSH key rotation: tương tự Thu hồi + Tạo token khi nghi lộ.
  • OAuth refresh token: bridge 24h giống session ngắn - buộc tải lại định kỳ.

Bảo mật: zip và token là secret - không commit vào Git public; README trong gói zip nhắc giữ riêng tư. Lộ token trên Slack/screenshot → Thu hồi ngay. Tối đa ~10 token/phiên - dọn token máy cũ không dùng.

5. Sự cố · Lời khuyên

Tình huốngXử lý
403 mỗi sáng sau ngày làm việcBridge 24h - tải zip mới; đặt nhắc nhở cuối ngày
Token “mất” sau tạoUI chỉ show 1 lần - Thu hồi + Tạo lại; lưu password manager
Path Windows JSON lỗiDùng forward slash hoặc escaped backslash (K12)
IDE sửa OK nhưng site không đổiMCP chỉ sandbox - cần Lưu thay đổi Creator (X13)
  • Cuối tuần làm việc: tải zip mới thứ Hai - đừng giả định bridge cuối tuần còn sống.
  • Một máy dev = một token có nhãn (vd. Laptop Lenovo).

6. Checklist

  1. Bạn đã Tạo / resume phiên trước Tạo token?
  2. Bạn phân biệt được sửa bridge (24h) vs token (60 ngày)?
  3. Bạn biết Thu hồi khi nào và không commit token vào repo?

Tiếp: X10 - Build APK thất bại

DINHDANH Creator · X09 · Tham chiếu T12, H02, K12