레다션은 배포하려는 파일을 확인했을 때만 완전하다고 할 수 있으며, AI 에이전트가 몇 번의 호출만으로 로컬에서 그 검사를 수행할 수 있습니다. GroupDocs.Redaction.Mcp를 Claude Code, Cursor 또는 GitHub Copilot에 연결하면, 먼저 레다션된 복사본을 텍스트로 읽어 다시 검색합니다:
case-file_redacted.pdf의 텍스트를 추출하고 이메일 주소가 나타나는지 알려 주세요.
없을 것으로 기대합니다. 구성 및 문제 해결이 포함된 단계별 버전은 문서에 있습니다: 레다션이 완전한지 확인하는 방법.
“도구가 실행되었다”는 왜 증거가 되지 않을까?
오류 없이 끝난 레다션 도구는 패턴, 파일, 라이선스 상태 또는 데이터가 숨겨진 다른 위치에 대해 아무것도 말해 주지 못합니다. 검증되지 않은 레다션은 주장일 뿐, 통제가 아닙니다. 흔히 발생하는 오류는 특이하지 않으며, 실패 유형은 몇 가지에 불과합니다:
- 데이터가 제거되지 않고 가려졌습니다. 텍스트 위에 불투명 블록을 그리면 파일에 텍스트가 남아 있어 독자가 복사해 낼 수 있습니다. 위키피디아의 레다션 기사에서는 2005년 미국 군사 보고서(니콜라 칼리파리 사망 사건)가 PDF로 공개되었는데, 차단된 부분을 워드 프로세서에 복사·붙여넣기 하면 복원할 수 있었던 사례를 설명합니다(또한 BBC 뉴스, 2005년 5월 2일 참고).
- 패턴이 변형을 놓쳤습니다: 구분자가 다르거나, 줄 바꿈이 있거나, 대소문자가 다른 경우.
- 잘못된 파일에 단계가 적용되어, 이후 단계가 이전 단계를 되돌렸습니다.
- 주석이나 문서 속성에 여전히 사람 이름이 남아 있습니다.
- 라이선스가 없는 실행은 교체 한도에 도달하면 조용히 중단됩니다.
검증의 잘못된 방법은 무엇인가요?
에이전트에게 “모두 찾았나요?”라고 묻고 “예”라고 받아들이는 것입니다. 에이전트는 새로운 정보를 가지고 있지 않으며, 자신의 호출을 요약하고 있을 뿐입니다. 두 번째 잘못된 방법은 자신이 만든 파일을 검증하는 것입니다. 체인 규칙 때문에 단계가 누락된 문서를 검증하는 것이 완전히 가능할 수 있습니다.
올바른 검증 방법은? 네 가지 체크
배포하려는 정확한 파일에 대해 실행하십시오.
1. 레다션된 복사본을 텍스트로 다시 읽어 보기. 위의 프롬프트는 extract_text와 같은 텍스트 반환 도구를 사용합니다. 예: GroupDocs.Parser.Mcp의 extract_text(문서)는 Docker 이미지로 제공됩니다. 어느 한 곳이라도 일치하면 패턴이 변형을 놓쳤거나 평가 한도에 도달한 것입니다. 이 체크에 redact_text를 사용하지 마세요: 저장된 파일을 보고할 뿐이며, 카운트를 제공하지 않고 또 다른 복사본을 작성하므로 깔끔한 응답만으로는 증명되지 않습니다.
2. 다른 세 곳을 확인하기. 주석과 속성은 텍스트 검색에 나타나지 않습니다. GroupDocs.Annotation.Mcp 서버는 get_annotations를 통해 주석을 나열하며, 각 주석은 페이지와 메시지를 포함합니다.
이제 레다션된 복사본에서 주석을 확인하고 문서 속성을 읽어 주세요.
모든 패키지에 대한 보다 깊은 속성 검사를 위해, GroupDocs.Metadata.Mcp 서버의 read_metadata 도구는 모든 메타데이터 속성을 JSON 형태로 반환하고 EXIF, XMP, IPTC도 읽어옵니다. 이것이 교차 서버 루프입니다: 레다션 서버가 제거하고, 두 번째 서버가 다시 읽어옵니다.
3. 페이지를 살펴보기. 영역 레다션은 텍스트 검색으로 검증할 수 없습니다. 문서를 열거나, 에이전트에게 GroupDocs.Viewer.Mcp의 render_page 도구로 모든 페이지를 렌더링하도록 하고, 각 박스가 의도한 영역을 정확히, 완전히, 올바른 페이지에 가려 놓았는지 확인하십시오.
4. 해당 실행의 라이선스 상태 확인하기.
레다션 서버의 라이선스 상태는 무엇인가요?
답변이 evaluation이면 레다션이 네 번의 교체로 제한되었습니다. 검증은 보통 이를 보여 주지만, 정확히 네 번 일치하는 문서는 통과하면서도 여전히 잘못될 수 있습니다. 항상 먼저 라이선스를 확인하고, 그 다음 검증하십시오. get_license_status가 첫 번째 질문에 답하고, get_document_info는 영역 레다션이 포함된 경우 페이지 수와 크기를 반환합니다.
예시 세션 (요약)
You: What is the license status of the redaction server?
Agent: -> get_license_status() mode: licensed
You: Extract the text of case-file_redacted.pdf and tell me whether any email address appears.
Agent: -> extract_text (Parser server) No email addresses in the extracted text.
You: Now check it for annotations and read its document properties.
Agent: -> get_annotations (Annotation server) no annotations
-> read_metadata (Metadata server) Author, Company: empty
You: Summarize what you redacted, in which file, and what the verification found.
증거를 어떻게 보관하나요?
검증 전사(사용된 패턴, 생성된 파일, 읽어본 결과)는 레다션이 수행되고 확인되었음을 기록합니다. 에이전트에게 요약을 요청하고 케이스 파일과 함께 보관하십시오. 이는 감사 추적에 적합하지만 결과에 대한 인증은 아닙니다.
검증으로 알 수 없는 점은 무엇인가요?
패턴이 올바른지 여부는 알려 주지 못합니다. 위 내용은 요청한 내용이 제거되었음을 보여 줍니다. 무엇을 제거할지는 사용자의 판단이며, 이를 대신해 줄 도구는 없습니다.
평가 모드의 제한은 무엇인가요?
프로세스당 하나의 문서, 하나의 레다션, 최대 4번 교체, 그리고 체험 배지 포함. 이 한도는 데모 제한이며, 라이선스가 없는 실행은 레다션된 것처럼 보이지만 여전히 데이터를 포함할 수 있으므로, 어떤 검증을 신뢰하기 전에 get_license_status를 확인하십시오.
- PDF on Linux. Linux(및 Docker 이미지)에서는
redact_image_area와erase_metadata가 현재 PDF 파일에서 실패합니다(PDF 엔진의 이미지 처리가System.Drawing에 의존하는데, .NET은 Windows에서만 지원). 두 도구는 Word 문서에서는 작동하고,redact_text는 PDF에서 작동합니다. Windows에서dnx를 사용해 PDF 영역 레다션 및 메타데이터 삭제를 실행하십시오.
FAQ
내 레다션된 PDF가 정말 레다션되었나요? 레다션된 복사본을 텍스트로 다시 읽어 보았을 때 제거된 값이 전혀 없고, 주석과 속성이 명확하며, 영역 레다션을 확인했을 때만 그렇습니다. 네 가지 모두를 확인하는 데 몇 번의 호출만 필요합니다.
AI 에이전트가 레다션된 PDF에서 누수가 있는지 확인할 수 있나요? 에이전트는 텍스트를 다시 읽고, 메타데이터 서버를 통해 속성을 읽으며, 페이지를 렌더링해 보여줄 수 있습니다. 그러나 올바른 패턴을 선택했는지는 판단하지 못합니다.
텍스트 레다션 후에도 메타데이터가 남나요? erase_metadata를 함께 실행하지 않는 한 메타데이터는 남습니다. 텍스트 레다션은 텍스트만 변경하고, 작성자, 회사, 날짜와 같은 속성은 별개입니다.
더 깊이 들어가기
- 문서, 정식 가이드: 레다션이 완전한지 확인하는 방법
- 문서 허브: GroupDocs.Redaction MCP Server
- 시작하기: AI 에이전트와 MCP로 민감 데이터 레다션하는 3가지 방법
- 관련: MCP를 활용한 자동 AI 워크플로우로 공개 레다션 정책 적용
- 관련: 텍스트가 없는 스캔 문서 레다션
- 온프레미스 및 보안 모델: AI 문서 처리 3가지 아키텍처와 네트워크 내부에 파일을 보관하는 방법
- 질문: GroupDocs Redaction 포럼
- 소스: GroupDocs.Redaction.Mcp on GitHub