노트 & 폴더 편집

개요

이 네 가지 쓰기 도구를 사용하면 어시스턴트가 사용자를 대신해 노트와 폴더 구성을 편집할 수 있어요:

update_note — 노트 제목을 수정해요. Scope mcp:notes:write.
update_folder — 폴더의 제목, 설명, 색상을 수정해요. Scope mcp:folders:write.
move_folder — 폴더를 다른 부모 아래로 이동하거나 워크스페이스 루트로 옮겨요. Scope mcp:folders:write.
reorder_folders — 같은 부모 아래 형제 폴더의 순서를 변경해요. Scope mcp:folders:write.

사용 시점:

회의가 끝난 뒤 실제 내용에 맞게 노트 제목을 다시 붙일 때.
폴더 이름을 바꾸거나 설명을 정리하거나 한눈에 구분되도록 색상을 바꿀 때.
폴더 트리를 재구성할 때: 폴더를 다른 폴더 아래로 넣거나, 워크스페이스 루트로 올리거나, 형제 폴더가 표시되는 순서를 바꿀 때.

user key vs. workspace-system key (폴더 도구). update_folder, move_folder, reorder_folders의 경우: user API key는 편집 권한이 있는 폴더(개인 또는 팀)라면 무엇이든 편집할 수 있어요. workspace-system API key는 TEAM(워크스페이스 공유) 폴더만 편집할 수 있고, 개인 폴더를 편집하려는 시도는 거부돼요. update_note는 user, workspace, organization API key 모두에서 동작해요.

update_note

노트 제목을 수정해요.

파라미터

Parameter	Type	Required	Description
`noteGuid`	string	Required	수정할 노트의 GUID.
`title`	string	Required	새 노트 제목. 1–100자, 공백만으로는 안 됨.

예시

요청:

{
  "noteGuid": "note_9f8c2a1b",
  "title": "Q1 Planning — Kickoff"
}

응답:

{
  "noteGuid": "note_9f8c2a1b",
  "title": "Q1 Planning — Kickoff",
  "updatedAt": "2026-07-14T09:30:00Z"
}

update_folder

폴더의 제목, 설명, 색상을 수정해요. AIP-134 field-mask 업데이트로, 전달한 필드만 변경되고 생략한 필드는 그대로 유지돼요. 최소 한 개 필드는 필수예요.

파라미터

Parameter	Type	Required	Description
`folderId`	string	Required	수정할 폴더의 ID.
`title`	string	Optional	새 폴더 제목. 1–50자, 공백만으로는 안 됨.
`description`	string	Optional	새 설명. 빈 문자열(`""`)을 전달하면 지워져요.
`color`	string	Optional	`#RRGGBB` hex 문자열 형식의 폴더 색상.

title, description, color 중 최소 하나는 반드시 전달해야 해요. 생략한 필드는 변경되지 않아요. 예를 들어 제목을 다시 보내지 않고도 색상만 바꿀 수 있어요.

예시

요청:

{
  "folderId": "12345",
  "title": "Engineering",
  "color": "#4C6EF5"
}

응답:

{
  "folderId": "12345",
  "title": "Engineering",
  "description": "Engineering team notes",
  "color": "#4C6EF5"
}

move_folder

폴더를 다른 부모 아래로 이동하거나 워크스페이스 루트로 옮겨요.

파라미터

Parameter	Type	Required	Description
`folderId`	string	Required	이동할 폴더의 ID.
`newParentId`	string	Optional	새 부모 폴더의 ID. `null`을 전달하거나 생략하면 폴더를 워크스페이스 루트로 옮겨요.

예시

요청:

{
  "folderId": "12346",
  "newParentId": "12345"
}

폴더 12346을 폴더 12345 아래로 이동해요. 응답:

{
  "folderId": "12346",
  "title": "Q1 Planning",
  "parentId": "12345"
}

폴더를 워크스페이스 루트로 옮기려면 newParentId를 생략하거나 null을 전달하세요: 요청:

{
  "folderId": "12346"
}

reorder_folders

형제 폴더의 순서를 변경해요. 한 형제 집합의 완전한 원하는 순서를 전달하세요. 워크스페이스는 첫 번째 폴더 ID에서 추론돼요.

파라미터

Parameter	Type	Required	Description
`orderedFolderIds`	string[]	Required	원하는 형제 순서 전체(최소 1개 ID). 모든 형제가 정확히 한 번씩 나와야 해요. 워크스페이스는 첫 번째 ID에서 추론돼요.

예시

요청:

{
  "orderedFolderIds": ["12347", "12345", "12346"]
}

세 형제 폴더를 주어진 순서로 재정렬해요. 응답:

{
  "orderedFolderIds": ["12347", "12345", "12346"]
}

scope 요구 사항

update_note는 mcp:notes:write scope가 필요하고, update_folder, move_folder, reorder_folders는 mcp:folders:write scope가 필요해요.

API key는 모든 scope를 가지므로, 유효한 API key라면 이 도구들을 호출할 수 있어요. mcp:notes:write / mcp:folders:write scope는 OAuth 기반 클라이언트에서 의미가 있는데, 이 경우 부여된 scope가 어떤 도구를 호출할 수 있는지를 결정해요.

API key는 Tiro Platform API Keys에서 구성하세요.

​개요

​update_note

​파라미터

​예시

​update_folder

​파라미터

​예시

​move_folder

​파라미터

​예시

​reorder_folders

​파라미터

​예시

​scope 요구 사항

​관련 도구

개요

update_note

파라미터

예시

update_folder

파라미터

예시

move_folder

파라미터

예시

reorder_folders

파라미터

예시

scope 요구 사항

관련 도구