A document comparison rule is only enforced if every pair gets compared, not the ones someone had time for. With the GroupDocs.Comparison.Mcp server, one prompt makes Claude Desktop, Claude Code, Cursor or GitHub Copilot compare every version pair in a folder locally and report which documents changed:

For every -v1/-v2 pair in my documents folder, compare the two and tell me which invoices changed and how. One line per invoice.

The step-by-step version with config and troubleshooting is in the documentation: How to batch-compare document versions in a folder.

비교를 수동으로 할 때 어떤 검사가 실패하나요?

세 가지 상황이 반복해서 나타나며, 각각에서 확인되지 않은 문서가 중요한 역할을 합니다:

  • 재발행된 배치. 새로운 배치가 승인된 내용과 일치하는지 확인해야 합니다.
  • 벤더의 “변경 없음” 진술. 벤더가 문서가 변하지 않았다고 주장하지만, 증거가 필요합니다.
  • 마이그레이션. 시스템이나 형식이 바뀐 문서이며, 출력이 입력과 동일해야 합니다.

각 경우에서 비용은 비교 자체가 아니라 모든 파일에 대해 비교를 실행하는 규율에 있습니다. 폴더를 순회하는 에이전트를 사용하면 이 규율 문제를 없앨 수 있습니다.

워크플로는 어떻게 실행되나요?

  1. 쌍의 이름을 일관되게 지정합니다. 예를 들어 invoice-001-v1.pdf와 invoice-001-v2.pdf처럼 하나의 폴더에 두 파일을 넣습니다.
  2. 서버에 폴더 경로를 지정합니다. GROUPDOCS_MCP_STORAGE_PATH 환경 변수를 해당 경로로 설정합니다. 파일은 이름으로 매칭되므로 에이전트는 invoice-001-v1.pdf만 전달하고 전체 경로는 전달하지 않습니다.
  3. 라이선스 모드를 확인합니다. “비교 서버의 라이선스 상태가 어떻게 되나요?”라고 물으면 에이전트가 get_license_status를 호출합니다.
  4. 스윕을 실행합니다. 이 글 시작 부분의 프롬프트를 사용합니다. 에이전트는 각 쌍마다 analyze_changes를 한 번씩 호출합니다.
  5. 중요한 결과만 렌더링합니다. “변경된 세 개에 대해 주석이 달린 복사본을 만들어 주세요.”라고 요청하면 에이전트가 해당 세 개에 대해 compare를 호출하고, 각 결과를 <source-stem>_compared<ext> 형태로 저장합니다. 기존 파일은 절대 덮어쓰지 않습니다.

analyze_changes는 스윕에만 사용하고, 예외적인 경우에만 compare를 사용하세요. 아무도 열어보지 않는 30개의 주석 문서를 렌더링하는 것은 같은 답을 얻기 위해 30배의 작업을 하는 셈입니다.

에이전트는 무엇을 결정하고 엔진은 무엇을 수행하나요?

단계 에이전트 엔진
-v1/-v2 쌍 찾기 이름과 일치
각 쌍 비교 analyze_changes 호출 페이지 및 표 셀별로 변경 감지
쌍이 변경되지 않았다고 판단 No changes detected 읽음 해당 결과 반환
사용자에게 보고 각 쌍당 한 줄 작성
변경된 파일에 대해 파일 생성 compare 호출 주석이 달린 문서 렌더링

합격/불합격 판단은 에이전트의 텍스트 인상에 의한 것이 아니라 엔진의 결과에 의해 이루어집니다.

예시 세션

요약 및 예시; 실제 문구는 클라이언트와 모델에 따라 달라집니다.

You:    For every -v1/-v2 pair in my documents folder, compare the
        two and tell me which invoices changed and how. One line
        per invoice.

Agent:  [calls analyze_changes: invoice-001-v1.pdf, invoice-001-v2.pdf]
        [calls analyze_changes: invoice-002-v1.pdf, invoice-002-v2.pdf]
        [calls analyze_changes: invoice-003-v1.pdf, invoice-003-v2.pdf]

        invoice-001: no changes detected
        invoice-002: changes detected (see the list for the pages)
        invoice-003: changes detected (see the list for the pages)

배치 실행의 제한은 무엇인가요?

  • 문서당 평가 제한. 라이선스가 없으면 각 문서의 처음 2페이지만 비교되고 결과에 워터마크가 붙어 배치 보고서가 조용히 불완전해집니다. 스윕을 신뢰하기 전에 get_license_status를 확인하세요.
  • 쌍 내 동일 형식. 두 파일 형식이 다르면 먼저 변환해야 합니다.
  • 잘못된 이름은 치명적이지 않음. 도구는 확인 가능한 파일 목록을 반환하고, 에이전트가 스스로 수정하여 다시 시도합니다.
  • 긴 스윕은 시간이 걸림. 각 쌍은 실제 비교이며, 대용량 PDF 폴더는 초가 아니라 분 단위가 소요됩니다. 진행 상황을 요청하세요.

FAQ

AI로 여러 PDF 파일을 한 번에 비교할 수 있나요?
예. 쌍을 하나의 폴더에 넣고 에이전트에게 각 쌍을 비교하도록 요청하면 됩니다. 에이전트는 각 쌍마다 analyze_changes를 한 번씩 호출하고, 통합된 답변을 제공합니다.

문서의 무단 변경을 어떻게 감지하나요?
승인된 버전과 유통 중인 버전을 비교하고, 에이전트에게 변경이 감지된 쌍을 나열하도록 요청합니다. No changes detected를 반환한 모든 쌍은 내용이 동일합니다(단, 평가 모드에서는 각 문서의 처음 2페이지만 비교됩니다).

파일이 내 컴퓨터를 떠나나요?
아니요. 비교는 로컬 프로세스에서 구성한 폴더를 대상으로 실행됩니다. 프롬프트 텍스트와 에이전트가 보고하는 라인만 사용 중인 모델에 전달됩니다.

더 깊이 파고들기