메인 콘텐츠로 건너뛰기

​
개요

공유 링크 도구를 사용하면 노트의 공개 공유 링크를 관리할 수 있어요. 공유 링크를 쓰면 인증 없이도 외부에서 회의 노트에 접근할 수 있어요. 사용 가능한 도구:
  • create_share_link - 노트의 공유 링크를 생성하거나 업데이트
  • get_share_link - 노트의 현재 공유 링크를 조회
  • delete_share_link - 공유 링크를 삭제해 공개 접근을 철회
주요 사용 사례:
  • 외부 이해관계자와 회의 노트 공유
  • 민감한 콘텐츠를 위한 비밀번호 보호 링크 생성
  • 이전에 공유한 노트의 접근 철회
노트의 공유 링크를 새로 만들거나 기존 링크를 업데이트해요. 선택적으로 비밀번호로 링크를 보호할 수 있어요. 필요한 Scope: mcp:notes:write

​
파라미터

ParameterTypeRequiredDescription
noteGuidstringYes노트의 고유 GUID
usePasswordbooleanNotrue이면 비밀번호 보호 링크를 생성

​
요청 예시

{
  "noteGuid": "abc123-def456-ghi789",
  "usePassword": true
}

​
응답

{
  "shareId": "9b2f7c1a-1234-4d56-9abc-1234567890ab",
  "noteGuid": "abc123-def456-ghi789",
  "shareUrl": "https://tiro.ooo/share-links/9b2f7c1a-1234-4d56-9abc-1234567890ab",
  "sharePassword": "xK9mP2qL",
  "hasPassword": true
}
필드 설명:
FieldTypeDescription
shareIdstring공유 링크용 UUID token(공유 URL에 사용됨)
noteGuidstring원본 노트 GUID(참조용으로 그대로 반환됨)
shareUrlstring공유된 노트에 접근하는 공개 URL
sharePasswordstring | null노트를 보는 데 필요한 비밀번호(usePassword가 true일 때만 존재)
hasPasswordboolean링크가 비밀번호로 보호되는지 여부
노트에 이미 공유 링크가 있으면, create_share_link를 호출해도 중복을 만들지 않고 기존 링크를 업데이트해요.
노트의 현재 공유 링크 정보를 조회해요. 공유 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(비밀번호는 절대 다시 반환되지 않음). 대신 create_share_link에서 반환된 값을 사용하세요
링크가 비밀번호로 보호됐는데 password 없이 get_share_link를 호출하면, 응답에 requiresPasswordVerification: true가 포함되고 검증 플래그는 생략돼요. 잘못된 비밀번호를 제공하면 401 Unauthorized를 반환해요.
노트의 공유 링크를 삭제해 모든 공개 접근을 즉시 철회해요. 공유 UUID나 레거시 노트 GUID 중 하나를 받아요. 필요한 Scope: mcp:notes:write

​
파라미터

ParameterTypeRequiredDescription
noteGuidstringYes노트 GUID 또는 share ID(UUID 또는 noteGuid)

​
요청 예시

{
  "noteGuid": "abc123-def456-ghi789"
}

​
응답

{
  "success": true,
  "message": "⚠️ Permanently deleted share link for note 'abc123-def456-ghi789'. The URL https://tiro.ooo/share-links/... is no longer accessible. This action cannot be undone."
}
필드 설명:
FieldTypeDescription
successboolean삭제에 성공하면 항상 true
messagestring사람이 읽을 수 있는 요약. 조회할 수 있었으면 이전 공유 URL을 포함
공유 링크 삭제는 즉시 적용되며 되돌릴 수 없어요. 이전 링크를 가진 누구도 더 이상 노트에 접근할 수 없어요.

​
자주 발생하는 오류

​
노트를 찾을 수 없음

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

​
공유 링크를 찾을 수 없음

해결 방법: 노트에 아직 공유 링크가 없어요. create_share_link로 하나 만드세요.

​
권장 사례

재무 데이터, HR 논의, 전략 계획처럼 기밀 정보가 담긴 노트를 공유할 때는 항상 usePassword를 활성화하세요.
활성 공유 링크를 주기적으로 점검하고 더 이상 필요 없는 것은 삭제하세요. 회의 콘텐츠에 의도치 않게 접근될 위험을 줄여줘요.
새로 만들기 전에 get_share_link로 공유 링크가 이미 있는지 먼저 확인하세요. 기존 링크의 비밀번호를 의도치 않게 재설정하는 일을 피할 수 있어요.