共有リンク

概要

get_share_link ツールは、ノートの公開共有リンクを取得します。共有リンクを使うと、サインインせずに会議ノートを開けます。 利用可能なツール:

get_share_link - ノートの現在の共有リンクを取得します（読み取り専用）

共有リンクの作成と削除は MCP 経由では利用できません。これらの書き込み操作には mcp:notes:write スコープが必要ですが、MCP サーバーはまだこのスコープを公開していません。共有リンクの作成・削除は代わりに REST API をご利用ください — PUT / DELETE /v1/external/notes/{noteGuid}/share-link。

主なユースケース:

ノートにすでに公開共有リンクがあるかどうかを確認する
ノートの共有 URL を取得して受け渡しする
パスワードを指定して、パスワード保護されたリンクの詳細をロック解除する

get_share_link

ノートの現在の共有リンク情報を取得します。共有 UUID（新形式）またはノート GUID（レガシー）のいずれかを受け付けます。リンクがパスワード保護されている場合は、アクセスを検証して完全なレスポンスのロックを解除するために password を渡します。 必要なスコープ: mcp:notes:read

パラメータ

Parameter	Type	Required	Description
`noteGuid`	string	Yes	ノート GUID または共有 ID（UUID または noteGuid）
`password`	string	No	共有リンクがパスワード保護されている場合に検証するためのパスワード

リクエスト例

{
  "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
}

フィールドの説明:

Field	Type	Description
`shareId`	string	共有リンクの UUID token
`noteGuid`	string	元のノート GUID
`shareUrl`	string	共有ノートにアクセスするための公開 URL
`hasPassword`	boolean	リンクがパスワード保護されているかどうか
`passwordVerified`	boolean	正しい `password` が提供された場合に存在し `true` になります
`requiresPasswordVerification`	boolean	リンクがパスワード保護されており `password` が提供されなかった場合に存在し `true` になります
`sharePassword`	string \| null	レスポンスでは常に `null`（パスワードは決して返されません）

リンクがパスワード保護されており、password なしで get_share_link を呼び出した場合、レスポンスには requiresPasswordVerification: true が含まれ、検証フラグは省略されます。誤ったパスワードを指定すると 401 Unauthorized を返します。

よくあるエラー

ノートが見つからない

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