문서를 자동으로 브랜드화하려면 AI 에이전트에게 하나의 고정 지시를 제공하고, 아웃고잉 폴더의 모든 파일에 대해 로컬 이미지 워터마크 도구를 호출하도록 합니다. GroupDocs.Watermark.Mcp 서버와 함께라면 해당 지시는 규칙 파일의 한 줄, Claude Code의 프로젝트 지시, 혹은 Cursor에 붙여넣는 프롬프트가 될 수 있습니다:

아웃고잉 폴더의 각 파일의 모든 페이지에 logo.png를 25% 불투명도로 삽입하고, 만든 파일들을 나열하십시오.

구성 및 문제 해결이 포함된 단계별 버전은 문서에 있습니다: AI를 사용하여 로고 워터마크로 문서에 브랜드 적용하는 방법.

수동 브랜딩이 왜 변동되는가?

수동으로 적용된 브랜드는 사람마다 다릅니다: 한 팀은 로고를 원본 파일에 붙이고, 다른 팀은 PDF에 전체 강도로 스탬프를 찍으며, 또 다른 팀은 잊어버립니다. 문서 내용을 편집하여 “로고를 추가한다"는 LLM도 안정적인 위치를 보장하지 못합니다. add_image_watermark 도구는 로고를 워터마크 객체로 적용하며, 명시적인 opacity와 rotation 값을 사용하므로 동일한 입력은 동일한 강도와 각도를 제공합니다. 객체이기 때문에 붙여넣은 내용이 아니라, 브랜드가 바뀔 때 로고를 찾아 제거할 수 있습니다.

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

단계 에이전트가 결정하는 것 엔진이 수행하는 일
범위에 포함되는 파일 폴더와 지시를 읽음 없음
호출할 도구 add_image_watermark(로고용), add_watermark(상태용) 없음
강도와 각도 표준에서 opacity와 rotation을 전달 해당 값으로 정확히 마크를 그림
출력 생성된 파일을 보고 새 파일을 작성; 원본은 수정되지 않음

표준은 프롬프트에 존재합니다. 서버는 스스로 스케줄링하지 않으며 내장된 브랜드 정책이 없습니다; 반복 가능한 부분은 저장하고 재사용하는 지시입니다.

다섯 단계로 표준을 어떻게 적용하나요?

  1. 문서 옆에 로고를 보관하십시오. 문서와 이미지는 모두 저장 폴더(GROUPDOCS_MCP_STORAGE_PATH)에서 이름으로 해결됩니다. 투명 PNG를 사용하십시오; 흰 사각형 위에 로고가 있으면 페이지에 그 사각형이 표시됩니다.
  2. 아웃고잉 파일을 분리하십시오. 브랜드가 적용된 복사본을 원본과 별도로 보관하려면 GROUPDOCS_MCP_OUTPUT_PATH를 다른 폴더로 설정하십시오. 설정되지 않으면 출력이 저장 폴더로 이동합니다.
  3. 라이선스를 확인하십시오. 다음과 같이 물어보세요: “워터마크 서버의 라이선스 상태는 무엇인가요?” 에이전트는 get_license_status를 호출합니다.
  4. 표준 프롬프트를 실행하십시오. 불투명도 0.2~0.4가 문서에서 브랜드 적용을 권장하는 범위이며, 0.6 이상이면 로고가 페이지를 지배합니다.
  5. 검증하십시오. 각 생성된 파일에 대해 search_watermarks를 실행하도록 요청하고, 기대하는 개수와 비교하십시오.

마크에 상태를 표시할 수도 있나요?

예, 두 번째 연쇄 호출을 사용하면 가능합니다. 하나의 요청으로 브랜드와 상태를 지정합니다:

로고를 25% 불투명도로 추가한 뒤, 그 결과에 CONFIDENTIAL 텍스트 워터마크를 추가하십시오.

각 호출은 새 파일을 작성하므로, “그 결과에"라는 표현이 두 마크를 모두 유지하게 합니다.

예시 세션 (축약)

사용자:    report.pdf에 logo.png를 30% 불투명도로 삽입하십시오.
에이전트:  [add_image_watermark: watermarkImage logo.png, opacity 0.3]
        "logo.png"에서 "report.pdf"로 이미지 워터마크를 추가했습니다.
사용자:    너무 강합니다 - 0.2로 다시 해 주세요.
에이전트:  [add_image_watermark: opacity 0.2, from the original report.pdf]
        "logo.png"에서 "report.pdf"로 이미지 워터마크를 추가했습니다.
        브랜드가 적용된 복사본이 두 개 존재합니다. 필요하지 않다면 0.3 복사본을 삭제하십시오.

이와 같이 반복하면 각 시도가 새로운 파일이므로 안전합니다. 이후에 거부된 파일을 삭제하십시오.

팀 배포에 적합한 전달 채널은 무엇인가요?

공유 설정의 경우 Docker 이미지가 각 머신에 별도로 설치할 필요가 없으며, 런타임과 네이티브 종속성이 이미지 내부에 포함되어 있습니다:

docker run --rm -i -v $(pwd)/documents:/data \
  ghcr.io/groupdocs-watermark/watermark-net-mcp:latest

NuGet 채널(dnx GroupDocs.Watermark.Mcp --yes)은 .NET 10 SDK가 필요합니다. 두 방식 모두 Windows, Linux, macOS에서 실행되며(dnx는 Linux/macOS에서 libgdiplus도 필요), 동일한 여섯 가지 도구를 사용하므로 브랜드 프롬프트는 두 방식 간에 변하지 않습니다.

제한 사항은 무엇인가요?

두 가지 제한을 고려하십시오. 첫째, 도구는 opacity와 rotation만 노출합니다: 위치, 크기 또는 여백 설정은 없습니다. 둘째, 평가 모드: 서버의 라이선스 페이지에 따르면 라이선스가 없는 출력은 평가 제한이 적용됩니다(정확한 제한은 라이브러리의 라이선스 페이지에서 확인할 수 있음). 따라서 라이선스 없이 생성된 브랜드 복사본은 배포할 수 없습니다. 브랜드 배포 전에 get_license_status를 실행하십시오. 사용량 기반 라이선스에서는 처리된 각 파일에 비용이 청구되고, 라이선스 파일이 있으면 서버가 오프라인으로 작동합니다. 또한 워터마크는 문서에 라벨을 붙이는 것이며, 그 아래의 콘텐츠를 보호하지는 않는다는 점을 기억하십시오.

FAQ

AI가 모든 PDF에 우리 회사 로고를 추가할 수 있나요?
예. 파일 이름으로 로고를 지정하고 불투명도를 제공하면 에이전트가 파일당 add_image_watermark를 호출합니다. 동일한 호출은 Word, PowerPoint, Excel 및 이미지 파일에서도 작동합니다.

이미지와 문서에 동일한 로고를 사용할 수 있나요?
예. 이미지는 유효한 대상이므로 제품 사진에 브랜드를 적용하는 것이 PDF에 적용하는 것과 동일합니다.

브랜드가 변경되면 어떻게 되나요?
remove_watermarks를 사용하면 이전 로고를 제거할 수 있습니다. 이는 워터마크 객체로 적용되었기 때문입니다. textFilter는 워터마크 텍스트만 일치시키므로 이미지 로고를 제거하면 텍스트 마크를 포함한 모든 워터마크가 제거됩니다. 먼저 검색하여 현재 상황을 파악한 뒤 새 로고를 추가하십시오.

더 깊이 알아보기