Skip to main content
먼저 메타데이터를 확인하고 필요한 내용만 가져오세요. 아래 예제는 토큰을 아끼면서 MCP 도구를 조합하는 방법을 보여줘요.
처음이라면 MCP 개요를 읽고 클라이언트를 연결하세요.

​
미팅을 찾고 논의 내용을 읽는 방법

list_notes로 시작하고 문서 내용이 필요하면 search_notes, 정확한 발화가 필요하면 get_note_transcript를 호출하세요. 대부분의 질문은 앞의 두 단계에서 답할 수 있어요.

​
단계별 안내

1

후보 노트 나열하기 (가장 저렴)

list_notes를 선택적 query.keyword와 filter와 함께 호출해 결과를 좁히세요. 메타데이터만 반환해요(노트당 약 50 tokens).
filter.folderId로 특정 폴더로 범위를 좁히거나, query.keyword를 아예 생략해 날짜순으로 폴더를 둘러보세요.
2

매칭된 노트의 문서 읽기

어떤 노트가 매칭되는지 보는 것을 넘어 논의 내용을 이해해야 한다면, 필수 keyword와 함께 search_notes를 호출하세요. 응답에는 매칭된 각 노트의 주요 문서(one-pager, custom)가 HTML이 제거된 채 문서당 최대 5KB로 인라인 포함돼요.
매칭된 노트를 최대 10개까지 문서와 함께 반환해요(노트당 약 1,500 tokens). 대부분의 쿼리는 여기서 끝나요. 정제된 문서가 보통 팀의 결정 사항과 action item을 담고 있거든요.
3

단일 AI 요약 가져오기 (선택)

요약 개요가 필요하면 get_note를 include: ["summary"]와 함께 호출하세요.
핵심 결정 사항, action item, 하이라이트를 반환해요(200~800 tokens).
4

전체 transcript 불러오기 (최후의 수단)

정확한 인용이나 특정 발화가 필요할 때만 get_note_transcript를 호출하세요. 타임스탬프가 붙은 문단과 markdown 친화적인 전사 문자열을 반환해요(미팅 1시간당 약 3,000~5,000 tokens).

​
Token 사용량

​
자주 묻는 질문

더 넓은 조건으로 시도하세요.
  • query.keyword를 빼거나 짧게 줄이세요.
  • filter.createdAtFrom / createdAtTo 범위를 넓히거나 제거하세요.
  • Tiro Dashboard에서 노트가 “Completed” 상태인지 확인하세요. 완료되지 않은 노트는 자동으로 제외돼요.
타임존이 포함된 ISO 8601 datetime이에요: 2026-04-01T00:00:00Z. 2026-04-01처럼 날짜만 있는 형식은 받지 않아요. 범위는 반열린 구간 [from, to)예요.
네. list_notes와 search_notes는 사용자 범위와 워크스페이스 범위 API 키를 모두 지원해요. 워크스페이스 범위 API 키는 연결된 워크스페이스만 검색해요. 특정 워크스페이스를 지정하려면 list_workspaces에서 확인한 workspaceGuid를 전달하세요.

​
미팅 노트의 구조화된 문서를 조회하는 방법

AI 에이전트는 Tiro에서 이미 생성된 템플릿 기반 문서를 읽을 수 있어요. 문서에는 action item, 결정 사항, 핵심 요점이 템플릿의 섹션 구조에 맞춰 들어 있어요.

​
단계별 안내

1

사용 가능한 템플릿 둘러보기

list_document_templates를 호출해 어떤 문서 유형이 있는지 확인하세요.
“Meeting Minutes”, “Action Items”, “Decision Log” 같은 템플릿을 반환하며, 각각 id, title, description을 포함해요.
2

대상 미팅 찾기

list_notes를 호출해 키워드(또는 폴더, 날짜 범위)로 미팅을 찾으세요.
3

문서 가져오기

get_note를 include: ["documents"]와 함께 호출해 해당 노트의 생성된 모든 문서를 한 번에 가져오세요.
미팅에 대해 생성된 모든 문서를 구조화된 섹션(예: “Decisions”, “Action Items”, “Next Steps”)과 함께 반환해요.

​
자주 묻는 질문

먼저 list_document_templates를 호출하세요. 각 템플릿에는 용도를 설명하는 description 필드가 있어요. 문서를 요청하기 전에 get_document_template를 특정 templateId와 함께 사용해 전체 섹션 구조를 확인하세요.
get_note(include: ["documents"])는 빈 배열을 반환해요. 문서는 먼저 Tiro 앱에서 생성해야 해요. MCP 서버는 기존 문서에 대한 읽기 접근만 제공해요. 노트 소유자에게 Tiro에서 문서를 생성해 달라고 요청하세요.

​
AI 에이전트 개발자를 위한 팁

​
토큰 사용량 줄이기

  • pagination.size로 결과 수를 제한하세요. list_notes는 기본 20(최대 100), search_notes는 기본 10(최대 30, 각 결과에 문서가 포함되어 더 작음)이에요.
  • 요약과 문서는 MARKDOWN 형식으로 요청하세요.

​
오류 처리

  • 401과 403 응답에는 action_url과 docs_url 필드가 포함돼요. 사용자가 스스로 해결할 수 있도록 이를 노출하세요.
  • 429 응답에는 Retry-After 헤더가 포함돼요. 재시도하기 전에 이를 준수하세요.
  • 전체 오류 레퍼런스는 문제 해결을 참고하세요.

​
올바른 도구 고르기

전체 도구 목록은 Tool Reference에서 둘러보세요.