“이 여행 정책 PDF에서 호텔 상한을 변경해 주세요"는 사람들이 매일 AI 에이전트에게 하는 요청이며, PDF는 변경되지 않도록 만들어진다: 페이지 설명일 뿐, 문서가 아니다. 유용한 답변은 변환이다. GroupDocs.Editor MCP 서버를 로컬에서 실행하면 Claude, Cursor 또는 Copilot이 PDF를 편집 가능한 HTML로 변환하고, 이를 Word 문서로 저장한 뒤 Word 복사본에서 텍스트, 단락 및 번호 매긴 섹션을 그대로 유지하면서 변경을 수행한다. 업로드되는 내용은 전혀 없다:

travel-policy.pdf를 편집 가능한 Word 문서로 변환한 다음, 호텔 상한을 160 EUR에서 175 EUR로 변경하십시오.

단계별 버전은 문서에 있다: AI 에이전트로 PDF를 편집 가능한 Word 문서로 변환하는 방법.

에이전트가 “PDF 편집”을 의미해야 하는 것

에이전트가 PDF 편집을 요청받았을 때 할 수 있는 일은 세 가지이며, 그 중 하나만이 정직하다.

  • 가장하기: 텍스트를 읽고 자신의 복사본에서 새 문서를 작성한 뒤 이를 “편집된 PDF”라고 부른다. 레이아웃, 글꼴 및 모델이 주의 깊게 읽지 않은 모든 것이 사라지고, 응답에 그 사실이 언급되지 않는다.
  • 페이지에 패치하기: 기존 텍스트 위에 새 텍스트를 그린다. 양식의 오타 수정에는 작동하지만, 문장이 길어지거나 줄이 추가되는 등 흐름이 바뀌는 경우에는 실패한다.
  • 변환하기: PDF를 편집을 위해 설계된 형식으로 변환하고, 그곳에서 변경을 수행한 뒤 필요하면 다시 PDF를 반환한다. 이 서버가 수행하는 작업이며, 응답에서도 그렇게 명시한다.

호출

GroupDocs.Editor.Mcp 26.10.0을 사용해 합성된 3페이지 여행 정책에 대해 캡처한 내용:

-> get_document_info {"file":{"filePath":"travel-policy.pdf"}}
<- { "family": "FixedLayout", "pageCount": 3, "canEdit": true,
     "canSaveTo": [ "docx", "doc", "rtf", "odt", "pdf", "md", ... ] }

-> extract_html {"file":{"filePath":"travel-policy.pdf"},"pages":"1-2"}
<- Extracted 'travel-policy.pdf' as editable HTML
   Saved to: …/travel-policy_pages1-2.html
   Preview (plain text): Travel Policy - Northwind Traders Version 4,
   effective 1 March 2026 Scope This policy applies to every employee ...

-> save_from_html {"htmlFile":{"filePath":"travel-policy_pages1-2.html"},
                   "format":"docx","outputName":"travel-policy.docx"}
<- Saved 'travel-policy_pages1-2.html' as DOCX
   Saved to: …/travel-policy.docx

-> replace_text {"file":{"filePath":"travel-policy.docx"},
                 "find":"160 EUR","replace":"175 EUR"}
<- Replaced 1 occurrence(s) of '160 EUR' in 'travel-policy.docx'
   Saved to: …/travel-policy_edited.docx

네 개의 호출: 검사, 추출, Word 저장, 편집. 마지막 단계는 에이전트가 모든 Word 파일에 사용하는 동일한 replace_text이며, 이는 먼저 변환하는 것이 핵심이다. 내용이 문서가 되면 모든 편집 도구를 적용할 수 있다.

이 캡처는 평가 모드에서 실행되었으므로 페이지 1–2만 추출했으며, Word 복사본은 세 페이지 중 두 페이지만 포함한다. 라이선스를 사용하면 pages를 생략하고 전체 정책을 포함한 Word 복사본을 얻을 수 있다.

travel-policy.pdf (3 pages, FixedLayout)
   |-- extract_html {"pages":"1-2"} ---> travel-policy_pages1-2.html
   |-- save_from_html {"format":"docx"} ---> travel-policy.docx
   '-- replace_text {"find":"160 EUR","replace":"175 EUR"}
          ---> travel-policy_edited.docx   (editable Word, change made)
   need a PDF again?  save_from_html / replace_text with "format":"pdf"

대상 선택

Word는 자연스러운 대상이다. 왜냐하면 재흐름이 가능하기 때문이다: 더 긴 문장은 다음 문장을 위에 겹치지 않고 아래로 밀어낸다. get_document_info는 여기서 PDF를 저장할 수 있는 모든 형식을 나열한다(예: DOCX, DOC, RTF, ODT, Markdown, EPUB 및 다시 PDF). Markdown은 “편집”이 실제로 “내 문서 저장소에 넣기”일 때 좋은 선택이며, PDF는 변경 사항을 동일한 형식으로 다시 내보내야 할 때 선택한다. replace_text에 "format":"pdf"를 지정하면 Word에 내용이 있을 때 한 번의 호출로 편집과 변환을 동시에 수행한다.

pages는 범위를 지정하므로 40페이지 보고서 전체를 에이전트를 통해 처리하지 않고도 3페이지의 날짜만 수정할 수 있다. skipImages는 텍스트만 중요할 때 이미지를 제외하고, pagination: true는 레이아웃이 페이지별로 중요한 경우 HTML에 페이지 경계를 유지한다.

충실도: 기대할 수 있는 것

PDF는 각 글리프가 어디에 위치하는지를 기록할 뿐, 제목이나 단락이 무엇인지는 기록하지 않는다. 변환은 구조를 재구성하며, 정책, 보고서, 계약서와 같은 디지털 원본 문서에 대해서는 잘 수행한다. 우리 여행 정책에서는 제목과 버전 라인이 단락으로, 번호 매긴 섹션(“1. Scope”, “2. Booking”, “3. Allowances”)이 번호 매긴 목록으로 복원되어 모두 편집 가능한 텍스트가 된다. 재구성되는 것은 구조이며, 여러분의 스타일은 아니다: PDF가 굵은 14포인트 글꼴로 그린 섹션은 목록 항목이나 단락으로 복원되고, 템플릿의 “Heading 2”와는 다를 수 있다. 따라서 스타일이 적용된 템플릿을 사용할 경우 헤딩을 다시 적용해야 할 수도 있다. 다중 컬럼, 이미지 위 텍스트 박스, 무거운 디자인이 포함된 복잡한 레이아웃은 덜 깔끔하게 변환되며, 스캔된 PDF는 텍스트가 없으므로 변환이 불가능하다. Word 복사본을 어디에든 보내기 전에 반드시 확인하라; 추출 응답에 포함된 HTML 미리보기가 빠른 체크 방법이다.

변환하지 말아야 할 경우

PDF가 서명된 계약서, 제출된 양식 또는 정확한 외관이 핵심인 경우, Word로 변환했다가 다시 PDF로 되돌리면 외관이 달라진다. 가능한 경우 PDF가 나온 원본에서 직접 변경하도록 요청하라. 변환은 PDF가 유일한 사본이고 내용(페이지가 아니라)이 변경되어야 할 때 일반적인 경우에만 사용한다.

정직한 한계

  • 이것은 변환이며, PDF를 제자리에서 편집하는 것이 아니다. 결과는 새로운 Word(또는 다른) 문서이며, PDF는 수정되지 않는다.
  • 텍스트 레이어가 없는 스캔 PDF는 이 방식으로 편집할 수 없으며, OCR 단계가 포함되지 않는다.
  • 평가 모드에서는 한 번에 두 페이지씩만 PDF를 편집한다. "pages":"1-3"을 extract_html에 요청하면 오류 없이 1·2 페이지가 반환되고, 3 페이지는 별도로 추출해야 하며, replace_text는 두 페이지를 초과하는 PDF를 거부한다. 모든 응답에는 “첫 2 PDF 페이지만”이라는 평가 배너가 포함되며, 이는 실제 동작보다 느슨하게 표현된 것이다. 모든 출력은 평가 배너 라인으로 시작한다.
  • 레이아웃이 무거운 페이지는 재흐름 형식으로 변환되는 과정에서 일부 디자인이 손실된다.

FAQ

AI 에이전트가 PDF를 직접 편집할 수 있나요?
정직하게는 아니다. 이 서버는 PDF를 편집 가능한 문서로 변환하고, 그곳에서 변경을 수행한 뒤 필요하면 다시 PDF로 저장한다.

PDF가 어디든 업로드되나요?
아니오. 서버는 로컬에서 실행되며, 변환 및 편집은 사용자의 머신에서 이루어진다.

편집 후 PDF를 다시 받을 수 있나요?
예. "format": "pdf"로 저장하거나 편집하면 Word 복사본과 함께 새로운 PDF가 생성된다.

더 깊이 파고들기