MCP 툴

memex가 Model Context Protocol을 통해 Claude에 제공하는 도구들.

memex를 Claude에 연결하면, Claude는 8개의 도구에 접근할 수 있습니다. 이 도구들은 자동으로 사용됩니다 — 별도로 요청할 필요가 없습니다.

도구 목록

도구설명
save_note노트 저장. 의미적으로 유사한 노트가 이미 있으면 경고를 표시합니다.
search_notes필터 옵션이 있는 하이브리드 시맨틱 검색.
list_notes최근 노트를 생성일 순으로 나열합니다.
list_tags노트 수가 포함된 전체 태그 목록.
list_folders노트 수가 포함된 전체 폴더 목록.
get_noteID로 노트 전체 내용 + 백링크 조회.
update_note기존 노트의 제목, 내용, 태그를 수정합니다.
delete_noteID로 노트를 삭제합니다.

search_notes 파라미터

파라미터타입설명
querystring검색 쿼리 (자연어)
limitnumber최대 결과 수 (기본값 10)
categorystring특정 폴더로 필터링
tagstring태그로 필터링
date_fromstringISO 8601 날짜 — 해당 날짜 이후 노트만
date_tostringISO 8601 날짜 — 해당 날짜 이전 노트만

예시: "지난 4월에 auth에 대해 어떤 결정을 했었지?" → Claude가 query="auth decision", date_from="2025-04-01", date_to="2025-04-30"으로 search_notes를 호출합니다.

save_note 동작 방식

저장 전에 Claude는 다음을 수행하도록 지시받습니다:

  1. list_tagslist_folders를 호출해 기존 분류 체계 확인
  2. 새로운 태그/폴더를 만들지 않고 기존 것 중에서 선택
  3. 사람, 프로젝트, 개념에 대한 참조는 [[Title]] 위키링크 문법 사용

save_note가 ⚠️ 유사 노트 경고를 반환하면, Claude는 새 노트를 만들지 않고 가장 관련 있는 기존 노트에 update_note를 사용합니다.

get_note + 백링크

get_note는 노트 전체 내용과 함께 "Referenced by" 섹션을 반환합니다. 이 섹션에는 [[Title]] 문법으로 이 노트를 참조하는 모든 노트가 나열됩니다. 백링크는 저장/수정 시점에 해석됩니다.

Claude의 자동 동작

Claude는 다음을 수행하도록 설정되어 있습니다:

  • 항상 검색 먼저 — 과거 대화, 결정, 프로젝트와 관련될 수 있는 질문에는 반드시 먼저 검색
  • 대화 종료 시 저장 — 기술적 결정이 이루어졌거나, 중요한 인사이트가 생겼거나, "기억해"라고 말했을 때
  • 저장보다 수정 선호 — 새 내용이 기존 노트에 속할 때는 새로 만들지 않고 수정