> ## 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` scope가 필요한데, MCP 서버는 아직 이 scope를 노출하지 않아요. 공유 링크를 생성하거나 삭제하려면 REST API를 사용하세요 — `PUT` / `DELETE /v1/external/notes/{noteGuid}/share-link`.
</Note>

**주요 사용 사례:**

* 노트에 이미 공개 공유 링크가 있는지 확인
* 노트의 공유 URL을 조회해 전달
* 비밀번호를 입력해 비밀번호 보호 링크의 상세 정보를 해제

***

## get\_share\_link

노트의 현재 공유 링크 정보를 조회해요. 공유 UUID(새 형식)나 노트 GUID(레거시) 중 하나를 받아요. 링크가 비밀번호로 보호된 경우, 접근을 검증하고 전체 응답을 해제하려면 `password`를 전달하세요.

**필요한 Scope:** `mcp:notes:read`

### 파라미터

| Parameter  | Type   | Required | Description                           |
| ---------- | ------ | -------- | ------------------------------------- |
| `noteGuid` | string | Yes      | 노트 GUID 또는 share 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="비밀번호 보호 링크를 해제하세요">
    링크가 비밀번호로 보호된 경우, `get_share_link`에 `password`를 전달해 전체 응답을 해제하세요. 전달하지 않으면 응답이 `requiresPasswordVerification: true`로 설정돼요.
  </Accordion>

  <Accordion title="공유하기 전에 링크가 있는지 확인하세요">
    누군가에게 URL을 보내기 전에 `get_share_link`로 노트에 활성 공개 링크가 있는지 확인하세요.
  </Accordion>
</AccordionGroup>