Ggomggomhan – Planner & Notes

책장 디바이더(탭) 지도를 반환합니다. 각 탭의 의도(intent), 섹션(번호·이름·의도), 항목(dewey·제목·pid·태그)을 트리 구조로 제공. AI 추론용 좌표계 스냅샷입니다. team_id 지정 시 해당 팀의 디바이더, 생략 시 개인 책장.

get_divider_map

내 프로젝트에 사용된 모든 태그(라벨) 목록을 반환합니다. 각 태그별 사용 개수 포함. 빈도 내림차순 정렬. 개인 모드는 미분류 + MCP 공유된 폴더의 프로젝트를, 팀 모드는 MCP 공유된 팀 폴더의 프로젝트를 집계합니다.

list_tags

특정 태그(라벨)를 가진 프로젝트 목록을 조회합니다. 속지 ID + 제목 + 속지 종류 + 태그를 반환. 여러 태그는 AND/OR로 조합 가능.

list_projects_by_tag

한 프로젝트가 속한 **실타래 전체**를 반환합니다. 그 속지에 직접 걸린 관계만이 아니라, 관계를 타고 N다리 건너까지 따라갑니다 — 1이 2를 참고하고 2가 3과 이어져 있으면, 1을 넣었을 때 2를 거쳐 3까지 함께 나옵니다. 각 노드에는 시드에서 몇 다리인지(distance)가 붙습니다. 순회는 방향을 가리지 않지만(정·역방향 모두 타고 감) 표시는 from/to를 그대로 보존합니다. get_project로 속지 한 장을 열기 전에 이 도구로 맥락을 먼저 잡으면 전체 그림을 놓치지 않습니다.

get_context_thread

맥락(관계) 레이어만 따로 봅니다. 전체 프로젝트 목록이 아니라 **실이 걸린 것만**, 그리고 **서로 연결된 것끼리 묶어서** 반환합니다. 묶음(component) 하나가 하나의 실타래 — A가 B를 참고하고 B가 C와 이어져 있으면 A·B·C가 한 묶음으로 나옵니다. "내 프로젝트들이 어떻게 얽혀 있어?", "맥락이 잡힌 것만 보여줘" 같은 질문의 진입점. 각 엣지에는 사람이 읽을 수 있는 sentence(예: "지출계획"은 "여행계획표"을 정산한다)가 함께 옵니다. 특정 프로젝트에서 출발해 실을 따라가려면 get_context_thread를 쓰세요.

get_context_map

메모(GgMD)로 새 속지를 만듭니다. template=checklist: 체크 항목·목록·표의 행 → 작업, 제목 → 목록 이름. template=docguide: 제목 → 섹션(깊이=제목 단계), 문단 → 텍스트, 체크 → 체크리스트, 번호 목록 → 플로우차트, 표 → 표. section 을 주면 그 섹션만으로 만듭니다. 만들어진 속지는 원본 메모와 "에서 만들어졌다" 맥락으로 이어집니다.

convert_memo_to_project

MCP 공유된 나의서재 폴더의 메모 목록을 조회합니다(메모는 속지와 같은 폴더에 삽니다). 각 메모의 address(주소)·제목·미리보기·섹션 목록·듀이·그룹·태그·버전을 돌려줍니다. folder_id(옛 이름 diary_id) 를 지정하면 그 폴더만, 생략하면 공유된 모든 폴더. 응답의 folders 에 폴더 이름이 있습니다(list_personal_folders 와 같은 ID). 메모 원문은 get_memo(id: address) 로 — GgMD(마크다운) 형식입니다. 범위는 MCP 공유가 켜진 폴더 + 미분류(폴더 미배정) 메모입니다 — folder_id: -1 이면 미분류만 봅니다.

list_memos

MCP 공유된 기록장에 새 메모를 만듭니다. content 는 GgMD(마크다운): 제목(#~###)·목록·체크(- [ ])·표(GFM)·인용(>)·굵게·[[수첩:PID|제목]]/[[메모:PID|제목]]/[[제목]] 내부링크. 코드 블록(```)은 인용으로 바뀌고 HTML 은 글자로 저장됩니다. 본문에 `## 맥락` 섹션을 두고 `- [[수첩:PID|제목]] 의 준비물 목록이다` 처럼 쓰면 저장 시 관계(실)로 동기화되고 본문에서는 빠집니다. [[제목]] 만 써도 같은 제목의 메모/속지를 찾아 정식 링크로 바꿉니다. folder_id(옛 diary_id) 를 주려면 그 나의서재 폴더의 MCP 공유가 켜져 있어야 하고(비밀 E2EE 폴더는 불가), 생략하면 미분류로 만들어집니다.

create_memo_mcp

메모를 수정합니다. 본문을 바꾸는 세 방법 — (1) content: 전체 GgMD 원문 교체, (2) section + content: 그 섹션(제목 줄 포함 가능)만 교체, (3) append: 끝에 붙이기. 본문 변경에는 **base_version 필수**(get_memo 머리의 vN). 서버 버전이 더 높으면 VERSION_CONFLICT — get_memo 로 다시 읽고 병합하세요. `## 맥락` 섹션이 있으면 그 목록이 이 메모가 만든 관계(정방향)의 진실이 됩니다(추가·삭제 동기화). title/color/dewey_code/position/tags 는 base_version 없이도 됩니다.

update_memo_mcp

메모 원문을 **GgMD(마크다운)** 문서로 돌려줍니다. 머리(`> 주소 · 폴더 · 그룹 · 듀이 · 태그` / `> 수정 · vN · 섹션 […]`) + 본문 + 꼬리(`## 맥락` — 이 메모가 걸린 관계와 받은 맥락). GgMD 문법: 제목(#~###)·문단(한 줄 개행=줄바꿈)·목록(- / 1.)·체크(- [ ] / - [x])·표(GFM)·인용(>)·굵게·링크·이미지()·내부링크 [[수첩:PID|제목]] [[메모:PID|제목]]. 코드 블록·HTML 은 없습니다. id 에 "PID/sec:슬러그" 를 주거나 section 을 지정하면 그 섹션만 옵니다(긴 메모는 섹션 단위로 읽으세요). format:"json" 이면 {meta, md, blocks(표=행 배열), relations}. 수정할 땐 머리의 vN 을 update_memo_mcp 의 base_version 으로 넘기세요.

get_memo

한 placement를 다른 섹션으로 이동합니다. from 섹션의 placement 1개를 제거하고 to 섹션에 자동 dewey 채번으로 추가. from에 다수 매치면 첫 항목만 이동. team_id 지정 시 팀 디바이더(editor 이상), 생략 시 개인 책장.

move_placement

비어있는 탭(섹션 정의도 항목 배치도 없는 탭) 중 가장 작은 ID를 반환. 모든 탭이 점유돼 있으면 null. 탭이 0개면 create_tab 으로 먼저 생성해야 함. 부가 정보로 전체 탭 상태 요약 동봉. team_id 지정 시 팀 디바이더, 생략 시 개인 책장.

find_empty_tab

가이드·매뉴얼(docguide) 속지의 **섹션 한 건만** 수정합니다. 보낸 필드만 바뀌고 나머지(다른 섹션·계층·순서·도해)는 그대로 둡니다(전량 교체인 update_project 와 다릅니다). 본문(lines/steps/columns/rows)은 통째 교체이니 항목을 덧붙일 때는 get_section 으로 읽은 본문에 합쳐서 보내세요. get_section 으로 현재 값과 base_version 을 먼저 확인하세요. 섹션 추가·삭제·이동·부모 변경은 update_project 의 몫이고, 이미지메모(type 4) 도해는 save_image_memo 로 다룹니다. v7.17.2896+.

update_section

가이드·매뉴얼(docguide) 속지에서 **섹션 한 건만** 조회합니다. 문서 전체를 읽지 않아 토큰을 아낍니다(get_project 대신). 주소는 화면의 '섹션 편집' 모달 제목 옆 배지에 그대로 적혀 있습니다 — 사용자가 "nlRJD5MT44/3" 같은 문자열을 주면 section 에 그대로 넣으세요. 번호(1-2 식 트리 번호)·부모/자식/관련 섹션 제목·본문(lines/steps/columns/rows)을 풀어서 돌려주므로 이 응답만으로 섹션을 이해하고 update_section 으로 고칠 수 있습니다. 여러 섹션을 훑거나 섹션을 추가/삭제/이동해야 하면 get_project/update_project 를 쓰세요. v7.17.2896+. url 은 꼼꼼한 속지 주소(https://ggomggomhan.com/…?pid=…)만 받으며 다른 사이트는 호출하지 않습니다. 꼼꼼한 MCP 도구 문서: https://ggomggomhan.com/en/mcp-info/

get_section

빈 섹션을 명시적으로 생성합니다. 항목 배치(place_in_section) 전에 골격을 먼저 짤 때 사용. name/intent를 함께 설정 가능. 동일 섹션 번호가 이미 정의돼 있으면 거부. 자동 섹션(항목만 있고 정의 없음)은 정의로 승격. team_id 지정 시 팀 디바이더(editor 이상), 생략 시 개인 책장. ⚠️ 섹션 번호는 반드시 "{탭 badge}.{순번}" 2단계 형식 — 탭 badge가 "1"이면 첫 섹션은 1.1, 다음은 1.2. 맨 탭번호("1")만 쓰면 거부됨. 탭 badge는 create_tab/get_divider_map 응답에서 확인.

create_section

섹션의 의도(intent)를 설정합니다. 자동 섹션이면 정의로 승격되며 의도가 기록됨. 최대 200자. team_id 지정 시 팀 디바이더(editor 이상), 생략 시 개인 책장.

set_section_intent

섹션의 표시 이름(name)을 설정합니다. 자동 섹션이면 정의로 승격됨. 최대 40자. 섹션 번호 자체는 변경하지 않음(번호 변경은 별도). team_id 지정 시 팀 디바이더(editor 이상), 생략 시 개인 책장.

set_section_name

프로젝트(개인 책장은 메모도 가능)를 특정 탭/섹션에 배치합니다. 이미 같은 섹션에 있으면 위치만 갱신. 다른 섹션에 있으면 그쪽 placement는 유지(N:M)되며 이 섹션에도 추가. 새 dewey 는 자동 채번. team_id 지정 시 팀 디바이더(editor 이상 권한 필요, 속지만), 생략 시 개인 책장.

place_in_section

특정 섹션에 배치된 항목을 제거합니다. 다른 섹션의 placement(N:M)는 유지. 자식 항목(예: 21.1.2 아래의 21.1.2.1)은 함께 제거되지 않음(상위만). 섹션 prefix가 일치하는 모든 placement를 제거하려면 별도 호출. team_id 지정 시 팀 디바이더(editor 이상), 생략 시 개인 책장.

remove_from_section

꼼꼼한에서 사용 가능한 속지 종류를 조회합니다. 2단계로 사용하세요: (1) 인수 없이 호출하면 속지 이름·설명·키워드 목록을 반환합니다 (디스커버리). (2) `template: "<타입>"` 인수로 호출하면 해당 속지의 data 스키마와 형식별 예시를 반환합니다. create_project 호출 전에 (2)단계로 정확한 스키마를 받은 뒤 데이터를 구성하세요.

list_templates

새 수첩을 만듭니다. 만든 뒤 add_journal_source(달력·지도에 담기) · add_journal_widget(오른쪽 위젯) 로 채우고 arrange_journal_board 로 놓습니다.

create_journal_board

꼼꼼한 수첩(/journal)에 있는 수첩(판) 목록입니다. 판마다 담긴 속지 수·위젯 수·가운데 판 종류를 돌려줍니다. 자세히 보려면 get_journal_board.

list_journal_boards

판의 블럭을 놓습니다. **좌표 대신 자리말**로 말하면 서버가 바둑판 좌표를 셈합니다 — 자리: left(왼쪽 좁은 줄) · center(가운데 넓은 판) · right(오른쪽 위젯 줄). x·y 좌표는 서버가 셈합니다. 크기: small · medium · large · xlarge (세로 높이). 생략하면 블럭 종류의 기본 크기. items 에 준 차례대로 그 자리에 위에서 아래로 쌓입니다. **적지 않은 블럭은 옛 자리를 그대로 둡니다**(말 안 한 것을 지우지 않습니다). 쓸 수 있는 키: today · todo · cal · map · places(기본 블럭) 와 위젯(get_journal_board 의 key, 또는 id+view 로 지정). hidden:true 로 기본 블럭을 끌 수 있습니다(자리는 남습니다. 「오늘」은 끌 수 없습니다).

arrange_journal_board

수첩의 이름·색·가운데 판·좌우명·루틴 보기를 고칩니다. 준 것만 바뀝니다.

update_journal_board

수첩 한 권을 통째로 읽습니다. 담긴 속지의 **id·유형·제목**, 각 위젯이 **지금 보여 주는 뷰(view)와 고를 수 있는 뷰 목록(views)**, 배치(slot·size·order)를 함께 줍니다. 수첩을 꾸미려면 여기서 시작하세요 — 속지 내용까지 한 번에 읽으려면 get_journal_board_data 입니다.

get_journal_board

수첩을 지웁니다. **담겼던 속지·메모는 그대로 남습니다**(판은 「어떻게 모아 볼지」일 뿐입니다).

delete_journal_board

그 판에 담긴 속지들의 **내용**을 한 번에 읽습니다(get_project 와 같은 변환기를 거친 readable). 속지별로 수첩을 꾸밀 때 씁니다. 필드 뜻은 list_templates(template: 유형) 를, 내용을 고칠 땐 update_project 를 쓰세요.

get_journal_board_data

수첩에서 하듯 담긴 속지의 일정을 체크합니다(각 속지의 제 저장 자리에 적습니다). 어느 일정인지는 유형마다 다릅니다 — 스케줄러=sid(일정 id)+date · 가족달력=idx(일정 순번)+date · 디데이 스케줄러/여행계획표=idx · 학습플래너=key(그날 plans 의 항목 키, 예 td_1 또는 td_1#2)+date. 일기장은 체크가 없습니다. state: 2 완료 · 1 진행 · 0 해제.

check_journal_item

여행계획표(travelplaner)에 첨부된 사진들의 단명 다운로드 URL을 일정(레코드)별로 반환합니다. URL은 1회용·10분 만료이며 공유 설정과 무관합니다. 용도: 사진 내용을 보고 일정별 메모를 작성·보강할 때(download_url 로 사진을 받을 수 있습니다). 받은 후에는 get_project의 텍스트만으로 작업하세요(사진 재조회 불필요). travelplaner 타입에만 동작합니다. url 은 꼼꼼한 속지 주소(https://ggomggomhan.com/…?pid=…)만 받으며 다른 사이트는 호출하지 않습니다. 꼼꼼한 MCP 도구 문서: https://ggomggomhan.com/en/mcp-info/

get_trip_image_refs

오늘(또는 특정 날짜)의 할일을 모아 시각순으로 돌려줍니다. page_ids 를 생략하면 꼼꼼한 수첩에서 「일정 모아보기」로 담은 속지 전체(모든 수첩, 달력에서 숨긴 속지와 일기장 제외)와 위젯으로 올린 프로젝트 관리 속지를 읽습니다. 완료한 항목은 「완료된 항목」으로 따로 나옵니다. 스케줄러·가족달력·디데이 스케줄러·여행계획표·학습플래너·프로젝트 관리·지출계획표·회의록·체크리스트를 읽을 수 있습니다.

get_today_tasks

속지(또는 메모) 한 장을 오른쪽 위젯으로 담습니다. 위젯은 그 속지의 화면 한 블럭을 그대로 띄우는 것이라, 어떤 블럭을 띄울지 view 로 고릅니다. 고를 수 있는 view 는 유형마다 다릅니다(get_journal_board 의 views, 또는 담은 뒤 응답의 views). 같은 속지를 뷰만 달리해 여러 장 담을 수도 있습니다.

add_journal_widget

오른쪽 위젯에서 뺍니다. view 를 주면 그 뷰의 위젯만, 안 주면 그 속지의 위젯을 모두 뺍니다. 속지 자체는 그대로 남습니다.

remove_journal_widget

이미 담은 위젯이 보여 주는 블럭(뷰)을 바꿉니다. 자리는 그대로 둡니다. 같은 속지를 여러 뷰로 담아 뒀다면 from 으로 바꿀 대상을 집으세요.

set_journal_widget_view

프로젝트 관리(project) 속지의 **작업 한 건만** 수정합니다. 보낸 필드만 바뀌고 나머지는 그대로 둡니다. 속지 전체를 읽지 않아도 되고, 다른 작업의 담당자·체크리스트 시각 같은 값이 부수적으로 지워지지 않습니다. get_task 로 현재 값과 base_version 을 먼저 확인하세요. 작업을 새로 만들거나 지우거나 카테고리를 옮기는 것은 update_project 의 몫입니다. v7.17.2867+.

update_task

프로젝트 관리(project) 속지에서 **작업 한 건만** 조회합니다. 속지 전체를 읽지 않아 토큰을 크게 아낍니다(작업 60건짜리 속지 기준 get_project 는 30KB 안팎, get_task 는 1KB 미만). 주소는 화면의 '작업 편집' 모달 제목 옆 배지에 그대로 적혀 있습니다 — 사용자가 "nlRJD5MT44/task_mtqkxh7b_7vw7u" 같은 문자열을 주면 task 에 그대로 넣으세요. 카테고리 이름·담당자 이름·선행작업 이름까지 풀어서 돌려주므로 이 응답만으로 작업을 이해하고 update_task 로 고칠 수 있습니다. 여러 작업을 훑어야 하거나 작업을 새로 추가/삭제해야 하면 get_project 를 쓰세요. v7.17.2867+. url 은 꼼꼼한 속지 주소(https://ggomggomhan.com/…?pid=…)만 받으며 다른 사이트는 호출하지 않습니다. 꼼꼼한 MCP 도구 문서: https://ggomggomhan.com/en/mcp-info/

get_task

책장에 새 디바이더(탭)를 생성합니다. 탭이 0개인 빈 책장에서 골격을 시작하는 진입점. divider_id·badge·color 는 자동 채번되며 응답에 새 divider_id 가 포함됩니다. team_id 지정 시 팀 디바이더(editor 이상 권한 필요), 생략 시 개인 책장.

create_tab

탭의 의도(intent)를 설정합니다. AI가 탭의 목적을 추론한 결과를 영구 기록할 때 사용. 최대 500자. team_id 지정 시 팀 디바이더(editor 이상), 생략 시 개인 책장.

set_tab_intent

탭의 표시 이름(name)을 변경합니다. 최대 30자. badge(이모지/2글자)는 건드리지 않음. team_id 지정 시 팀 디바이더(editor 이상), 생략 시 개인 책장.

set_tab_name

사용자가 속한 팀 목록을 조회합니다. MCP 공유 폴더가 있는 팀만 반환합니다.

list_teams

특정 팀의 MCP 공유 폴더 목록을 조회합니다.

list_team_folders