Lỗi thường gặp
Bảng dưới lấy từ mục 7 của hướng dẫn cài MCP, đối chiếu code hiện tại. Gửi mã lỗi cho quản trị, không gửi mật khẩu/token.
| Claude báo | Nghĩa là | Làm gì |
|---|---|---|
| "MCP đang tắt, liên hệ admin" | Admin đang tắt MCP | Hỏi admin |
| "Bạn không có quyền dùng công cụ này" | Vai trò của bạn không có công cụ đó (mục 4) | Nhờ người có vai trò phù hợp |
| "Chỉ làm được với khách của bạn; khách ở kho chung cần nhận trước" | Sale ghi chú/gắn nhãn/tạo đơn cho khách chưa nhận | Nhận khách trước (claim_contacts) |
| "Khách này đang có người khác phụ trách" | Khách của sale khác | Nhờ admin/marketing chuyển khách nếu cần |
| "Vượt hạn mức nhận khách hôm nay…" | Đã nhận đủ hạn mức ngày | Nhận ít khách hơn, hoặc để ngày mai |
| "Tài khoản chưa gắn Sales Person, nhờ admin gắn" | Tài khoản sale chưa có Employee/Sales Person | Admin tạo Employee (gắn user) và Sales Person |
| "Bạn gọi quá nhiều lần, hãy thử lại sau ít phút" | Quá giới hạn tần suất (60 lần/phút, tìm khách 300 lần/giờ) | Chờ vài phút |
| "Hệ thống đang bận, chưa có gì được lưu; hãy thử lại…" | Hai người cùng sửa một khách một lúc | Thử lại sau vài giây |
| "Nhãn không hợp lệ…" | Nhãn có dấu phẩy, ký tự <, >, ", ', &, dấu huyền ngược hoặc ký tự điều khiển | Đặt lại tên nhãn chỉ gồm chữ, số, khoảng trắng, - / ( ) . : |
| "Tài khoản … chưa gắn Sales Person, nhờ admin gắn trước khi giao khách" | Admin/marketing giao khách cho sale chưa có Sales Person | Admin tạo Employee (gắn user) và Sales Person rồi giao lại |
group_disabled — “Nhóm công cụ này đang tắt, liên hệ admin” | Tắt riêng nhóm R2 | Nhờ Chủ bật đúng nhóm trong Edu Settings → MCP, làm mới danh sách |
confirm_invalid — mã xác nhận sai/hết hạn | Token hết hạn, đã dùng, đổi tài khoản/công cụ/tham số | Đọc bản xem trước mới và đồng ý lại; không gọi ghi tự động |
conflict — “Mã đã dùng cho bản ghi khác” | Trùng mã nhưng khác nội dung | Kiểm bản ghi/mã với người dùng, không ghi đè; nếu đang duyệt email, xem bản nội dung và lấy content_hash mới rồi duyệt lại |
| “Việc này cần Quản trị hệ thống” | Mời/nghỉ nhân viên cần System Manager; hồ sơ Chủ không đủ | Chuyển người quản trị được phân công, không tự gán thêm role |
| "Lỗi hệ thống, mã …" | Lỗi bất ngờ | Gửi mã cho admin (Error Log) |
| Claude Code báo cần đăng nhập lại / 401 | Token hết hạn hoặc đã bị thu hồi | Gõ /mcp → Authenticate lại |
| claude.ai connector không kết nối được, Claude Code vẫn chạy | Tài khoản có Restrict IP: connector gọi từ IP của Anthropic nên bị chặn | Admin bỏ giới hạn IP cho tài khoản đó, hoặc chỉ dùng Claude Code |
Nếu đăng ký client báo redirect_uris must be https: chuyển quản trị/kỹ thuật kiểm callback. Ca HTTP này dùng IP loopback 127.0.0.1; không tự đổi cấu hình bảo mật server. Nếu công cụ không có trong danh sách, kiểm đúng vai trò và nhóm trước khi kết nối lại.