Tham chiếu công cụ
Toàn bộ 29 công cụ MCP nhóm theo quyền, kèm việc từng công cụ làm và điều nó cần.
Hai mươi chín công cụ, nhóm theo quyền mở khóa chúng. Bảng này để bạn quyết định nên cấp gì — tham số thì trợ lý tự đọc, nên ở đây không nhắc lại.
Hãy đọc các nhóm quyền trước khi cấp bất cứ quyền nào: mức ghi của một nhóm luôn bao gồm xóa, và xóa thì lan theo chuỗi.
Mọi công cụ liệt kê đều trả về mỗi lần một trang — mặc định 20 mục, nhiều nhất 100 — nên đi hết một Notebase lớn cần vài lệnh gọi.
Thông tin tài khoản
Chỉ có quyền đọc. Nhóm này không có mức ghi.
| Công cụ | Làm gì | Cần |
|---|---|---|
whoami | Cho biết kết nối này được cấp quyền dưới tài khoản Read Frog nào. Địa chỉ email chỉ có khi kết nối cũng giữ quyền về email. | account đọc |
Notebase và trường
| Công cụ | Làm gì | Cần |
|---|---|---|
list_notebases | Liệt kê các Notebase bạn sở hữu. | notebases đọc |
get_notebase_schema | Đọc tên và định nghĩa trường của một Notebase, gồm cả những ID trường được dùng làm khóa khi viết ghi chú. Không trả về nội dung ghi chú. | notebases đọc |
create_notebase | Tạo một Notebase rỗng, kèm các trường ban đầu nếu muốn. Ghi chú được thêm riêng. | notebases ghi |
rename_notebase | Đổi tên một Notebase, không đụng tới thiết lập học tập của nó. | notebases ghi |
delete_notebase | Xóa vĩnh viễn một Notebase cùng với các trường, ghi chú, mẫu thẻ, thẻ và bản ghi ôn tập của nó. | notebases ghi |
create_notebase_field | Thêm một trường vào Notebase và trả về ID của nó. | notebases ghi |
update_notebase_field | Đổi tên một trường hoặc sửa cấu hình của nó; kiểu thì không đổi được. Bỏ một lựa chọn khỏi danh sách chọn sẽ xóa giá trị đó khỏi mọi ghi chú. | notebases ghi |
delete_notebase_field | Xóa một trường và xóa giá trị của nó khỏi mọi ghi chú. Trường chính, và trường mà một mẫu thẻ tham chiếu tới, thì không xóa được. | notebases ghi |
Nội dung ghi chú
| Công cụ | Làm gì | Cần |
|---|---|---|
list_notes | Duyệt ghi chú, hoặc tìm kiếm trong một Notebase. Tìm kiếm là chuỗi con theo đúng mặt chữ, không phân biệt hoa thường, từ hai ký tự trở lên, và chỉ khớp các trường văn bản. | notes đọc |
get_note | Đọc giá trị các trường của một ghi chú, kèm dấu thời gian dùng để bảo vệ những lần sửa sau. | notes đọc |
create_notes | Tạo 1–50 ghi chú một lúc trong cùng một Notebase, trọn lô hoặc không gì cả. Mẫu thẻ sẵn có sẽ biến chúng thành thẻ ngay. | notes ghi |
update_note | Hợp nhất các giá trị mới vào một ghi chú, giữ nguyên những trường không được nhắc tới; null xóa trắng một trường. Nếu ghi chú đã thay đổi sau khi được đọc thì thất bại chứ không ghi đè. | notes ghi |
delete_note | Xóa vĩnh viễn một ghi chú cùng những thẻ sinh ra từ nó và bản ghi ôn tập của chúng. | notes ghi |
Mẫu thẻ
| Công cụ | Làm gì | Cần |
|---|---|---|
list_card_templates | Liệt kê các mẫu thẻ của bạn, có thể giới hạn trong một Notebase. | card_templates đọc |
get_card_template | Đọc toàn bộ định nghĩa của một mẫu thẻ, kèm dấu thời gian dùng để bảo vệ những lần sửa sau. | card_templates đọc |
create_card_template | Tạo một mẫu thẻ từ các ID trường có sẵn. Việc này sinh thẻ cho mọi ghi chú đã có trong Notebase. | card_templates ghi |
update_card_template | Đổi tên hoặc định nghĩa của một mẫu thẻ. Thẻ được kết xuất theo mẫu thẻ đã lưu. | card_templates ghi |
delete_card_template | Xóa vĩnh viễn một mẫu thẻ cùng những thẻ nó đã sinh ra và bản ghi ôn tập của chúng. Ghi chú gốc vẫn còn. | card_templates ghi |
Thẻ đã kết xuất
Một thẻ là nội dung ghi chú kết hợp với trạng thái lên lịch, nên cả hai công cụ này đều cần đồng thời hai quyền đọc.
| Công cụ | Làm gì | Cần |
|---|---|---|
list_cards | Duyệt thẻ cùng mặt trước và mặt sau đã kết xuất, ID nguồn và trạng thái học. Lọc được theo Notebase, mẫu thẻ hoặc trạng thái lịch. | notes đọc + study đọc |
get_card | Đọc một thẻ theo đúng cách đó. | notes đọc + study đọc |
Ôn tập và lịch sử học tập
| Công cụ | Làm gì | Cần |
|---|---|---|
get_study_stats | Đọc số lượng trong hàng đợi học của từng Notebase theo một múi giờ cho trước. Không trả về nội dung ghi chú hay hai mặt thẻ. | study đọc |
get_study_settings | Đọc giới hạn thẻ mới mỗi ngày, giới hạn thẻ ôn tập mỗi ngày và tỷ lệ ghi nhớ mong muốn của một Notebase. Không trả về tên cũng không trả về nội dung của nó. | study đọc |
list_review_history | Đọc các bản ghi ôn tập của bạn, lọc được theo Notebase hoặc theo thẻ. Không gồm nội dung ghi chú và hai mặt thẻ. | study đọc |
update_study_settings | Chỉ sửa đúng ba thiết lập đó — giới hạn thẻ mới mỗi ngày, giới hạn thẻ ôn tập mỗi ngày, tỷ lệ ghi nhớ mong muốn. | study ghi |
record_review | Gửi một đánh giá cho một thẻ. FSRS coi đó là một lượt ôn tập thật và cập nhật độ ổn định, độ khó và ngày đến hạn của thẻ. Cần múi giờ, vì nó quyết định lượt ôn tập thuộc ngày học nào. | study ghi |
undo_review | Hoàn tác lượt ôn tập hợp lệ gần nhất của một thẻ, khôi phục lịch nó có trước đó. Cần ID của lượt ôn tập ấy, nên một lần thử lại không thể hoàn tác một lượt cũ hơn. | study ghi |
set_card_suspended | Đình chỉ một thẻ, đưa nó ra khỏi việc học cho tới khi được phục hồi, hoặc phục hồi nó. | study ghi |
set_card_buried | Bỏ qua một thẻ, ẩn nó cho tới hết ngày học, hoặc hủy bỏ qua. | study ghi |
Đi tiếp từ đây
- Cách dùng thường gặp — những việc đáng ghép các công cụ này lại để làm.
- Kết nối trợ lý AI — cấp, hạ mức và thu hồi quyền.