메일룸 스캔은 이미지입니다: 아무도 검색할 수 없으며 텍스트 추출기는 아무 것도 찾지 못합니다. 페이지의 바코드만 예외입니다. GroupDocs.Parser.Mcp 서버는 Docker에서 로컬로 실행되며, Claude Desktop, Cursor 또는 GitHub Copilot과 같은 클라이언트의 AI 에이전트가 스캔된 문서에서 바코드를 읽고 디코딩된 값을 반환하도록 요청할 수 있습니다:

이 스캔된 배송 전표의 바코드를 읽고 해당 파일과 함께 값을 나열해 주세요.

구성 및 문제 해결이 포함된 단계별 버전은 문서에 있습니다: 스캔된 문서에서 바코드 및 QR 코드를 읽는 방법.

왜 스캔에는 바코드 리더가 필요하고 텍스트 추출기는 필요하지 않을까요?

스캔된 페이지에는 텍스트 레이어가 없습니다. extract_text는 거의 반환하지 않거나 전혀 반환하지 않으며, 이는 파일에 대한 사실적인 진술입니다. 그러나 엔진 모델은 래스터화된 이미지에서 코드를 감지하므로 extract_barcodes는 스캔된 배송 전표에 인쇄된 추적 번호를 여전히 반환합니다. 서버에는 OCR이 없으므로 인쇄된 단어는 픽셀로 남고, 코드만 데이터가 됩니다.

도구는 무엇을 반환하나요?

extract_barcodes는 헤더 라인 Found N barcode(s) in ...을 반환하고, 그 뒤에 각 코드마다 하나의 객체를 가진 JSON 배열을 반환합니다. 각 객체는 index, value, type, page, confidence, angle을 포함합니다. 이 도구는 PDF, DOCX, XLSX, PPTX, PNG, JPG, TIFF 및 기타 형식에서 Code128, QR Code, PDF417, DataMatrix, EAN-13, EAN-8, UPC, Aztec 등 다양한 심볼을 감지합니다. 아무 것도 찾지 못하면 “No barcodes found” 메시지를 반환합니다.

예시 세션 (축약):

You:    Read the barcodes on page 1 of dn-2291.pdf and tell me which order it belongs to.
Agent:  [calls extract_barcodes with page 1]
        Found 1 barcode(s) in dn-2291.pdf
        [{"index": 1, "value": "SHP-884120377", "type": "Code128", "page": 1, "confidence": 0.98, "angle": 0}]
        The delivery note carries tracking number SHP-884120377.

스캔을 레코드로 어떻게 변환하나요?

디코딩된 값은 일반적으로 조인 키 역할을 합니다: 스캔을 배송과 연결하는 추적 번호, 서명된 양식을 케이스와 연결하는 주문 참조, 사진을 재고 기록과 연결하는 자산 태그 등입니다. 에이전트가 이를 얻으면 이미지가 행이 됩니다.

각 스캔에 대해 바코드를 읽고 해당 주문이 무엇인지 알려 주세요.

에이전트는 파일당 extract_barcodes를 호출하고 각 값을 제공한 주문과 매칭합니다. page를 전달하면 긴 문서의 모든 페이지가 아니라 라벨이 있는 페이지만 스캔합니다.

스캔 파일과 디지털 파일이 혼합된 배치를 어떻게 정렬하나요?

파일에 텍스트가 있는지 여부에 따라 에이전트가 분기하도록 합니다.

각 파일에 대해: 텍스트 추출을 시도하세요. 결과가 비어 있으면 대신 바코드를 읽고 어떤 파일에 필요한지 알려 주세요.

바코드 읽기로 넘어간 파일이 스캔 파일입니다. 이 목록은 인제션 프로젝트를 계획 중이라면 자체적으로 유용한 인벤토리입니다. 그 위에 라우팅 단계를 추가하여 예를 들어 “바코드 값의 접두사별로 파일을 그룹화"하면 폴더가 이미 정렬된 상태로 도착합니다.

어떤 서버가 코드를 읽나요: Parser 또는 Signature?

두 서버 모두 스캔에서 바코드 또는 QR 코드를 읽을 수 있습니다: Parser는 extract_barcodes를, Signature는 search_barcodes와 search_qr_codes를 사용합니다. 임의의 스캔에서 데이터를 추출하고 동일한 파일에서 텍스트, 표 또는 메타데이터도 필요할 때는 GroupDocs.Parser.Mcp를 사용하세요. 코드가 서명 요소이거나 문서가 양방향으로 흐르고 새 코드를 사용해 발신 문서에 서명해야 할 경우에는 GroupDocs.Signature.Mcp를 사용합니다. Signature 측면은 From Barcode to Record: Document Intake Automation with AI Agents에서 다룹니다.

제한 사항은 무엇인가요?

  • 디코딩된 값은 신뢰할 수 없는 데이터입니다. 문서를 만든 사람이 값을 선택했습니다. 이를 보고하고, 조회하고, 교차 확인하며, 에이전트가 검토 없이 행동하지 않도록 하세요.
  • 품질이 낮은 스캔은 디코딩되지 않을 수 있습니다. 기울어지거나 저해상도이거나 손상된 코드는 아무 것도 반환하지 않을 수 있습니다. 빈 결과는 “찾을 수 없음"을 의미하며, 이는 나쁜 스캔에서는 “존재하지 않음"과 동일하지 않습니다.
  • 평가 모드는 제한됩니다. 라이선스가 없으면 추출이 제한됩니다; 라이브러리의 licensing page를 확인하고 에이전트에게 먼저 get_license_status를 실행하도록 요청하세요.
  • Docker 전용. 모델이 이미지에 번들되어 있어 이미지가 큽니다. dnx 명령은 없으며, 컨테이너는 docker run --rm -i -v $(pwd)/documents:/data ghcr.io/groupdocs-parser/parser-net-mcp:latest 로 시작하고, VS Code와 Cursor용 원클릭 링크는 Register in AI clients에 있습니다.

FAQ

Claude가 스캔된 PDF에서 바코드를 읽을 수 있나요?
예, extract_barcodes 도구를 통해 가능하며, 이 도구는 스캔된 파일에 대한 로컬 컨테이너에서 실행됩니다. Claude는 디코딩된 값, 유형 및 페이지를 받습니다.

OCR 없이 스캔된 문서에서 QR 코드를 읽을 수 있나요?
예. 코드 감지는 텍스트 인식에 의존하지 않으므로 페이지에 인쇄된 단어가 없어도 QR 코드를 디코딩할 수 있습니다.

스캔된 문서를 바코드별로 자동 정렬하려면 어떻게 해야 하나요?
에이전트에게 각 스캔의 코드를 읽고 값을 기준으로 파일을 그룹화하거나 이름을 바꾸도록 요청하세요. 파일을 이동하기 전에 그룹화를 검토하세요. 디코딩된 값은 문서 자체에서 가져오기 때문입니다.

더 깊이 알아보기