mail_list_folder_messages의 from(오프셋) 파라미터가 무시됩니다.
안녕하세요.
네이버웍스 공식 MCP 서버(mcp.worksmobile.com/mcp)를 Claude에 연결해 사용 중, mail_list_folder_messages 도구의 페이지네이션이 동작하지 않는 문제를 발견하여 제보드립니다.
■ 현상
from 파라미터에 어떤 값을 넣어도 항상 최신 메일부터 count 개수만큼 반환됩니다. 두 번째 페이지 이후로 진행할 수 없습니다.
■ 재현 절차
총 534건이 있는 보낸메일함(folderId=1)에서 count를 고정하고 from만 변경했습니다.
1) from=1, count=5
→ 반환: 최신 5건 (mailId 17996 ~ 17814)
→ responseMetaData.nextCursor 디코딩값: {"nextCursor":"6","pageSize":"5"}
2) from=6, count=5
→ 반환: 1)과 완전히 동일한 5건
→ nextCursor 디코딩값: {"nextCursor":"6","pageSize":"5"} ← 1)과 동일
3) from=530, count=3 (전체 534건 중 끝부분 요청)
→ 반환: 여전히 최신 3건 (mailId 17996 ~ 17884)
→ nextCursor 디코딩값: {"nextCursor":"4","pageSize":"3"}
받은메일함(folderId=0, 9,604건)에서도 from=1 / 61 / 300 모두 동일하게 최신 메일부터 반환되는 것을 확인했습니다.
■ 핵심 근거
from=6으로 호출했는데 응답의 nextCursor가 여전히 6입니다. 서버가 "방금 1~5번을 반환했다"고 인식하고 있다는 의미입니다. from=530일 때도 nextCursor가 4(=count+1)로, 오직 count 값에서만 파생됩니다. 즉 from 입력값이 요청 처리 과정에서 전혀 반영되지 않습니다.
■ 추정 원인
응답에 base64 인코딩된 nextCursor가 포함된 것으로 보아 하위 API는 커서 기반 페이지네이션을 사용하는 것으로 보입니다. MCP 도구 스키마는 오프셋 방식인 from을 노출하고 있으나, 이 값을 하위 API의 cursor 파라미터로 매핑하지 않는 것 같습니다.
■ 요청 사항
둘 중 하나로 처리해 주시면 감사하겠습니다.
1) from을 실제 오프셋으로 동작하도록 수정
2) from을 제거하고 응답의 nextCursor를 그대로 받는 cursor 파라미터를 노출 (note_list_posts 등 다른 도구는 이미 cursor 방식을 쓰고 있어 일관성 측면에서도 이쪽이 나아 보입니다)
■ 영향도
현재는 폴더의 최신 N건 외에는 접근이 불가능합니다. count 최댓값이 500이라 그 이상 과거 메일은 어떤 방법으로도 조회할 수 없습니다. 메일 수천 건 규모의 계정에서는 최근 며칠치만 다룰 수 있어 기간 기준 업무 분석 용도로는 사용이 어렵습니다.
확인 부탁드립니다. 감사합니다.
게시글에 새로운 댓글이 달리면 알림을 전송합니다.
댓글0
궁금한 점을 해결하지 못하셨나요?
지금 바로 NAVER WORKS 사용자들에게 물어보세요!