도구 참조
권한별로 묶은 29개 MCP 도구 전체와, 각각 무엇을 하고 무엇을 요구하는지 정리했습니다.
도구는 29개이며, 각 도구를 열어 주는 권한별로 묶었습니다. 이 표는 무엇을 허용할지 정하는 데 쓰는 것입니다 — 매개변수는 어시스턴트가 직접 읽으므로 여기서 되풀이하지 않습니다.
무엇이든 허용하기 전에 권한 그룹을 먼저 읽어 보세요. 한 그룹의 쓰기 수준에는 언제나 삭제가 포함되고, 삭제는 연쇄적으로 번집니다.
목록을 돌려주는 모든 도구는 한 번에 한 페이지씩 — 기본 20개, 최대 100개 — 반환하므로, 큰 Notebase를 끝까지 훑으려면 여러 번 호출해야 합니다.
계정 정보
읽기 전용입니다. 이 그룹에는 쓰기 수준이 없습니다.
| 도구 | 하는 일 | 필요 권한 |
|---|---|---|
whoami | 이 연결이 어떤 Read Frog 계정으로 인가되었는지 알려 줍니다. 이메일 주소는 연결이 이메일 권한도 가진 경우에만 포함됩니다. | account 읽기 |
노트베이스 및 필드
| 도구 | 하는 일 | 필요 권한 |
|---|---|---|
list_notebases | 내가 가진 Notebase를 나열합니다. | notebases 읽기 |
get_notebase_schema | Notebase 하나의 이름과 필드 정의를 읽습니다. 노트를 쓸 때 키로 쓰이는 필드 ID도 포함됩니다. 노트 내용은 돌려주지 않습니다. | notebases 읽기 |
create_notebase | 빈 Notebase를 만들며, 원하면 첫 필드까지 함께 만듭니다. 노트는 따로 추가합니다. | notebases 쓰기 |
rename_notebase | Notebase의 이름을 바꾸며 학습 설정은 건드리지 않습니다. | notebases 쓰기 |
delete_notebase | Notebase를 영구히 삭제합니다. 그 필드, 노트, 템플릿, 카드, 복습 기록까지 함께 삭제됩니다. | notebases 쓰기 |
create_notebase_field | Notebase에 필드를 추가하고 그 ID를 돌려줍니다. | notebases 쓰기 |
update_notebase_field | 필드의 이름을 바꾸거나 설정을 변경합니다. 유형은 바꿀 수 없습니다. 선택 옵션을 없애면 모든 노트에서 그 값이 지워집니다. | notebases 쓰기 |
delete_notebase_field | 필드를 삭제하고 모든 노트에서 그 값을 제거합니다. 주 필드와 템플릿이 참조하는 필드는 삭제할 수 없습니다. | notebases 쓰기 |
노트 내용
| 도구 | 하는 일 | 필요 권한 |
|---|---|---|
list_notes | 노트를 훑어보거나 Notebase 하나 안에서 검색합니다. 검색은 두 글자 이상의, 대소문자를 구분하지 않는 그대로의 부분 문자열이며 텍스트 필드만 일치합니다. | notes 읽기 |
get_note | 노트 하나의 필드 값과, 이후 수정을 보호하는 데 쓰이는 타임스탬프를 읽습니다. | notes 읽기 |
create_notes | 한 Notebase에 1–50개 노트를 한 번에, 원자적으로 만듭니다. 기존 템플릿이 곧바로 카드로 바꿉니다. | notes 쓰기 |
update_note | 새 값을 노트에 병합하며 언급하지 않은 필드는 유지하고, null은 값을 지웁니다. 읽은 뒤 노트가 바뀌었다면 덮어쓰지 않고 실패합니다. | notes 쓰기 |
delete_note | 노트를 영구히 삭제합니다. 그 노트로 생성된 카드와 카드의 복습 기록까지 함께 삭제됩니다. | notes 쓰기 |
카드 템플릿
| 도구 | 하는 일 | 필요 권한 |
|---|---|---|
list_card_templates | 내 카드 템플릿을 나열하며, Notebase 하나로 한정할 수도 있습니다. | card_templates 읽기 |
get_card_template | 템플릿 하나의 전체 정의와, 이후 수정을 보호하는 데 쓰이는 타임스탬프를 읽습니다. | card_templates 읽기 |
create_card_template | 기존 필드 ID로 템플릿을 만듭니다. 이때 Notebase에 이미 있는 모든 노트에 대해 카드가 생성됩니다. | card_templates 쓰기 |
update_card_template | 템플릿의 이름이나 정의를 바꿉니다. 렌더링되는 카드는 저장된 템플릿을 따릅니다. | card_templates 쓰기 |
delete_card_template | 템플릿을 영구히 삭제합니다. 그 템플릿이 생성한 카드와 복습 기록까지 함께 삭제됩니다. 원본 노트는 남습니다. | card_templates 쓰기 |
렌더링된 카드
카드는 노트 내용에 일정 상태를 더한 것이므로, 이 두 도구는 두 가지 읽기 권한을 동시에 요구합니다.
| 도구 | 하는 일 | 필요 권한 |
|---|---|---|
list_cards | 렌더링된 앞면과 뒷면, 출처 ID, 학습 상태와 함께 카드를 훑어봅니다. Notebase, 템플릿, 복습 일정 상태로 걸러낼 수 있습니다. | notes 읽기 + study 읽기 |
get_card | 카드 하나를 같은 방식으로 읽습니다. | notes 읽기 + study 읽기 |
복습 및 학습 기록
| 도구 | 하는 일 | 필요 권한 |
|---|---|---|
get_study_stats | 주어진 시간대를 기준으로 Notebase별 학습 대기열 수를 읽습니다. 노트 내용이나 카드 앞뒷면은 돌려주지 않습니다. | study 읽기 |
get_study_settings | Notebase 하나의 일일 새 카드 한도, 일일 복습 카드 한도, 목표 기억 유지율을 읽습니다. 이름도 내용도 돌려주지 않습니다. | study 읽기 |
list_review_history | 내 복습 기록을 읽으며, Notebase나 카드로 걸러낼 수 있습니다. 노트 내용과 카드 앞뒷면은 제외됩니다. | study 읽기 |
update_study_settings | 그 세 가지 설정 — 일일 새 카드 한도, 일일 복습 카드 한도, 목표 기억 유지율 — 만 변경합니다. | study 쓰기 |
record_review | 카드 하나에 대한 평가를 제출합니다. FSRS가 이를 실제 복습으로 다뤄 카드의 기억 안정성, 난이도, 예정일을 갱신합니다. 그 복습이 어느 학습 일에 속하는지 정해야 하므로 시간대가 필요합니다. | study 쓰기 |
undo_review | 카드 하나의 가장 최근 유효 복습을 되돌려 그 이전의 일정을 복원합니다. 그 복습의 ID가 필요하므로 재시도가 더 이전의 복습을 되돌리는 일은 없습니다. | study 쓰기 |
set_card_suspended | 카드를 영구 중지해 다시 되돌릴 때까지 학습에서 빼거나, 다시 되돌립니다. | study 쓰기 |
set_card_buried | 카드를 오늘 건너뛰기로 처리해 그 학습 일의 남은 시간 동안 숨기거나, 다시 되돌립니다. | study 쓰기 |
다음으로 볼 것
- 활용 예시 — 이 도구들을 무엇으로 조합하면 좋은지.
- AI 어시스턴트 연결하기 — 권한을 허용하고, 낮추고, 취소하기.