OAuth và quyền

~2 phút đọc

Client MCP không nhận khoá API từ bạn. Nó đăng nhập bằng OAuth 2.1 trong trình duyệt, và bạn quyết định tại màn hình đồng ý công ty nào và chế độ nào được cấp. Mọi lời gọi công cụ sau đó chạy với đúng quyền ấy và không hơn.

Màn hình đồng ý

Ở lần kết nối đầu tiên, client mở trình duyệt tới Dòng Tiền Pro. Bạn đăng nhập (nếu chưa), rồi chọn:

Lựa chọn	Ý nghĩa
Công ty	Một hoặc nhiều công ty trợ lý được thấy. Công ty không chọn thì không có trong kết quả.
Chế độ Đọc	Trợ lý chỉ nhận các công cụ đọc.
Chế độ Đọc và đề xuất	Thêm các công cụ đề xuất. Đề xuất chỉ tạo bản ghi chờ duyệt; xem Bảo mật MCP.

Quyết định này được lưu thành một quyền cấp (grant) gắn với tài khoản của bạn. Quyền cấp xuất hiện trong danh sách Phiên đã kết nối ở mục MCP cho AI của trang Nhà phát triển.

Cách client đăng nhập

Máy chủ công bố metadata tài nguyên được bảo vệ theo RFC 9728. Khi client gọi mà chưa có token, máy chủ trả 401 kèm header WWW-Authenticate: Bearer resource_metadata=… để client tìm máy chủ xác thực. Client đăng ký với máy chủ xác thực (đăng ký client động hoặc metadata tài liệu client), dùng luồng mã uỷ quyền có PKCE rồi nhận token truy cập. Token chỉ dùng được cho https://mcp.dongtien.pro/mcp; máy chủ MCP không bao giờ chuyển token của bạn lên API phía sau mà dùng một thông tin xác thực nội bộ có thời hạn ngắn.

Máy chủ cũng kiểm tra nguồn gốc (Origin) của yêu cầu từ trình duyệt theo một danh sách cho phép.

Khoá API cho client không hỗ trợ OAuth

Nếu client của bạn không làm được OAuth, gửi khoá API có scope mcp:read trong header Authorization: Bearer $DT_API_KEY tới cùng địa chỉ. Khoá dt_test_… chỉ thấy dữ liệu thử. Hãy ưu tiên OAuth khi có thể vì quyền cấp qua OAuth hiện rõ trong danh sách phiên và thu hồi được từng phiên.

Thu hồi

Thu hồi một phiên trong danh sách Phiên đã kết nối. Lời gọi tiếp theo của client đó nhận 401 trong vòng khoảng 5 giây. Thu hồi quyền cấp không xoá những gì đã được đề xuất trước đó: các đề xuất đang chờ duyệt vẫn nằm trong ứng dụng để người duyệt xử lý.

Giới hạn

Mỗi phiên MCP bị giới hạn 300 lời gọi mỗi phút. Xem Giới hạn tốc độ.

Quyền cần có cho từng công cụ nằm ở trang của công cụ đó trong danh sách công cụ MCP.