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

​
概要

get_share_link ツールは、ノートの公開共有リンクを取得します。共有リンクを使うと、サインインせずに会議ノートを開けます。 利用可能なツール:
  • get_share_link - ノートの現在の共有リンクを取得します（読み取り専用）
共有リンクの作成と削除は MCP 経由では利用できません。これらの書き込み操作には mcp:notes:write スコープが必要ですが、MCP サーバーはまだこのスコープを公開していません。共有リンクの作成・削除は代わりに REST API をご利用ください — PUT / DELETE /v1/external/notes/{noteGuid}/share-link。
主なユースケース:
  • ノートにすでに公開共有リンクがあるかどうかを確認する
  • ノートの共有 URL を取得して受け渡しする
  • パスワードを指定して、パスワード保護されたリンクの詳細をロック解除する
ノートの現在の共有リンク情報を取得します。共有 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（パスワードは決して返されません）
リンクがパスワード保護されており、password なしで get_share_link を呼び出した場合、レスポンスには requiresPasswordVerification: true が含まれ、検証フラグは省略されます。誤ったパスワードを指定すると 401 Unauthorized を返します。

​
よくあるエラー

​
ノートが見つからない

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

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

解決方法: このノートにはまだ共有リンクがありません。Tiro アプリまたは REST API（PUT /v1/external/notes/{noteGuid}/share-link）で作成してください。

​
ベストプラクティス