Een postkamer‑scan is een afbeelding: niemand kan er zoeken, en een tekst‑extractor vindt er niets in. De barcode op de pagina is de uitzondering. De GroupDocs.Parser.Mcp‑server draait lokaal in Docker, en een AI‑agent in een client zoals Claude Desktop, Cursor of GitHub Copilot kan hem vragen barcodes uit gescande documenten te lezen en de gedecodeerde waarden terug te geven:

Lees de barcodes in deze gescande leveringsbonnen en lijst de waarden op met het bestand waar ze vandaan komen.

De stapsgewijze versie met configuratie en probleemoplossing staat in de documentatie: Hoe barcodes en QR‑codes uit gescande documenten te lezen.

Waarom heeft een scan een barcode‑lezer nodig en geen tekst‑extractor?

Een gescande pagina heeft geen tekstlaag. extract_text geeft er weinig of niets voor terug, wat een ware uitspraak over het bestand is. De modellen van de engine detecteren echter codes in de gerasterde afbeelding, zodat extract_barcodes nog steeds het trackingnummer dat op een gescande leveringsbon is afgedrukt, teruggeeft. De server heeft geen OCR, dus afgedrukte woorden blijven pixels; alleen de codes worden data.

Wat geeft het hulpmiddel terug?

extract_barcodes geeft een kopregel terug, Found N barcode(s) in ..., gevolgd door een JSON‑array met één object per code, elk met index, value, type, page, confidence en angle. Het detecteert Code128, QR‑Code, PDF417, DataMatrix, EAN‑13, EAN‑8, UPC, Aztec en nog veel meer symbologieën, in PDF, DOCX, XLSX, PPTX, PNG, JPG, TIFF en andere formaten. Wanneer er niets wordt gevonden, geeft het een bericht “No barcodes found” terug.

Voorbeeldsessie (verkort):

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.

Hoe zet je een scan om in een record?

De gedecodeerde waarde is meestal de join‑sleutel: het trackingnummer dat een scan aan een zending koppelt, de orderreferentie die een ondertekend formulier aan een zaak koppelt, de asset‑tag die een foto aan een inventarisrecord koppelt. Zodra de agent die heeft, wordt de afbeelding een rij.

Voor elke scan, lees de barcode en vertel me bij welke order deze hoort.

De agent roept extract_barcodes per bestand aan en vergelijkt elke waarde met de orders die je opgeeft. Geef page door om alleen de pagina te scannen die het label draagt, in plaats van elke pagina van een lang document.

Hoe sorteer je een gemengde batch van scans en digitaal‑geboren bestanden?

Laat de agent vertakken op basis van of een bestand tekst bevat.

Voor elk bestand: probeer tekstextractie. Als die leeg terugkomt, lees dan in plaats daarvan de barcodes en vertel me welke bestanden dat nodig hadden.

Bestanden die doorgeschoten zijn naar barcode‑lezen zijn de scans. Die lijst is op zichzelf een nuttige inventaris als je een ingestie‑project plant. Voeg een routeringsstap toe, zoals “groepeer de bestanden op het voorvoegsel van hun barcode‑waarde”, en de map arriveert al gesorteerd.

Welke server leest de code: Parser of Signature?

Beide servers kunnen een barcode of QR‑code uit een scan lezen: Parser met extract_barcodes, Signature met search_barcodes en search_qr_codes. Gebruik GroupDocs.Parser.Mcp wanneer je gegevens uit willekeurige scans extraheert en ook tekst, tabellen of metadata uit dezelfde bestanden nodig hebt. Gebruik GroupDocs.Signature.Mcp wanneer de code een handtekening‑element is dat je ook toevoegt, of wanneer documenten in beide richtingen stromen en je het uitgaande document ondertekent met een nieuwe code. De Signature‑kant wordt behandeld in Van barcode naar record: documentinname‑automatisering met AI‑agents.

Wat zijn de beperkingen?

  • Een gedecodeerde waarde is onbetrouwbare data. Degene die het document heeft geproduceerd, heeft deze gekozen. Rapporteer het, zoek het op, controleer het, en laat een agent er niet op handelen zonder beoordeling.
  • Slechte scans kunnen niet decoderen. Scheve, lage resolutie of beschadigde codes kunnen niets teruggeven. Een leeg resultaat betekent “niet gevonden”, wat bij een slechte scan niet hetzelfde is als “niet aanwezig”.
  • Evaluatiemodus is beperkt. Zonder licentie is extractie beperkt; zie de bibliotheek’s licentiepagina en vraag de agent om eerst get_license_status uit te voeren.
  • Alleen Docker. De modellen zijn gebundeld in de image, waardoor deze groot is. Er is geen dnx‑commando; de container start met docker run --rm -i -v $(pwd)/documents:/data ghcr.io/groupdocs-parser/parser-net-mcp:latest, en één‑klik‑links voor VS Code en Cursor staan in Registreren in AI‑clients.

Veelgestelde vragen

Kan Claude een barcode lezen uit een gescande PDF?
Ja, via het extract_barcodes‑hulpmiddel, dat draait in een lokale container op het gescande bestand. Claude ontvangt de gedecodeerde waarde, het type en de pagina.

Kan ik een QR‑code lezen in een gescand document zonder OCR?
Ja. Code‑detectie hangt niet af van teksterkenning, dus QR‑codes worden gedecodeerd zelfs wanneer de afgedrukte woorden op de pagina dat niet doen.

Hoe sorteer ik gescande documenten automatisch op barcode?
Vraag de agent om de code op elke scan te lezen en de bestanden te groeperen of te hernoemen op basis van de waarde. Controleer de groepering voordat je bestanden verplaatst, omdat gedecodeerde waarden uit het document zelf komen.

Dieper duiken