Bảng tra cứu lỗi nhanh
| Lỗi | Nguyên nhân | Cách xử lý |
|---|---|---|
401 Unauthorized | API key sai hoặc bị thu hồi | Tạo key mới tại get-key portal |
Permission denied (99991664) | Thiếu OAuth scope | Thêm scope còn thiếu theo Bước 2, publish lại app |
Token expired | OAuth token hết hạn | Token tự refresh; nếu vẫn lỗi, chạy lại lệnh claude mcp add với --callback-port 8912 |
redirect_uri_mismatch | Redirect URI chưa được thêm vào Lark app | Thêm URI callback vào Security Settings trong Developer Console |
User not found (403) | Email chưa có trong hệ thống KesFlow | Liên hệ Admin org hoặc đợi sync tự động (tối đa 24h) |
App not found | App ID không đúng hoặc chưa được đăng ký | Kiểm tra App ID trong Developer Console, liên hệ support |
| Không thấy Connectors tab | Đang dùng Claude Free plan | Nâng cấp lên Claude Pro/Max/Team |
| MCP timeout | Server quá tải hoặc mạng chậm | Thử lại sau vài phút |
Lỗi chi tiết theo từng bước
Khi tạo Lark App
Không thấy nút 'Create Custom App'
Không thấy nút 'Create Custom App'
Tài khoản chưa có quyền Developer. Liên hệ Admin tổ chức Lark để được cấp quyền tại: Lark Admin Console → Members → chọn user → Edit Roles.
App tạo xong nhưng không active
App tạo xong nhưng không active
App cần được publish. Vào Version Management & Release → Create Version → Request Release. Admin phê duyệt để app active.
Khi thêm OAuth Scopes
Scope không xuất hiện trong danh sách tìm kiếm
Scope không xuất hiện trong danh sách tìm kiếm
Một số scope yêu cầu tổ chức phải có gói Enterprise của Lark. Kiểm tra lại gói dịch vụ Lark của tổ chức bạn.
Scope đã thêm nhưng vẫn báo Permission denied
Scope đã thêm nhưng vẫn báo Permission denied
Sau khi thêm scope, bạn cần publish lại app (tạo version mới). Scope chỉ có hiệu lực sau khi version mới được phê duyệt.
Khi xác thực OAuth
Cửa sổ OAuth mở ra rồi đóng ngay, không xác thực được
Cửa sổ OAuth mở ra rồi đóng ngay, không xác thực được
Kiểm tra popup blocker của trình duyệt. Cho phép popup từ domain KesFlow và thử lại.
Claude Code báo 'callback port in use'
Claude Code báo 'callback port in use'
Port 8912 đang bị chiếm. Thử port khác:
Ghi log để debug
Với Claude Code, bật verbose mode để xem chi tiết lỗi:Liên hệ hỗ trợ
Nếu không tự xử lý được:Website hỗ trợ
kesflow.vn
Gửi báo cáo lỗi
Mô tả lỗi + screenshot + bước tái hiện
Khi liên hệ support, hãy cung cấp: tên nền tảng AI (Claude.ai / Claude Code / Antigravity), mã lỗi cụ thể, và các bước đã thử.