공유 링크

개요

get_share_link 도구는 노트의 공개 공유 링크를 조회해요. 공유 링크를 쓰면 인증 없이도 외부에서 회의 노트를 열어볼 수 있어요. 사용 가능한 도구는 get_share_link 하나예요.

공유 링크를 생성하거나 삭제하는 MCP 도구는 아직 제공되지 않아요. 공유 링크를 생성하거나 삭제하려면 REST API를 사용하세요 — PUT / DELETE /v1/external/notes/{noteGuid}/share-link (note:write scope 필요).

사용할 때

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

get_share_link

노트의 현재 공유 링크 정보를 조회해요. noteGuid 필드에는 레거시 노트 GUID만 넣을 수 있어요 — 이 필드에 UUID 형식의 공유 ID를 전달하면 400 UUID_SHARE_ID_UNSUPPORTED 오류로 거부돼요. UUID 토큰을 쓰는 최신 공유 링크는 값을 뽑아 쓰지 말고 주소 전체를 url로 넘기면 정상 조회돼요. 링크가 비밀번호로 보호된 경우, 접근을 검증하고 전체 응답을 해제하려면 password를 전달하세요. 필요한 Scope: mcp:note:read

파라미터

Parameter	Type	Required	Description
`noteGuid`	string	조건부	노트 GUID(`list_notes` / `search_notes`에서 받은 값). 이 필드에는 UUID 형식의 공유 ID를 넣을 수 없어요 — 그런 링크는 `url`로 넘기세요.
`url`	string	조건부	`noteGuid` 대신 쓰는 티로 노트 주소. 공유 링크(`https://tiro.ooo/s/{shareId}`) 또는 노트 웹 주소(`/n/{noteId}`)를 받아요. `noteGuid`와 `url` 중 정확히 하나만 보내세요.
`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를 반환해요.

자주 발생하는 오류

노트 또는 공유 링크를 찾을 수 없음

노트가 없거나, 노트는 있지만 아직 공유 링크가 없는 경우 둘 다 같은 NOT_FOUND 코드로 응답해요(백엔드가 원인을 구분해 돌려주지 않아요). 해결 방법: noteGuid가 올바른지 search_notes로 확인하세요. noteGuid는 맞는데 이 오류가 나면 노트에 아직 공유 링크가 없는 거예요 — Tiro 앱이나 REST API(PUT /v1/external/notes/{noteGuid}/share-link)로 하나 만드세요.

UUID 형식 공유 ID 미지원

해결 방법: 공유 링크 주소 전체를 url로 넘기거나, list_notes / search_notes에서 받은 노트 GUID를 noteGuid로 전달하세요.

권장 사례

비밀번호 보호 링크를 해제하세요

링크가 비밀번호로 보호된 경우, get_share_link에 password를 전달해 전체 응답을 해제하세요. 전달하지 않으면 응답이 requiresPasswordVerification: true로 설정돼요.

공유하기 전에 링크가 있는지 확인하세요

누군가에게 URL을 보내기 전에 get_share_link로 노트에 활성 공개 링크가 있는지 확인하세요.

홈

시작하기

API

음성 파일

웹훅

MCP

CLI

개발자 리소스

개요

get_share_link

파라미터

요청 예시

응답

자주 발생하는 오류

노트 또는 공유 링크를 찾을 수 없음

UUID 형식 공유 ID 미지원

권장 사례

​개요

​get_share_link

​파라미터

​요청 예시

​응답

​자주 발생하는 오류

​노트 또는 공유 링크를 찾을 수 없음

​UUID 형식 공유 ID 미지원

​권장 사례

개요

get_share_link

파라미터

요청 예시

응답

자주 발생하는 오류

노트 또는 공유 링크를 찾을 수 없음

UUID 형식 공유 ID 미지원

권장 사례