Skip to main content

​
概要

get_share_link ツールは、ノートの公開共有リンクを取得します。共有リンクを使うと、サインインせずに会議ノートを開けます。 利用できるツールは get_share_link の 1 つで、ノートの現在の共有リンクを取得します（読み取り専用）。
共有リンクを作成・削除する MCP ツールはまだ提供されていません。共有リンクの作成・削除は REST API をご利用ください — PUT / DELETE /v1/external/notes/{noteGuid}/share-link（note:write スコープが必要）。
使うとき
  • ノートにすでに公開共有リンクがあるかどうかを確認する
  • ノートの共有 URL を取得して受け渡しする
  • パスワードを指定して、パスワード保護されたリンクの詳細をロック解除する
ノートの現在の共有リンク情報を取得します。現在はレガシーのノート GUID のみ対応しています — UUID 形式の共有 ID を渡すと 400 UUID_SHARE_ID_UNSUPPORTED エラーで拒否されます（UUID→ノートのマッピングはまだ実装されていません）。リンクがパスワード保護されている場合は、アクセスを検証して完全なレスポンスのロックを解除するために password を渡します。 必要なスコープ: mcp:note:read

​
パラメータ

​
リクエスト例

​
レスポンス

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

​
よくあるエラー

​
ノートまたは共有リンクが見つからない

ノートが存在しない場合と、ノートはあるがまだ共有リンクがない場合のどちらも、同じ NOT_FOUND コードで応答します（バックエンドは原因を区別して返しません）。 解決方法: search_notes で noteGuid が正しいか確認してください。noteGuid が正しいのにこのエラーが出る場合は、そのノートにまだ共有リンクがないということです — Tiro アプリまたは REST API（PUT /v1/external/notes/{noteGuid}/share-link）で作成してください。

​
UUID 形式の共有 ID は未対応

解決方法: UUID ではなく、list_notes / search_notes から取得したノート GUID を渡してください。

​
ベストプラクティス