Skip to main content

​
Bảng tra cứu lỗi nhanh

LỗiNguyên nhânCách xử lý
401 UnauthorizedAPI key sai hoặc bị thu hồiTạo key mới tại get-key portal
Permission denied (99991664)Thiếu OAuth scopeThêm scope còn thiếu theo Bước 2, publish lại app
Token expiredOAuth token hết hạnToken tự refresh; nếu vẫn lỗi, chạy lại lệnh claude mcp add với --callback-port 8912
redirect_uri_mismatchRedirect URI chưa được thêm vào Lark appThêm URI callback vào Security Settings trong Developer Console
User not found (403)Email chưa có trong hệ thống KesFlowLiên hệ Admin org hoặc đợi sync tự động (tối đa 24h)
App not foundApp 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 planNâng cấp lên Claude Pro/Max/Team
MCP timeoutServer quá tải hoặc mạng chậmThử lại sau vài phút

​
Lỗi chi tiết theo từng bước

​
Khi tạo Lark 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 cần được publish. Vào Version Management & Release → Create Version → Request Release. Admin phê duyệt để app active.

​
Khi thêm OAuth Scopes

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.
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

Kiểm tra popup blocker của trình duyệt. Cho phép popup từ domain KesFlow và thử lại.
Port 8912 đang bị chiếm. Thử port khác:
claude mcp add --transport http lark-token-manager \
  https://bkwfrmuktujgyclgwldb.supabase.co/functions/v1/mcp-server \
  --callback-port 8913

​
Khi đăng nhập portal

Email bạn nhập chưa được Admin tổ chức kích hoạt, hoặc chưa được sync từ Lark. Liên hệ Admin org để được activate, hoặc kiểm tra lại email Lark công ty của bạn.

​
Khi thanh toán

Mã QR có hiệu lực 30 phút. Vào portal tạo lại payment mới - thao tác này không tính phí.
SePay từ chối xác nhận nếu số tiền không khớp chính xác. Chuyển thêm phần thiếu với cùng nội dung chuyển khoản trong vòng 30 phút kể từ lúc tạo QR.
Kiểm tra lại lịch sử giao dịch ngân hàng xác nhận đã gửi thành công. Nếu đã gửi, liên hệ support tại kesflow.vn với mã giao dịch ngân hàng và email tổ chức.

​
Khi onboarding tổ chức

App ID Lark phải có định dạng cli_xxxxxxxxxxxxxxxxxx. Kiểm tra lại trong Lark Developer Console → App Info → App ID.
App Secret không đúng, hoặc app chưa được publish. Xác nhận: (1) copy đúng App Secret không thừa khoảng trắng, (2) app đã có ít nhất một version được phê duyệt.

​
Khi quản lý subscription

Đã đạt giới hạn seat của gói hiện tại. Nâng cấp gói trong portal hoặc deactivate người dùng không dùng để giải phóng slot.
Không thể xoá tổ chức đang có subscription active. Hãy để subscription hết hạn hoặc liên hệ support để huỷ sớm, sau đó xoá tổ chức.

​
Khi lấy API key

API key chỉ hiển thị khi: (1) tài khoản đã được Admin activate, và (2) tài khoản đã link với người dùng Lark. Liên hệ Admin org để kiểm tra trạng thái tài khoản của bạn.
Thử đăng xuất và đăng nhập lại portal bằng magic link mới, sau đó thử regenerate lại. Nếu vẫn lỗi, liên hệ support.

​
Ghi log để debug

Với Claude Code, bật verbose mode để xem chi tiết lỗi: 
claude --verbose "Kiểm tra kết nối Lark Skill"

​
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ử.