본문으로 건너뛰기
← 블로그로 돌아가기

PDFCraft MCP로 PDF를 Markdown으로 변환하기

AI 에이전트를 PDFCraft MCP에 연결하고, 예제 PDF를 Markdown으로 변환해 결과를 확인한 뒤 요약과 문서 작업에 재사용하는 방법을 알아보세요.

OOMOL

자연광 아래 펼친 책을 읽는 사람과 PDF를 넘어 독서를 넓히자는 제목

PDF 보고서는 AI 에이전트의 참고 자료로 쓸 수 있습니다. Markdown으로 변환하면 내용을 확인하고 편집할 수 있는 파일이 생깁니다. 요약을 요청하거나 정보를 추출할 때도 같은 텍스트를 재사용할 수 있습니다.

PDFCraft는 PDF와 EPUB 처리를 위한 원격 MCP 서비스를 제공합니다. 이 튜토리얼에서는 작은 공개 PDF를 사용해 연결부터 다운로드한 Markdown 확인까지의 과정을 설명합니다. 변환에는 PDFCraft 크레딧이 사용됩니다.

에이전트에 PDFCraft 연결하기

OOMOL Console에서 API 키를 만든 뒤, PDFCraft MCP 연결 가이드에 따라 에이전트에 서버를 추가하세요. PDFCraft는 자체 MCP 엔드포인트를 사용합니다. 이미 OOMOL 앱 연결을 사용 중이더라도 별도 서버로 추가해야 합니다.

시작하기 전에 클라이언트가 가이드에 명시된 전송 방식, 프로토콜 버전, Bearer 인증 헤더를 지원하는지 확인하세요. 키는 클라이언트의 보호된 설정에 보관합니다. 클라이언트는 파일 내용을 읽고 업로드할 수도 있어야 합니다. 원격 서버에 로컬 파일 이름을 알려주는 것만으로는 문서가 업로드되지 않습니다.

에이전트에게 get_capabilities를 호출하고 사용 가능한 변환 형식을 설명해 달라고 요청하세요. 도구를 찾지 못하면 파일을 업로드하거나 유료 작업을 시작하기 전에 연결 문제를 해결합니다.

한 페이지 PDF로 시작하기

PDFCraft 예제 PDF를 다운로드해 열어 보세요. 결과에서 찾아볼 수 있는 Paper to structured text.라는 문장이 들어 있습니다. 이 파일은 절차를 연습하기 위한 작은 입력 자료이며, 스캔한 책이나 표, 수식의 인식 품질을 평가하는 자료는 아닙니다.

클라이언트의 첨부 기능으로 PDF를 제공하거나 에이전트가 읽을 수 있는 작업 폴더에 놓고 다음과 같이 요청하세요.

PDFCraft를 사용해 첨부한 예제 PDF를 Markdown으로 변환할 준비를 해 주세요. 지원하는 옵션과 제 잔액을 확인하고 변환 비용을 계산해, 처리를 시작하기 전에 보여 주세요. 나중에 같은 작업을 이어서 확인할 수 있도록 작업 UUID를 보관해 주세요.

예상 비용을 확인하고 준비가 되면 처리를 승인하세요.

Markdown 변환을 시작해 주세요. 완료될 때까지 간격을 두고 진행 상황을 확인한 뒤 전체 결과를 이 작업 폴더에 다운로드해 주세요. 작업 UUID와 저장한 파일 위치를 알려 주세요. 실패하면 다른 작업을 만들기 전에 오류를 보여 주세요.

서비스는 작업 생성, 파일 업로드, 처리 시작, 진행 상황 확인, 다운로드 링크 제공 순서로 동작합니다. 도구를 발견했다고 해서 업로드나 변환이 성공한 것은 아닙니다. 결과를 저장하고 확인할 때까지 작업 UUID를 보관하세요.

요약을 요청하기 전에 결과 확인하기

다운로드한 결과를 엽니다. 압축 파일이라면 먼저 압축을 풀고 Markdown과 함께 제공된 파일을 살펴보세요. 에이전트에게 다음과 같이 요청할 수 있습니다.

변환된 Markdown을 열고 “Paper to structured text.”가 포함되어 있는지 확인해 주세요. 해당 부분을 보여 주고 예제 PDF와 비교해 주세요. 빠진 텍스트는 임의로 채우지 말고 알려 주세요.

이 문장을 찾는 것은 예상한 입력이 결과에 반영되었는지 확인하는 기본 절차입니다. 자신의 문서를 처리할 때는 제목, 문단 순서, 표, 숫자, 각주를 원본과 비교하세요. 읽기 좋은 요약에도 숫자나 수식의 전사 오류가 숨어 있을 수 있습니다.

변환 결과를 확인한 다음 저장된 텍스트로 작업을 요청하세요.

이 Markdown을 다섯 가지 요점으로 요약해 주세요. 각 요점에 근거가 되는 짧은 인용문을 붙이고, 원문에 제목이 있다면 함께 표시해 주세요. 원본 Markdown은 수정하지 말아 주세요.

요약은 에이전트가 변환 결과를 읽고 작성합니다. PDFCraft는 문서 처리 도구를 제공합니다. Markdown을 재사용할 자료로 저장해 두면 새로운 질문을 할 때마다 같은 PDF를 다시 변환할 필요가 없습니다.

중단된 작업 이어서 확인하기

처리 중 대화나 클라이언트가 멈추면 저장한 작업 UUID를 다음 세션에 전달하고 해당 작업을 확인해 달라고 요청하세요. 첫 세션의 진행 화면을 볼 수 없다는 이유만으로 두 번째 변환을 시작하지 마세요.

다운로드 링크가 만료되면 작업 파일이 아직 남아 있는 동안 같은 작업의 링크를 다시 요청할 수 있습니다. 잔액 부족으로 전체 다운로드가 차단되면 크레딧을 충전한 뒤 결과를 다시 요청하세요. 상태와 복구 방법은 작업 수명 주기 및 복구 가이드에서 확인할 수 있습니다. 완료된 파일은 만료 전에 저장하세요.

EPUB 변환과 번역

PDFCraft는 PDF를 EPUB으로 변환하거나 PDF와 EPUB을 번역하는 기능도 지원합니다. 전자책 단말기에서 읽을 책이라면 EPUB 출력을 요청하세요. 번역할 때는 에이전트가 get_capabilities로 지원 언어를 확인하고, 대상 언어와 예상 비용을 확인한 뒤 처리하도록 요청합니다.

텍스트를 확인하고 재사용하려면 Markdown, 책을 읽으려면 EPUB을 선택하세요. 큰 문서를 변환하기 전에 내용의 특징을 잘 보여 주는 작은 문서로 결과를 확인하는 것이 좋습니다.

업무 앱에서 텍스트 활용하기

Markdown을 검토한 뒤 요약을 업무 앱에 저장하거나 프로젝트에 첨부할 수 있습니다. OOMOL 에이전트 빠른 시작 가이드에 따라 해당 앱을 연결하고, 에이전트에게 쓰기 작업을 요청하기 전에 저장할 위치를 지정하세요. PDFCraft 변환 서버와 OOMOL에 연결된 앱은 각각 설정해야 합니다.

브라우저에서 PDF를 압축하거나 병합, 분할하려면 PDFCraft 온라인 PDF 도구를 여세요. 에이전트로 변환하려면 PDFCraft MCP 연결 가이드부터 시작하세요.