Kết nối trợ lý AI
Thêm máy chủ MCP vào ứng dụng AI của bạn, chọn những gì nó được truy cập trong năm nhóm quyền, và thu hồi khi bạn dùng xong.
Mở trang MCP trong ứng dụng web của Read Frog. Ở đó có địa chỉ máy chủ, các bước thiết lập cho từng ứng dụng, và mọi ứng dụng bạn đã cấp quyền.
Địa chỉ máy chủ thì giống nhau với mọi người:
https://api.readfrog.app/api/mcpKhác biệt giữa các ứng dụng chỉ là bạn dán địa chỉ đó vào đâu, và bản thân ứng dụng đòi hỏi điều kiện gì trước khi cho bạn làm việc đó.
Thêm máy chủ
Thêm một máy chủ MCP từ xa với địa chỉ ở trên, truyền qua Streamable HTTP. Trong ChatGPT, phần này nằm ở Cài đặt → Plugin sau khi bật chế độ nhà phát triển; trong Claude thì ở Cài đặt → Trình kết nối → Thêm trình kết nối tùy chỉnh. Codex và Claude Code mỗi bên chỉ cần một dòng lệnh, có sẵn trên trang MCP.
Chọn cách cấp quyền OAuth 2.1. Cả đăng ký ứng dụng động và tài liệu metadata của client ID đều
được hỗ trợ, nên bạn không phải nhập client ID hay secret nào. Ứng dụng nào bắt buộc phải có tài
liệu discovery thì đọc được nó ở
https://api.readfrog.app/.well-known/oauth-protected-resource/api/mcp.
Ứng dụng sẽ đưa bạn tới trang xác nhận quyền của Read Frog. Đăng nhập, đối chiếu tên và định danh ứng dụng hiện ở đó, chọn mức cho từng nhóm quyền mà nó yêu cầu, rồi bấm Cho phép.
Một số ứng dụng đặt trình kết nối tùy chỉnh sau gói trả phí của riêng họ. ChatGPT cần một gói trả phí; tài khoản Claude cá nhân cần Pro hoặc Max, còn với Team hay Enterprise thì chủ sở hữu phải thêm trình kết nối trong phần cài đặt tổ chức. Codex và Claude Code không có hạn chế này.
Yêu cầu từ phía Read Frog là gói Ultra. Một kết nối từ tài khoản không có gói này vẫn cấp quyền xong, nhưng sau đó mọi lệnh gọi công cụ đều bị từ chối kèm giải thích — đăng nhập lại cũng không thay đổi điều đó, vì không có việc cấp quyền nào làm thay đổi gói đăng ký.
Năm nhóm quyền
Có đúng năm nhóm. account chỉ có quyền đọc; bốn nhóm còn lại đều đặt được thành không truy cập, đọc, hoặc đọc và ghi. Bạn chọn theo từng nhóm, và chỉ trong những nhóm mà ứng dụng thực sự yêu cầu.
| Nhóm | Quyền đọc cho trợ lý thấy | Quyền ghi cho nó làm thêm |
|---|---|---|
account | Tên, địa chỉ email và ảnh đại diện của bạn. Không hề có nội dung ghi chú. | Không gì cả — nhóm này không có mức ghi. |
notebases | Các Notebase của bạn và định nghĩa trường của chúng, gồm cả ID trường. | Tạo, đổi tên và xóa Notebase; thêm, sửa và xóa trường. |
notes | Giá trị các trường của mọi ghi chú, và tìm kiếm trong đó. | Tạo, sửa và xóa ghi chú. |
card_templates | Bố cục mặt trước và mặt sau sinh ra thẻ. | Tạo, sửa và xóa mẫu thẻ. |
study | Lịch sử ôn tập, trạng thái lên lịch, số lượng trong hàng đợi và giới hạn hằng ngày. | Ghi nhận và hoàn tác lượt ôn tập, đổi giới hạn hằng ngày, đình chỉ và bỏ qua thẻ. |
Có hai công cụ nằm vắt qua hai nhóm. Để đọc một thẻ đã kết xuất — mặt trước, mặt sau, trạng thái học của nó — cần đồng thời notes:read và study:read, vì một thẻ là nội dung ghi chú cộng với trạng thái lên lịch. Chỉ cấp một trong hai thì list_cards và get_card đều không dùng được.
Quyền ghi có thể phá hủy những gì
Quyền ghi không chỉ là "thêm được thứ mới". Mức ghi của mọi nhóm đều bao gồm xóa, và xóa trong một Notebase thì lan theo chuỗi.
| Khi cấp | Trường hợp tệ nhất |
|---|---|
notes:write | Một ghi chú bị xóa vĩnh viễn, cùng với mọi thẻ sinh ra từ nó và bản ghi ôn tập của những thẻ đó. |
notebases:write | Cả một Notebase bị xóa vĩnh viễn — các trường, toàn bộ ghi chú, mẫu thẻ, thẻ và toàn bộ lịch sử ôn tập của nó. |
card_templates:write | Một mẫu thẻ bị xóa, kéo theo mọi thẻ nó đã sinh ra và bản ghi ôn tập của chúng. Ghi chú gốc vẫn còn. |
study:write | Một lượt ôn tập bạn chưa từng làm được ghi nhận. FSRS coi nó là thật, nên độ ổn định, độ khó và ngày đến hạn tiếp theo của thẻ đều thay đổi. |
Không việc nào trong số này hoàn tác được từ phía Read Frog. undo_review lùi lại lượt ôn tập gần nhất của một thẻ, nhưng ghi chú, trường, mẫu thẻ hay Notebase đã xóa thì không có cách nào hoàn tác.
Hãy cấp quyền đọc trước. Quyền chỉ đọc đã đủ để tra cứu, lên kế hoạch ôn tập và báo cáo tiến độ của bạn — và nó không thể làm mất gì. Chỉ nâng một nhóm lên quyền ghi khi bạn có một cách dùng cụ thể cần đến nó, và hãy đọc kỹ những gì trợ lý đề xuất trước khi chấp thuận một lần xóa.
Cấp thêm quyền về sau
Một lần cấp quyền chỉ chứa đúng những gì yêu cầu cấp quyền đó xin, ở mức bạn đã chọn khi ấy. Nếu một công cụ thất bại vì kết nối thiếu quyền, ứng dụng sẽ được cho biết nó thiếu quyền nào; nhiều ứng dụng tự đưa bạn trở lại trang xác nhận, còn một số phải kết nối lại bằng tay mới xin lần nữa.
Chiều ngược lại cũng được: cấp quyền lại và hạ mức một nhóm xuống. Trang xác nhận chỉ hạ được những nhóm mà yêu cầu mới có nhắc tới, nên nhóm nào ứng dụng không còn xin nữa thì vẫn giữ nguyên như cũ. Muốn xóa sạch một lần, hãy thu hồi kết nối.
Quản lý và thu hồi
Trang MCP liệt kê mọi ứng dụng đã kết nối, kèm tên nó đã đăng ký, định danh ứng dụng, thời điểm bạn kết nối, lần cấp quyền gần nhất, và những quyền nó đang giữ.
Thu hồi xóa quyền của ứng dụng đó và làm mất hiệu lực truy cập của nó ngay lập tức. Refresh token mất theo cùng với lần cấp quyền, nên lần tới khi nó thử kết nối lại, nó sẽ quay về trang xác nhận để bạn quyết định lần nữa. Sau này bạn vẫn kết nối lại được chính ứng dụng đó; lần cấp quyền mới bắt đầu từ con số không.
Thu hồi không có tác dụng hồi tố. Nội dung mà một dịch vụ đã nhận thì vẫn nằm ở dịch vụ đó — xem Chính sách quyền riêng tư để biết Read Frog xử lý dữ liệu thế nào. Xóa trình kết nối trong chính trợ lý cũng là việc nên làm, nhưng riêng nó thì không thu hồi quyền ở phía Read Frog.
Khi có gì đó không chạy
- Một công cụ báo là nó cần thêm quyền. Hãy cấp quyền cho nhóm đó, hoặc cứ để từ chối và chỉ dùng những thao tác bạn đã cho phép. Nếu ứng dụng không tự xin lại, hãy kết nối lại.
- Kết nối được hết nhưng mọi công cụ đều từ chối kèm thông báo về gói. Tài khoản không ở gói Ultra.
- Công cụ mới không hiện ra. Làm mới hoặc kết nối lại trình kết nối; các ứng dụng có lưu đệm danh sách công cụ.
- Một lần ghi thất bại với thông báo ghi chú đã thay đổi. Việc sửa được bảo vệ trước dữ liệu cũ. Hãy yêu cầu trợ lý đọc lại ghi chú rồi thử lại.
- Ghi nhận lượt ôn tập thất bại vì đòi múi giờ. Ghi nhận một lượt ôn tập phải xác định nó thuộc ngày học nào, nên nó không đoán. Hãy cho trợ lý biết múi giờ IANA của bạn, hoặc đăng nhập rồi mở ứng dụng web Read Frog một lần để tài khoản lưu lại múi giờ.
Nếu vẫn bế tắc, hãy liên hệ với chúng tôi.