You can have an AI agent put its review comments inside the document instead of in the chat. The GroupDocs.Annotation.Mcp server lets an LLM in Claude, Cursor or GitHub Copilot add highlights, notes and strikeouts to a PDF, Word, Excel or PowerPoint file, and it writes them locally on your machine:

페이지 2의 결제 조항을 강조하고, 법무팀에 확인을 요청하는 메모를 추가하세요.

구성 및 문제 해결이 포함된 단계별 버전은 문서에 있습니다: How to annotate documents with AI agents using MCP.

AI 피드백이 채팅 창에서 사라지는 이유는?

조수에게 계약서를 검토하도록 요청하면 “조항 4는 책임을 전가하고, 조항 7은 미정 날짜가 있다”와 같은 목록이 나옵니다. 이 목록은 대화 안에 머물고, 다음 주에 계약서를 여는 동료는 전혀 볼 수 없으며, 각 항목을 직접 해당 문단에 복사해야 합니다.

문제는 에이전트가 아니라, 파일에 쓸 방법이 없다는 점입니다. 리뷰는 독자가 텍스트 옆에서 바로 볼 수 있을 때만 유용합니다.

잘못된 접근 방식은 어떻게 보이나?

일반적인 우회 방법은 문서 텍스트를 채팅에 붙여넣고 의견을 요청하는 것입니다. 다음 세 가지 문제가 발생하며, 직접 문서에 적용해 확인할 수 있습니다:

  • 의견에 위치 정보가 없습니다. “페이지 2, 두 번째 단락”은 스스로 해결해야 하는 설명입니다.
  • 결과는 전달 가능한 산출물이 아니라 전사본입니다. 다음 검토자에게 보낼 수 있는 것은 스크린샷이나 붙여넣은 블록뿐입니다.
  • 문서는 변경되지 않으므로 리뷰를 필터링·집계하거나 다음 초안에 반영할 수 없습니다.

올바른 접근 방식: AI 에이전트로 문서에 주석 달기

각 측의 강점에 맞게 작업을 나눕니다. 에이전트는 “위험을 우리에게 전가하는 모든 항목을 표시하라”는 지시를 이해하고, 엔진은 실제 파일에 실제 주석을 씁니다. 주석을 쓰는 도구는 add_annotation이며, 다음 일곱 가지 주석 유형을 지원합니다: textfield, area, point, arrow, highlight, underline, strikeout. 인자는 파일, 유형, 텍스트, 1부터 시작하는 페이지 번호, 그리고 x/y 문서 좌표입니다.

결과는 원본 옆에 <name>_annotated.<ext> 형태로 저장됩니다. 원본은 절대 수정되지 않습니다. 동일한 호출이 엔진이 지원하는 50개 이상의 형식에 대해 동작하므로, Word 초안과 PDF가 동일한 방식으로 표시됩니다.

배치를 정확히 해주는 도구는?

페이지를 직접 볼 수 없는 에이전트에게 좌표는 가장 약한 부분이며, 문서에서도 이를 명확히 언급합니다. 다음 세 가지 도구가 추측을 줄여줍니다:

  • get_document_info는 파일 유형, 페이지 수, 크기와 함께 엔진이 제공하는 경우 페이지별 너비와 높이를 반환합니다. 이를 통해 에이전트는 페이지 박스를 기준으로 판단할 수 있습니다.
  • get_annotations는 기존 주석과 그 경계 상자를 반환하므로, 에이전트가 이를 앵커로 사용할 수 있습니다.
  • generate_pages_preview는 페이지를 이미지로 렌더링해 비전 모델이 텍스트 위치를 파악한 뒤 주석을 달 수 있게 합니다. 현재 Linux에서는 PDF 파일에 대해 실패합니다; 아래 제한 사항을 참고하세요.

연쇄 주석에서 한 가지 함정은?

모든 쓰기 도구는 새 파일을 저장합니다. 두 번째 주석은 첫 번째 호출이 만든 파일에 적용해야 하며, 원본에 적용하면 첫 번째 주석이 남아 아무도 다시 열지 않는 파일에 머무르게 됩니다. 프롬프트에 명시하세요:

결제 조항을 강조한 뒤, 결과 파일에서 오래된 배송 날짜를 취소선으로 표시하세요.

예시 세션 (요약)

다음은 도구들의 문서화된 동작을 기반으로 만든 예시이며, 실제 스크린샷이 아닙니다.

You:   페이지 2의 contract.pdf에서 결제 조항을 강조하고, 법무팀에 확인을 요청하는 메모를 추가하세요.

Agent: [calls get_document_info on contract.pdf]
       contract.pdf는 6페이지짜리 PDF입니다.
       [calls add_annotation: type=highlight, page=2, x=100, y=250,
        text="Legal to confirm these payment terms"]
       페이지 2에 강조 주석을 추가했습니다.
       주석이 달린 복사본은 contract_annotated.pdf입니다. 원본은 변경되지 않았습니다.

AI 클라이언트에서 주석 서버를 어떻게 시작하나요?

컨테이너로 실행하려면 문서가 들어 있는 폴더를 /data에 마운트합니다:

docker run --rm -i -v $(pwd)/documents:/data \
  -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output \
  ghcr.io/groupdocs-annotation/annotation-net-mcp:latest

컨테이너를 사용하고 싶지 않다면 .NET 10 SDK를 설치하고 dnx GroupDocs.Annotation.Mcp --yes를 실행하세요; Windows에서는 PDF 페이지 미리보기를 위해 이 채널을 사용합니다. 허브 페이지에는 Claude Desktop, Claude Code, VS Code with GitHub Copilot, Cursor, Windsurf 등 다양한 클라이언트를 위한 사전 등록 스니펫이 준비되어 있습니다. GROUPDOCS_MCP_OUTPUT_PATH를 저장 폴더와 다른 폴더로 지정한 뒤 생성된 파일에 대해 연쇄 편집을 수행하세요. 기본값(출력이 저장 폴더에 들어감)에서는 두 번째 쓰기가 being used by another process 오류로 실패하지만, 별도 출력 폴더를 지정하면 add_reply, update_annotation, remove_annotations가 모두 성공합니다. Docker 이미지 사용 시 -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output를 전달합니다. 등록 후 클라이언트가 서버를 자체 실행하고 stdio를 통해 통신하므로 네트워크 포트가 열리지 않으며, 서버가 클라우드 서비스로 문서 내용을 전송하지도 않습니다.

솔직한 제한 사항

  • Evaluation mode. 라이선스가 없으면 모든 페이지 상단에 시험 배지가 찍히므로, 주석이 달린 출력물을 배포할 수 없습니다. 먼저 “주석 서버의 라이선스 상태가 어떻게 되나요?”라고 물어보세요; 에이전트가 get_license_status를 호출합니다.
  • 도움 없이 배치는 대략적입니다. 프롬프트만으로 x/y를 추측하는 에이전트는 area 또는 point 주석을 대략적으로 배치합니다. 정확한 배치를 원한다면 먼저 읽거나 렌더링하세요.
  • Linux에서 미리보기. generate_pages_preview는 현재 Linux에서 PDF 파일에 대해 실패합니다. Docker 이미지에서도 TypeInitializationException for Gdip: System.Drawing.Common이 비 Windows 플랫폼을 지원하지 않기 때문입니다. Word 및 기타 Office 문서는 렌더링되며, Windows에서 dnx를 사용할 경우 모든 형식이 렌더링됩니다. 다른 열 가지 도구는 영향을 받지 않습니다.

FAQ

Claude가 PDF에 주석을 추가할 수 있나요?
예, 주석 도구를 노출하는 MCP 서버를 통해 가능합니다. GroupDocs.Annotation.Mcp를 사용하면 에이전트가 add_annotation을 호출하고, 주석이 <name>_annotated.pdf에 기록됩니다.

AI가 문서를 업로드해야 주석을 달 수 있나요?
아니요, 서버를 통해서는 업로드되지 않습니다. 서버는 마운트된 폴더에서 파일을 열고 주석이 달린 복사본을 옆에 저장합니다. 모델이 직접 보는 텍스트(붙여넣은 내용)나 페이지 이미지만 모델 제공업체에 전송됩니다.

PDF뿐 아니라 Word와 Excel에서도 작동하나요?
예. 동일한 주석 유형이 PDF, DOCX, XLSX, PPTX 및 이미지 등 50개 이상의 형식에서 동작합니다. 자세한 형식 목록은 문서를 참고하세요.

더 깊이 파고들기