메인 콘텐츠로 건너뛰기

​
개요

get_share_link 도구는 노트의 공개 공유 링크를 조회해요. 공유 링크를 쓰면 인증 없이도 외부에서 회의 노트를 열어볼 수 있어요. 사용 가능한 도구:
  • get_share_link - 노트의 현재 공유 링크를 조회 (읽기 전용)
공유 링크를 생성하거나 삭제하는 작업은 MCP로는 할 수 없어요. 이 쓰기 작업에는 mcp:notes:write scope가 필요한데, MCP 서버는 아직 이 scope를 노출하지 않아요. 공유 링크를 생성하거나 삭제하려면 REST API를 사용하세요 — PUT / DELETE /v1/external/notes/{noteGuid}/share-link.
주요 사용 사례:
  • 노트에 이미 공개 공유 링크가 있는지 확인
  • 노트의 공유 URL을 조회해 전달
  • 비밀번호를 입력해 비밀번호 보호 링크의 상세 정보를 해제
노트의 현재 공유 링크 정보를 조회해요. 공유 UUID(새 형식)나 노트 GUID(레거시) 중 하나를 받아요. 링크가 비밀번호로 보호된 경우, 접근을 검증하고 전체 응답을 해제하려면 password를 전달하세요. 필요한 Scope: mcp:notes:read

​
파라미터

ParameterTypeRequiredDescription
noteGuidstringYes노트 GUID 또는 share ID(UUID 또는 noteGuid)
passwordstringNo공유 링크가 비밀번호로 보호된 경우 검증할 비밀번호

​
요청 예시

{
  "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
}
필드 설명:
FieldTypeDescription
shareIdstring공유 링크용 UUID token
noteGuidstring원본 노트 GUID
shareUrlstring공유된 노트에 접근하는 공개 URL
hasPasswordboolean링크가 비밀번호로 보호되는지 여부
passwordVerifiedboolean올바른 password가 제공됐을 때 존재하며 true
requiresPasswordVerificationboolean링크가 비밀번호로 보호됐고 password가 제공되지 않았을 때 존재하며 true
sharePasswordstring | null응답에서는 항상 null(비밀번호는 절대 다시 반환되지 않음)
링크가 비밀번호로 보호됐는데 password 없이 get_share_link를 호출하면, 응답에 requiresPasswordVerification: true가 포함되고 검증 플래그는 생략돼요. 잘못된 비밀번호를 제공하면 401 Unauthorized를 반환해요.

​
자주 발생하는 오류

​
노트를 찾을 수 없음

해결 방법: noteGuid가 올바른지 확인하세요. search_notes로 유효한 노트 식별자를 찾으세요.

​
공유 링크를 찾을 수 없음

해결 방법: 노트에 아직 공유 링크가 없어요. Tiro 앱이나 REST API(PUT /v1/external/notes/{noteGuid}/share-link)로 하나 만드세요.

​
권장 사례

링크가 비밀번호로 보호된 경우, get_share_link에 password를 전달해 전체 응답을 해제하세요. 전달하지 않으면 응답이 requiresPasswordVerification: true로 설정돼요.
누군가에게 URL을 보내기 전에 get_share_link로 노트에 활성 공개 링크가 있는지 확인하세요.