Skip to main content

​
개요

get_share_link 도구는 노트의 공개 공유 링크를 조회해요. 공유 링크를 쓰면 인증 없이도 외부에서 회의 노트를 열어볼 수 있어요. 사용 가능한 도구는 get_share_link 하나예요.
공유 링크를 생성하거나 삭제하는 MCP 도구는 아직 제공되지 않아요. 공유 링크를 생성하거나 삭제하려면 REST API를 사용하세요 — PUT / DELETE /v1/external/notes/{noteGuid}/share-link (note:write scope 필요).
사용할 때
  • 노트에 이미 공개 공유 링크가 있는지 확인
  • 노트의 공유 URL을 조회해 전달
  • 비밀번호를 입력해 비밀번호 보호 링크의 상세 정보를 해제
노트의 현재 공유 링크 정보를 조회해요. 현재는 레거시 노트 GUID만 지원돼요 — UUID 형식의 공유 ID를 전달하면 400 UUID_SHARE_ID_UNSUPPORTED 오류로 거부돼요(UUID→노트 매핑이 아직 구현되지 않았어요). 링크가 비밀번호로 보호된 경우, 접근을 검증하고 전체 응답을 해제하려면 password를 전달하세요. 필요한 Scope: mcp:note:read

​
파라미터

​
요청 예시

​
응답

필드 설명:
링크가 비밀번호로 보호됐는데 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 미지원

해결 방법: UUID가 아니라 list_notes / search_notes에서 받은 노트 GUID를 전달하세요.

​
권장 사례

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