메모와 코멘트 도구

한 줄로: 외부 AI 도구가 메모를 읽고 쓰는 방법, 그리고 코멘트가 오가는 흐름에 끼어드는 방법입니다. 남기기, 해결하기, 다시 열기까지.

이 글이 해결하는 문제

파일이 작품의 전부는 아닙니다. 그 옆에 두 개의 층이 더 있습니다. 작가가 자기를 위해 적어 두는 메모, 그리고 편집자와 작가가 주고받는 코멘트입니다.

남의 원고를 넘겨받은 AI에게는 이 두 층이 특히 중요합니다. 어디가 문제인지는 대개 코멘트에 이미 누군가 적어 놓았습니다. 그걸 건너뛰고 혼자 별도의 목록을 만들면, 지난주에 이미 결론이 난 사안을 상대로 논쟁하게 됩니다. 메모는 작가의 생각이 진행 중인 현장입니다. 그걸 읽었느냐 아니냐가 "이 복선은 끝까지 회수되지 않았다"와 "이 복선은 2부까지 일부러 남겨 둔 것이다"를 가릅니다.

메모

list_notes(book_token)                              → 이 작품의 모든 메모
create_note(book_token, title, content, note_type…) → 한 건 남기기

create_note가 받는 인자:

인자	설명
title	필수. 한 줄짜리 제목
content	선택. 최대 50,000자
note_type	book(작품 전체) 또는 chapter(파일 하나에 고정). 기본값은 book
file_id	note_type이 chapter일 때 필수. 그 파일의 토큰이며 get_book_structure에서 먼저 받아 옵니다
color	gray / red / blue / green / yellow / purple 여섯 가지 중 하나

메모는 원고 옆에 있지, 원고 안에 있지 않습니다. 메모를 한 건 쓴다고 본문이 한 글자도 바뀌지 않고, 글자 수에도 잡히지 않습니다.

MCP에는 메모를 지우는 도구가 없습니다. 메모는 버전 관리 대상이 아니라서, 파일과 달리 지우고 나면 되살릴 기록이 남지 않습니다. 지워야 한다면 작가가 앱에서 지웁니다.

복선을 짝짓는 일은 앱에서 합니다. 메모 자체는 잠긴 서랍이 처음 등장하는 메모와 그것이 열리는 메모를 한 쌍으로 묶을 수 있습니다. 다만 create_note는 그 두 필드를 열어 두지 않았습니다. 그래서 AI가 열두 챕터를 읽고 3장의 서랍이 그 뒤로 다시는 열리지 않는다는 걸 발견했다면, 할 수 있는 일은 그 사실을 메모로 남기는 것까지입니다. 짝짓기는 작가가 이어받습니다. 적어도 그 발견이 대화가 끝나는 순간 함께 사라지지는 않습니다.

코멘트

list_comments(book_token)                        → 미해결·해결 포함 모든 스레드
create_comment(book_token, content, file_token?) → 한 건 남기기
resolve_comment(book_token, comment_token)       → 처리 완료로 표시
reopen_comment(book_token, comment_token)        → 닫히지 말았어야 할 스레드를 다시 열기

한 작품 안의 코멘트에는 두 종류가 있습니다. 순수한 코멘트, 그리고 대체 문장을 함께 달고 오는 수정 제안입니다. MCP가 만드는 것은 앞쪽입니다.

comment_token은 list_comments에서 받아 오며 bcmt_… 형태입니다. file_token을 넘기면 그 파일에 붙는 스레드가 되고, 빼면 작품 전체에 대한 스레드가 됩니다.

해결하기 전에 무엇을 했는지 먼저 말하십시오. 아무 말 없이 닫힌 스레드는 그 스레드를 연 사람에게 아무 정보도 주지 못합니다. 지적대로 고쳤는지, 그 지적이 틀렸다고 판단했는지 알 길이 없습니다.

코멘트 해결에는 편집 권한이 필요합니다. 읽기 권한만 가진 협업자는 스레드를 보고 글을 덧붙일 수는 있지만, 남의 스레드를 닫지는 못합니다.

MCP가 일부러 열지 않은 세 가지

없는 것	이유
메모 삭제	메모는 버전 관리 대상이 아니라 지우면 복원할 기록이 없습니다
수정 제안 반영·반려	반영하면 원고가 바로 바뀝니다. 그건 작가의 결정입니다
남의 코멘트 수정·삭제	그건 다른 사람이 한 말입니다

언제 코멘트를 남기고 언제 직접 고치는가

기준은 하나입니다. 이것은 판단인가, 작가가 시킨 일인가?

같은 발견, 두 갈래 출구

전개가 늘어진다, 동기가 납득되지 않는다, 이 신이 그 분량을 감당하지 못한다 코멘트를 남긴다

작가가 「이 대목을 좀 조여 달라」고 했다 파일을 직접 고친다

애매하면 코멘트입니다. 코멘트 하나를 닫는 데는 십 초가 들지만, 원치 않은 재집필은 작가에게 자기 산문의 diff를 읽게 만듭니다.

관련 문서

• Docs: 파일 조작 도구
• Docs: 의미 검색과 전문 검색
• Docs: 가이드와 글쓰기 스킬
• Docs: 코멘트와 스레드