メインコンテンツへスキップ
Tiro MCP ツールは Progressive Disclosure pattern（段階的開示パターン）を中心に設計されています。まずメタデータを読み込み、詳細は必要なときだけ取得します。以下のワークフローでは、token の使用量を最小限に抑えながら、一般的なタスクのためにツールを連結する方法を紹介します。
Tiro MCP は初めてですか？ まず Overview でアーキテクチャを理解し、これらのワークフローを試す前にクライアントをセットアップしてください。

​
会議を見つけて話された内容を読む方法

Tiro のノート探索は 3 段階の段階的な流れになっています。まずは軽量な list_notes から始め、ドキュメントの内容が必要になったら search_notes に深め、一言一句の発言が必要なときだけ get_note_transcript に手を伸ばします。ほとんどのユーザーの質問は tier 1 または tier 2 で完結します。

​
ステップバイステップ

1

候補ノートを一覧表示する（最も低コスト）

list_notes を呼び出し、任意の query.keyword と filter で結果を絞り込みます。返されるのはメタデータのみです（ノートあたり約 50 token）。
{
  "query": { "keyword": "product roadmap" },
  "filter": { "createdAtFrom": "2026-04-01T00:00:00Z" },
  "pagination": { "size": 20 }
}
特定のフォルダに範囲を限定するには filter.folderId を使い、フォルダを日付順に閲覧するには query.keyword を完全に省略します。
2

一致したノートのドキュメントを読む

どのノートが一致するかを確認するだけでなく、話された内容を理解する必要がある場合は、必須の keyword を指定して search_notes を呼び出します。レスポンスには、一致した各ノートの主要なドキュメント（one-pager、custom）がインラインで含まれ、HTML が除去され、ドキュメントあたり 5KB に制限されます。
{
  "keyword": "product roadmap",
  "filter": { "createdAtFrom": "2026-04-01T00:00:00Z" },
  "pagination": { "size": 10 }
}
最大 10 件の一致ノートをそのドキュメントとともに返します（ノートあたり約 1,500 token）。ほとんどのクエリはここで完結します。整理されたドキュメントには、通常チームの意思決定とアクションアイテムが含まれています。
3

単一の AI 要約を取得する（任意）

要約の概要が必要な場合は、include: ["summary"] を指定して get_note を呼び出します。
{
  "noteGuid": "f8a2c1e4-9b3d-4e7f-a6c8-1d2e3f4a5b6c",
  "include": ["summary"]
}
主要な意思決定、アクションアイテム、ハイライトを返します（200〜800 token）。
4

完全なトランスクリプトを読み込む（最終手段）

正確な引用や特定の発言が必要なときだけ、get_note_transcript を呼び出します。タイムスタンプ付きの段落と、markdown に適したトランスクリプション文字列を返します（会議 1 時間あたり約 3,000〜5,000 token）。
{
  "noteGuid": "f8a2c1e4-9b3d-4e7f-a6c8-1d2e3f4a5b6c"
}

​
Token の使用量

ApproachTokensSpeed
list_notes のみ（候補を見つける）ノートあたり約 50最速
list_notes → search_notes（ドキュメントを読む）ノートあたり約 1,500速い
get_note_transcript を直接読み込む1 時間あたり約 3,000〜5,000最も遅い
トランスクリプトとの比較での削減率70〜80%—

​
よくある質問

フォルダ、日付、またはキーワードの有無でどのノートが存在するかを知る必要があるときは list_notes を使います。返されるのはメタデータのみです。あるトピックの背後にある文脈を理解する必要があるとき、つまりその意思決定、アクションアイテム、結論などを知りたいときは search_notes を使います。一致したノートとそのドキュメントをインラインで返します。キーワードは必須です。
より広い条件を試してください。
  • query.keyword を外すか短くする。
  • filter.createdAtFrom / createdAtTo の範囲を広げるか、外す。
  • ノートが Tiro Dashboard で「Completed」になっているか確認する。未完了のノートは自動的に除外されます。
search_notes を優先してください。整理されたドキュメントは通常、生のトランスクリプトより 10 倍コンパクトで、チームの意思決定、アクションアイテム、結論を意図された構造で捉えています。直接引用のために一言一句の発言が必要なときだけ get_note_transcript を使ってください。
タイムゾーン付きの ISO 8601 datetime です：2026-04-01T00:00:00Z。2026-04-01 のような日付のみの形式は受け付けられません。範囲は半開区間 [from, to) です。
まだ使えません。list_notes と search_notes でのキーワード検索には user-scoped API key が必要です。keyword を設定した team-only API key は 400 を返します。キーワードなしの一覧表示（フォルダ範囲指定またはフィルターなし）は team API key で動作します。

​
会議ノートから構造化されたドキュメントを生成する方法

AI エージェントは、Tiro のテンプレートベースのドキュメントシステムを使って、任意の会議からアクションアイテム、意思決定、要点を抽出できます。各ドキュメントは、テンプレートで定義されたセクションに構造化されます。

​
ステップバイステップ

1

利用可能なテンプレートを閲覧する

list_document_templates を呼び出して、利用可能なドキュメントの種類を確認します。
{}
「Meeting Minutes」「Action Items」「Decision Log」などのテンプレートを返します。それぞれに id、title、description が付いています。
2

対象の会議を見つける

list_notes を呼び出し、キーワード（またはフォルダ、日付範囲）で会議を特定します。
{
  "query": { "keyword": "sprint planning" }
}
3

ドキュメントを取得する

include: ["documents"] を指定して get_note を呼び出すと、そのノートのために生成されたすべてのドキュメントを 1 回の呼び出しで取得できます。
{
  "noteGuid": "f8a2c1e4-9b3d-4e7f-a6c8-1d2e3f4a5b6c",
  "include": ["documents"]
}
その会議について生成されたすべてのドキュメントを、構造化されたセクション（例：「Decisions」「Action Items」「Next Steps」）とともに返します。

​
よくある質問

まず list_document_templates を呼び出してください。各テンプレートには、その目的を説明する description フィールドが含まれています。ドキュメントをリクエストする前にセクション構造の全体を確認するには、特定の templateId を指定して get_document_template を使ってください。
get_note(include: ["documents"]) は空の配列を返します。ドキュメントはまず Tiro アプリから生成する必要があります。MCP server は既存のドキュメントへの読み取りアクセスを提供します。ノートの所有者に、Tiro 上でドキュメントを生成するよう依頼してください。

​
AI エージェント開発者向けのヒント

​
Token の最適化

  • 必ず list_notes（ノートあたり約 50 token）から始め、ドキュメントの内容が必要なときだけ search_notes（ノートあたり約 1,500 token）に深め、一言一句の引用が必要なときだけ get_note_transcript に手を伸ばしてください。
  • 結果の上限を設定するには pagination.size を使います。list_notes のデフォルトは 20（最大 100）、search_notes のデフォルトは 10（最大 30。各結果にドキュメントが含まれるため小さめです）。
  • 要約とドキュメントには MARKDOWN 形式を優先してください。より構造化されていて、LLM が解析しやすくなります。

​
エラーハンドリング

  • 401 と 403 のレスポンスには action_url と docs_url フィールドが含まれます。これらを提示すれば、自身で解決できます
  • 429 のレスポンスには Retry-After ヘッダーが含まれます。再試行する前にこれに従ってください
  • 完全なエラーリファレンスは Troubleshooting をご覧ください

​
適切なツールの選び方

User IntentStart WithThen
「トピック X の会議はどれですか？」list_notes—（メタデータで十分）
「この会議では何が話されましたか？」search_notes（ドキュメントがインライン。通常はこれで十分）
「実際の発言を引用したい」list_notesget_note_transcript
「アクションアイテムをください」list_notesinclude: ["documents"] を指定した get_note
「どのドキュメントテンプレートが利用できますか？」list_document_templatesget_document_template
「認証されていますか？」auth_status—
すべてのツールについては Tool Reference をご覧ください。