get_note

개요

get_note는 노트 메타데이터를 조회해요. include에 summary, transcript, documents를 넣으면 해당 내용도 함께 반환해요. 각 항목은 병렬로 조회하므로 하나가 실패해도 나머지는 반환돼요. 이 도구는 2026-05-06에 제거된 list_note_summaries, get_note_summary, list_note_documents, get_note_document를 대체해요. 사용할 때

노트의 기본 정보(참가자, 날짜, 길이)만 필요하면 메타데이터만 가져와요.
AI가 생성한 요약의 전체 내용을 얻으려면 summary를 포함하세요.
전체 대화 텍스트(타임스탬프가 붙은 단락이 하나의 문자열로 연결됨)를 얻으려면 transcript를 포함하세요.
노트의 모든 생성 문서(one-pager, custom 등)를 전체 내용과 함께 가져오려면 documents를 포함하세요.

동작 방식

Promise.allSettled를 사용한 병렬 가져오기. 한 리소스가 실패해도 나머지는 그대로 반환돼요.
include는 선택적 배열 enum이에요: ["summary"], ["transcript"], ["documents"] 또는 이들의 조합.
documents 옵션은 노트의 모든 문서에 대해 전체 내용을 반환해요(5KB로 제한하는 search_notes와 달리).
include가 비었거나 생략되면 메타데이터만 반환해요.

워크스페이스 범위 API Key로 개인 폴더의 노트를 요청하면 삭제된 노트와 같은 “찾을 수 없음”으로 응답해요(시스템 API Key가 조회하는 노트 범위).

참고: get_note는 설계상 전체 문서 내용을 반환해요. 문서당 5KB로 제한하는 search_notes보다 무거워요. 내용 미리보기가 필요하면 대신 search_notes를 사용하세요.

파라미터

Parameter	Type	Required	Description
`noteGuid`	string	조건부	고유 노트 식별자. 보통 `list_notes`나 `search_notes`에서 얻어요.
`url`	string	조건부	`noteGuid` 대신 쓰는 티로 노트 주소. 공유 링크(`https://tiro.ooo/s/{shareId}`) 또는 노트 웹 주소(`/n/{noteId}`)를 받아요. `noteGuid`와 `url` 중 정확히 하나만 보내세요.
`include`	array	Optional	콘텐츠 옵션 배열: `"summary"`, `"transcript"`, `"documents"`. 모두 선택이며 추가 방식이에요. 생략하거나 빈 배열을 전달하면 메타데이터만 반환해요.

noteGuid (조건부)

노트의 고유 식별자예요. noteGuid와 url 중 정확히 하나만 보내세요. 예시:

{
  "noteGuid": "abc-123-def"
}

url (조건부)

noteGuid를 모를 때 티로 노트 주소로 노트를 지정해요. 사용자가 붙여넣은 링크를 그대로 쓸 수 있어요. noteGuid와 url 중 정확히 하나만 보내야 하고, 둘 다 보내거나 둘 다 빠지면 요청이 거부돼요. 받을 수 있는 형식:

공유 링크 — https://tiro.ooo/s/{shareId}
노트 웹 주소 — https://tiro.ooo/n/{noteId} 또는 https://tiro.ooo/n/{noteGuid}

예시:

{
  "url": "https://tiro.ooo/s/SHARE_ID"
}

공유 링크는 노트를 가리키는 식별자일 뿐이고 접근 권한이 아니에요. 링크를 노트로 해석한 뒤에도 호출자의 워크스페이스 접근 권한을 검사하므로, 접근할 수 없는 워크스페이스의 노트는 “찾을 수 없음”으로 응답해요. 공유를 중지하면 링크는 비활성화되지만 shareId는 남으므로, 접근 권한이 있는 호출자는 그 주소를 식별자로 계속 쓸 수 있어요. 링크를 회수하면 주소까지 폐기되어 더 이상 노트를 찾을 수 없어요.

url은 get_note_folders, get_note_transcript, get_share_link에서도 같은 방식으로 쓸 수 있어요.

include (선택)

병렬로 가져올 콘텐츠 유형의 배열이에요. 유효한 옵션:

"summary" — 노트에서 처음으로 사용 가능한 AI 생성 요약을 가져와요(전체 내용).
"transcript" — 전체 대화 transcript를 가져와요(단락이 \n\n로 연결됨).
"documents" — 노트의 모든 생성 문서(one-pager, custom 등)를 전체 내용과 함께 가져와요.

예시:

// Metadata only
{}

// With summary
{ "include": ["summary"] }

// With transcript and documents
{ "include": ["transcript", "documents"] }

// All three
{ "include": ["summary", "transcript", "documents"] }

응답 형식

성공 응답

{
  "noteGuid": "abc-123-def",
  "guid": "abc-123-def",
  "title": "Q2 OKR Planning",
  "webUrl": "https://platform.tiro.ooo/notes/abc-123-def",
  "participants": [
    { "name": "Alice Kim", "email": "alice@example.com" },
    { "name": "Bob Park", "email": null }
  ],
  "createdAt": "2026-04-15T10:00:00Z",
  "updatedAt": "2026-04-15T11:30:00Z",
  "recordingDurationSeconds": 3625,
  "sourceType": "live-voice",
  "summary": {
    "content": "## Key Decisions\n- Q2 roadmap prioritizes...\n## Action Items\n- Alice: finalize spec by...",
    "format": "MARKDOWN",
    "summaryId": "summary-id-123"
  },
  "transcript": "[10:00:05] Alice: Let's start with Q2 planning.\n[10:00:18] Bob: Sure, here's what...",
  "documents": [
    {
      "documentId": 42,
      "templateId": 1,
      "templateTitle": "One Pager",
      "locale": "en",
      "sections": [
        {
          "content": "## OKR Goals\nGoal 1: ...",
          "format": "MARKDOWN"
        }
      ],
      "createdAt": "2026-04-15T11:30:00Z"
    }
  ]
}

필드 설명:

Field	Type	Description
`noteGuid` / `guid`	string	노트 식별자(하위 호환을 위해 두 필드 모두 존재).
`title`	string	노트 제목.
`webUrl`	string	Tiro 웹 앱에서 노트로 바로 가는 링크.
`createdAt`	string	ISO 8601 생성 타임스탬프.
`updatedAt`	string	ISO 8601 마지막 수정 타임스탬프.
`recordingDurationSeconds`	number	녹음 길이(초).
`sourceType`	string	`live-voice`, `recording`, `text`, `video`, `webpage`, `offline-mode`, `onboarding` 중 하나.
`participants[]`	array	참가자별 `{ name, email }`. 둘 중 어느 쪽이든 `null`일 수 있어요.
`summary` (포함된 경우)	object	요약이 있으면 `{ content, format, summaryId }`, 없으면 `null`.
`summary.content`	string	요약 텍스트(HTML 제거, markdown 친화적).
`summary.format`	string	`MARKDOWN` 또는 `PLAIN_TEXT`.
`summary.summaryId`	string	요약의 식별자.
`transcript` (포함된 경우)	string	`[HH:MM:SS]`가 앞에 붙은 줄들로 이뤄진 전체 transcript, `\n\n`로 연결돼요. transcript가 없으면 `null`.
`documents` (포함된 경우)	array	문서 객체 배열, 없으면 `null`. `include: ["documents"]`를 요청했지만 노트에 문서가 없으면 빈 배열 `[]`.
`documents[].documentId`	number	안정적인 문서 식별자.
`documents[].templateId`	number	숫자 template id(구분에는 `templateTitle`이 아니라 이걸 사용하세요).
`documents[].templateTitle`	string	표시 라벨(locale에 따라 달라지며 custom 템플릿은 사용자가 편집 가능).
`documents[].locale`	string	문서의 locale(예: `"en"`, `"ko"`).
`documents[].sections[]`	array	`{ content, format }` 섹션 배열.
`documents[].sections[].content`	string	섹션 텍스트(HTML 제거).
`documents[].sections[].format`	string	콘텐츠 형식(`MARKDOWN`, `PLAIN_TEXT` 등).
`documents[].createdAt`	string	ISO 8601 문서 생성 타임스탬프.

요청한 리소스를 사용할 수 없을 때(예: 요약이 없을 때) 해당 필드는 생략되지 않고 null로 설정돼요. 이를 통해 호출자는 “요청에 포함되지 않음”과 “포함했지만 사용 불가”를 구분할 수 있어요.

사용 예시

예시 1: 메타데이터만

요청:

{
  "noteGuid": "abc-123-def"
}

응답:

{
  "noteGuid": "abc-123-def",
  "title": "Q2 Planning",
  "participants": [{ "name": "Alice Kim", "email": "alice@example.com" }],
  "createdAt": "2026-04-15T10:00:00Z",
  "recordingDurationSeconds": 3625,
  "sourceType": "live-voice"
}

예시 2: 요약만 포함

요청:

{
  "noteGuid": "abc-123-def",
  "include": ["summary"]
}

응답:

{
  "noteGuid": "abc-123-def",
  "title": "Q2 Planning",
  "participants": [{ "name": "Alice Kim", "email": "alice@example.com" }],
  "createdAt": "2026-04-15T10:00:00Z",
  "recordingDurationSeconds": 3625,
  "sourceType": "live-voice",
  "summary": {
    "content": "## Key Decisions\n- OKR prioritizes feature X...\n## Action Items\n- Alice: finalize spec",
    "format": "MARKDOWN",
    "summaryId": "summary-id-123"
  }
}

예시 3: transcript와 문서 포함

요청:

{
  "noteGuid": "abc-123-def",
  "include": ["transcript", "documents"]
}

응답:

{
  "noteGuid": "abc-123-def",
  "title": "Q2 Planning",
  "participants": [{ "name": "Alice Kim", "email": "alice@example.com" }],
  "createdAt": "2026-04-15T10:00:00Z",
  "recordingDurationSeconds": 3625,
  "sourceType": "live-voice",
  "transcript": "[10:00:05] Alice: Let's start with Q2 planning...\n[10:00:18] Bob: Sure...",
  "documents": [
    {
      "documentId": 42,
      "templateId": 1,
      "templateTitle": "One Pager",
      "locale": "en",
      "sections": [
        { "content": "## OKR Goals\n...", "format": "MARKDOWN" }
      ],
      "createdAt": "2026-04-15T11:30:00Z"
    }
  ]
}

예시 4: 한 번의 호출로 모든 콘텐츠

요청:

{
  "noteGuid": "abc-123-def",
  "include": ["summary", "transcript", "documents"]
}

메타데이터, 요약, 전체 transcript, 모든 문서를 병렬로 반환해요. 그중 하나라도 실패하면(예: 요약이 없을 때) 해당 필드는 null이지만 나머지는 그대로 채워져요.

권장 사례

include를 선택적으로 사용하기

필요한 콘텐츠만 요청하세요. 메타데이터는 약 50 토큰이고, 요약을 추가하면 약 200 토큰이, transcript는 시간당 약 3,000~5,000 토큰이 추가돼요. 문서는 크기에 따라 달라요.메타데이터로 시작해서 빠른 개요가 필요하면 get_note(include: ["summary"])로, action item이나 핵심 정리가 필요하면 get_note(include: ["documents"])로 전환하세요.

내용 미리보기에는 search_notes 사용하기

노트에 무엇이 들어 있는지 빠르게 보려면 먼저 search_notes를 사용하세요. 5KB로 제한된 문서와 함께 매칭된 노트를 반환해요. 문서의 전체 내용이 필요할 때만 get_note(include: ["documents"])를 사용하세요.

null을 우아하게 처리하기

include: ["summary"]를 설정했지만 요약이 없으면 summary는 null이 돼요. 코드에서 이를 처리해야 해요. 요청했다는 이유만으로 필드가 항상 채워진다고 가정하지 마세요.

디스커버리와 콘텐츠 결합하기

점진적 공개(progressive disclosure) 패턴: list_notes → search_notes → get_note(include: [...]). 대부분의 워크플로우는 2단계에서 멈춰요. 전체 내용이 필요하거나 앞선 도구로 충분하지 않을 때만 3단계를 사용하세요.

자주 발생하는 오류

노트를 찾을 수 없음

해결 방법: noteGuid가 올바른지 확인하세요. list_notes나 search_notes로 유효한 노트 식별자를 찾으세요.

권한 scope 부족

해결 방법: API key에 mcp:note:read scope가 있는지 확인하세요. scope 구성은 Setup을 참고하세요.

토큰 사용량

Mode	Tokens
메타데이터만	~50
메타데이터 + 요약	~250
메타데이터 + transcript	시간당 ~3,000–5,000
메타데이터 + 문서	~1,000–5,000 (문서 크기에 따라 다름)
세 가지 모두	~4,000–10,000 (가변)

통합으로 절감: 예전의 list_note_summaries + get_note_summary 체인이 이제 한 번의 get_note(include: ["summary"]) 호출로 처리돼요. list_note_documents + get_note_document → get_note(include: ["documents"])도 마찬가지예요.

홈

시작하기

API

음성 파일

웹훅

MCP

CLI

개발자 리소스

개요

파라미터

noteGuid (조건부)

url (조건부)

include (선택)

응답 형식

성공 응답

사용 예시

예시 1: 메타데이터만

예시 2: 요약만 포함

예시 3: transcript와 문서 포함

예시 4: 한 번의 호출로 모든 콘텐츠

권장 사례

자주 발생하는 오류

노트를 찾을 수 없음

권한 scope 부족

토큰 사용량

관련 도구

​개요

​파라미터

​noteGuid (조건부)

​url (조건부)

​include (선택)

​응답 형식

​성공 응답

​사용 예시

​예시 1: 메타데이터만

​예시 2: 요약만 포함

​예시 3: transcript와 문서 포함

​예시 4: 한 번의 호출로 모든 콘텐츠

​권장 사례

​자주 발생하는 오류

​노트를 찾을 수 없음

​권한 scope 부족

​토큰 사용량

​관련 도구

개요

파라미터

noteGuid (조건부)

url (조건부)

include (선택)

응답 형식

성공 응답

사용 예시

예시 1: 메타데이터만

예시 2: 요약만 포함

예시 3: transcript와 문서 포함

예시 4: 한 번의 호출로 모든 콘텐츠

권장 사례

자주 발생하는 오류

노트를 찾을 수 없음

권한 scope 부족

토큰 사용량

관련 도구