メインコンテンツへスキップ

​
概要

共有リンクツールを使うと、ノートの公開共有リンクを管理できます。共有リンクにより、認証なしで外部から会議ノートにアクセスできるようになります。 利用可能なツール:
  • create_share_link - ノートの共有リンクを作成または更新します
  • get_share_link - ノートの現在の共有リンクを取得します
  • delete_share_link - 共有リンクを削除し、公開アクセスを取り消します
主なユースケース:
  • 外部の関係者と会議ノートを共有する
  • 機密性の高いコンテンツ向けにパスワード保護されたリンクを生成する
  • 以前に共有したノートへのアクセスを取り消す
ノートの共有リンクを新規作成するか、既存のものを更新します。オプションでリンクをパスワードで保護できます。 必要なスコープ: mcp:notes:write

​
パラメータ

ParameterTypeRequiredDescription
noteGuidstringYesノートの一意な GUID
usePasswordbooleanNotrue の場合、パスワード保護されたリンクを生成します

​
リクエスト例

{
  "noteGuid": "abc123-def456-ghi789",
  "usePassword": true
}

​
レスポンス

{
  "shareId": "9b2f7c1a-1234-4d56-9abc-1234567890ab",
  "noteGuid": "abc123-def456-ghi789",
  "shareUrl": "https://tiro.ooo/share-links/9b2f7c1a-1234-4d56-9abc-1234567890ab",
  "sharePassword": "xK9mP2qL",
  "hasPassword": true
}
フィールドの説明:
FieldTypeDescription
shareIdstring共有リンクの UUID token（共有 URL で使用されます）
noteGuidstring元のノート GUID（参照用にそのまま返されます）
shareUrlstring共有ノートにアクセスするための公開 URL
sharePasswordstring | nullノートを閲覧するために必要なパスワード（usePassword が true の場合のみ含まれます）
hasPasswordbooleanリンクがパスワード保護されているかどうか
ノートにすでに共有リンクが存在する場合、create_share_link を呼び出すと、重複を作成するのではなく既存のリンクを更新します。
ノートの現在の共有リンク情報を取得します。共有 UUID（新形式）またはノート GUID（レガシー）のいずれかを受け付けます。リンクがパスワード保護されている場合は、アクセスを検証して完全なレスポンスのロックを解除するために password を渡します。 必要なスコープ: mcp:notes:read

​
パラメータ

ParameterTypeRequiredDescription
noteGuidstringYesノート GUID または共有 ID（UUID または noteGuid）
passwordstringNo共有リンクがパスワード保護されている場合に検証するためのパスワード

​
リクエスト例

{
  "noteGuid": "abc123-def456-ghi789",
  "password": "xK9mP2qL"
}

​
レスポンス

{
  "shareId": "9b2f7c1a-1234-4d56-9abc-1234567890ab",
  "noteGuid": "abc123-def456-ghi789",
  "shareUrl": "https://tiro.ooo/share-links/9b2f7c1a-1234-4d56-9abc-1234567890ab",
  "hasPassword": true,
  "passwordVerified": true,
  "sharePassword": null
}
フィールドの説明:
FieldTypeDescription
shareIdstring共有リンクの UUID token
noteGuidstring元のノート GUID
shareUrlstring共有ノートにアクセスするための公開 URL
hasPasswordbooleanリンクがパスワード保護されているかどうか
passwordVerifiedboolean正しい password が提供された場合に存在し true になります
requiresPasswordVerificationbooleanリンクがパスワード保護されており password が提供されなかった場合に存在し true になります
sharePasswordstring | nullレスポンスでは常に null（パスワードは決して返されません）。代わりに create_share_link から返された値を使用してください
リンクがパスワード保護されており、password なしで get_share_link を呼び出した場合、レスポンスには requiresPasswordVerification: true が含まれ、検証フラグは省略されます。誤ったパスワードを指定すると 401 Unauthorized を返します。
ノートの共有リンクを削除し、すべての公開アクセスを直ちに取り消します。共有 UUID またはレガシーのノート GUID のいずれかを受け付けます。 必要なスコープ: mcp:notes:write

​
パラメータ

ParameterTypeRequiredDescription
noteGuidstringYesノート GUID または共有 ID（UUID または noteGuid）

​
リクエスト例

{
  "noteGuid": "abc123-def456-ghi789"
}

​
レスポンス

{
  "success": true,
  "message": "⚠️ Permanently deleted share link for note 'abc123-def456-ghi789'. The URL https://tiro.ooo/share-links/... is no longer accessible. This action cannot be undone."
}
フィールドの説明:
FieldTypeDescription
successboolean削除が成功した場合は常に true
messagestring人間が読める要約。検索できた場合は以前の共有 URL を含みます
共有リンクの削除は即時かつ取り消し不能です。以前のリンクを持っている人は、そのノートにアクセスできなくなります。

​
よくあるエラー

​
ノートが見つからない

解決方法: noteGuid が正しいことを確認してください。有効なノート識別子を見つけるには search_notes を使用します。

​
共有リンクが見つからない

解決方法: このノートにはまだ共有リンクがありません。create_share_link を使って作成してください。

​
ベストプラクティス

財務データ、人事に関する議論、戦略計画など、機密情報を含むノートを共有する際は、必ず usePassword を有効にしてください。
有効な共有リンクを定期的に見直し、不要になったものは削除してください。これにより、会議内容への意図しないアクセスのリスクを減らせます。
新しい共有リンクを作成する前に、まず get_share_link を使って既存の共有リンクがあるかどうかを確認してください。これにより、既存リンクのパスワードを意図せずリセットしてしまうことを避けられます。