한 번의 프롬프트로 문서 폴더에 워터마크를 추가할 수 있습니다: AI 에이전트가 파일 목록을 나열하고, 파일당 한 번씩 워터마크 도구를 호출하며, 생성된 결과를 보고합니다. 모든 작업은 로컬에서 수행되며 업로드가 없습니다. Claude Desktop, Claude Code, Cursor 또는 Windsurf에서 요청은 다음과 같습니다:

내 문서 폴더에 있는 모든 PDF에 대각선 DRAFT 워터마크를 추가하고, 생성된 파일 목록을 알려 주세요.

구성 및 문제 해결이 포함된 단계별 버전은 문서에 있습니다: AI 에이전트를 사용해 문서 폴더에 일괄 워터마크를 적용하는 방법.

왜 한 번만 스탬프를 찍는 대신 라이프사이클 단계별로 스탬프를 찍나요?

제안서 팩은 한 번만 표시되는 경우는 거의 없습니다. 처음에는 DRAFT로 시작하고, 동료에게 전달될 때 FOR REVIEW가 되며, 승인되면 표시가 사라집니다. 30개의 파일에 대해 수작업으로 이 작업을 수행하는 것은 마감 시간에 생략되는 일입니다. GroupDocs.Watermark.Mcp를 사용하면 각 단계가 한 문장으로 표현되며, 에이전트가 스크립트 대신 루프를 제공해 줍니다. 엔진이 형식을 처리하므로 동일한 프롬프트가 PDF, Word, Excel, PowerPoint 및 이미지 파일을 한 폴더에서 모두 커버합니다.

단계 1: 모든 파일에 초안 워터마크를 어떻게 추가하나요?

GROUPDOCS_MCP_STORAGE_PATH를 폴더로 지정합니다. 파일은 이름으로 해결되므로 에이전트는 proposal-01.pdf를 전달하고, 머신의 경로는 전달하지 않습니다. 그런 다음:

내 문서 폴더에 있는 모든 PDF에 대각선 DRAFT 워터마크를 추가하고, 생성된 파일 목록을 알려 주세요.

에이전트는 파일당 add_watermark를 호출합니다. 각 호출은 새로운 워터마크가 적용된 복사본을 저장하고 원본은 그대로 두어, 원본 폴더가 워터마크가 없는 버전의 기록으로 유지됩니다.

단계 2: 검토 스탬프로 전환하려면 어떻게 하나요?

단계 1 후에는 모든 파일에 DRAFT가 적용되므로, 표시를 교체합니다: 텍스트로 기존 표시를 제거하고, 결과에 새 스탬프를 붙입니다.

이 폴더의 모든 파일에서 DRAFT 워터마크를 제거하고, 각 결과에 FOR REVIEW 워터마크를 추가해 주세요.

에이전트는 textFilter를 DRAFT로 설정하여 remove_watermarks를 호출한 뒤, 정리된 각 복사본에 add_watermark를 호출합니다. 일부 파일에만 표시가 있고 일부는 없는 혼합 상태의 폴더에 대해서는, 먼저 에이전트에게 다음과 같이 지시합니다:

이미 워터마크가 있는 파일을 제외하고 모든 파일에 FOR REVIEW를 표시해 주세요.

각 파일에 search_watermarks를 실행하고 표시가 반환되는 파일은 건너뜁니다. 형식별로 다른 표시를 원한다면 다음과 같이 말합니다:

슬라이드 데크에는 로고를, PDF에는 텍스트 표시를 추가해 주세요.

단계 3: 작업이 승인될 때 표시를 어떻게 제거하나요?

승인은 요구 사항을 반전시킵니다. 동일한 폴더에서, 여러분의 문서로:

이 폴더의 모든 파일에서 DRAFT 워터마크를 제거하고, 나머지 표시들은 유지해 주세요.

이는 textFilter를 “DRAFT"로 설정한 remove_watermarks입니다. 필터는 대소문자를 구분하지 않는 부분 문자열 매치이며, 필터를 지정하지 않으면 엔진이 식별할 수 있는 모든 워터마크가 제거됩니다. 결과는 <name>_unwatermarked.<ext> 형태로 저장됩니다. 자세한 내용은 아래에 링크된 제거 전 검색에 관한 보조 게시물에 있습니다.

예시 세션 (요약)

You:    Add a diagonal DRAFT watermark to every PDF in my documents
        folder, then list the files you produced.
Agent:  [add_watermark x 3: text "DRAFT", rotation -45]
        Added text watermark "DRAFT" to "proposal-01.pdf"
        Added text watermark "DRAFT" to "proposal-02.pdf"
        Added text watermark "DRAFT" to "proposal-03.pdf"
        Produced 3 watermarked copies. 0 failures.
        Originals are unchanged.

원본 및 출력 폴더는 어떻게 되나요?

기본적으로 입력과 출력이 하나의 폴더를 공유하므로 워터마크가 적용된 복사본이 원본 옆에 위치합니다. 깔끔하게 구분하고 싶다면 GROUPDOCS_MCP_OUTPUT_PATH를 별도 폴더로 설정하고 그곳에서 배포하세요. 어느 경우든 원본은 절대 덮어쓰여지지 않으므로, 원본 파일이 변경된 후에도 단계를 다시 실행할 수 있습니다; 다시 처리하고 싶은 파일명을 지정하면 됩니다.

배치를 신뢰성 있게 유지하려면 어떻게 하나요?

  • 생성된 파일 목록을 요청하세요. “완료"만 보고하는 실행은 어떤 복사본을 배포해야 할지 추측하게 만듭니다.
  • 실패를 명시적으로 요청하세요. 혼합된 폴더에 엔진이 워터마크를 적용할 수 없는 형식이 포함될 수 있습니다. 호출이 silently 스킵되지 않고 메시지와 함께 실패하므로, 실패 목록을 요청하세요.
  • 계량 사용량을 유의하세요. 계량 라이선스에서는 각 파일이 처리된 만큼 청구됩니다.
  • 먼저 라이선스를 확인하세요. 평가 모드의 배치는 낭비된 실행입니다.

제한 사항은 무엇인가요?

평가 모드가 주요 제한입니다: 서버의 라이선스 페이지에 따르면 비라이선스 출력에는 평가 제한이 적용됩니다; 정확한 제한은 라이브러리의 라이선스 페이지. 평가 모드 복사본이 있는 폴더는 배포할 수 없는 초안 폴더와 같습니다. 실행 전에 에이전트에게 get_license_status를 호출하도록 요청하면, mode가 평가, 라이선스 또는 계량 중 어느 것인지 보고합니다. 또한 내장 스케줄러가 없으며, 서버는 에이전트가 요청할 때 작동하므로 정기 작업을 위해서는 클라이언트나 프롬프트를 전송하는 작업 실행기가 필요합니다.

FAQ

AI가 여러 PDF에 동시에 워터마크를 적용할 수 있나요?
예. 에이전트가 폴더를 순회하며 파일당 add_watermark를 호출하고, 생성된 복사본을 나열합니다. 각 파일은 개별적으로 처리됩니다.

폴더의 모든 문서에 CONFIDENTIAL을 추가할 수 있나요?
예. 프롬프트에서 DRAFT를 CONFIDENTIAL로 교체하면 됩니다. 이미 표시가 있는 파일을 건너뛰어야 하는지 명확히 지정하세요.

업로드 없이 로컬에서 대량 워터마크가 가능한가요?
예. 서버는 클라이언트가 시작하는 로컬 프로세스로, 설정한 폴더를 읽고 씁니다.

더 깊이 파고들기