> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tiro.ooo/llms.txt
> Use this file to discover all available pages before exploring further.

# 共有リンク

> ノートの公開共有リンクを MCP 経由で取得します（読み取り専用）

## 概要

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

**利用可能なツール:**

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

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

**主なユースケース:**

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

***

## get\_share\_link

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

**必要なスコープ:** `mcp:notes:read`

### パラメータ

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

### リクエスト例

```json theme={"system"}
{
  "noteGuid": "abc123-def456-ghi789",
  "password": "xK9mP2qL"
}
```

### レスポンス

```json theme={"system"}
{
  "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`（パスワードは決して返されません）                        |

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

***

## よくあるエラー

### ノートが見つからない

<Error>
  ```json theme={"system"}
  {
    "error": "Note not found",
    "code": "NOTE_NOT_FOUND",
    "statusCode": 404
  }
  ```
</Error>

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

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

<Error>
  ```json theme={"system"}
  {
    "error": "No share link exists for this note",
    "code": "SHARE_LINK_NOT_FOUND",
    "statusCode": 404
  }
  ```
</Error>

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

***

## ベストプラクティス

<AccordionGroup>
  <Accordion title="Unlock password-protected links">
    リンクがパスワード保護されている場合は、`get_share_link` に `password` を渡して完全なレスポンスのロックを解除してください。指定しないと、レスポンスは `requiresPasswordVerification: true` を設定します。
  </Accordion>

  <Accordion title="Confirm a link exists before sharing">
    URL を誰かに送る前に、`get_share_link` を呼び出して、ノートに有効な公開リンクがあることを確認してください。
  </Accordion>
</AccordionGroup>