개요
get_share_link 도구는 노트의 공개 공유 링크를 조회해요. 공유 링크를 쓰면 인증 없이도 외부에서 회의 노트를 열어볼 수 있어요.
사용 가능한 도구는 get_share_link 하나예요.
공유 링크를 생성하거나 삭제하는 작업은 MCP로는 할 수 없어요. 이 쓰기 작업에는
mcp:notes:write scope가 필요한데, MCP 서버는 아직 이 scope를 노출하지 않아요. 공유 링크를 생성하거나 삭제하려면 REST API를 사용하세요 — PUT / DELETE /v1/external/notes/{noteGuid}/share-link.- 노트에 이미 공개 공유 링크가 있는지 확인
- 노트의 공유 URL을 조회해 전달
- 비밀번호를 입력해 비밀번호 보호 링크의 상세 정보를 해제
get_share_link
노트의 현재 공유 링크 정보를 조회해요. 공유 UUID(새 형식)나 노트 GUID(레거시) 중 하나를 받아요. 링크가 비밀번호로 보호된 경우, 접근을 검증하고 전체 응답을 해제하려면password를 전달하세요.
필요한 Scope: mcp:notes:read
파라미터
요청 예시
응답
링크가 비밀번호로 보호됐는데
password 없이 get_share_link를 호출하면, 응답에 requiresPasswordVerification: true가 포함되고 검증 플래그는 생략돼요. 잘못된 비밀번호를 제공하면 401 Unauthorized를 반환해요.자주 발생하는 오류
노트를 찾을 수 없음
해결 방법:noteGuid가 올바른지 확인하세요. search_notes로 유효한 노트 식별자를 찾으세요.
공유 링크를 찾을 수 없음
해결 방법: 노트에 아직 공유 링크가 없어요. Tiro 앱이나 REST API(PUT /v1/external/notes/{noteGuid}/share-link)로 하나 만드세요.
권장 사례
공유하기 전에 링크가 있는지 확인하세요
공유하기 전에 링크가 있는지 확인하세요
누군가에게 URL을 보내기 전에
get_share_link로 노트에 활성 공개 링크가 있는지 확인하세요.