Om documenten automatisch te brandmerken, geef je een AI‑agent één permanente instructie en laat je hem een image‑watermark‑tool lokaal aanroepen voor elk bestand in de uitgaande map. Met de GroupDocs.Watermark.Mcp‑server kan die instructie één regel in een regels‑bestand zijn, een projectinstructie in Claude Code, of een prompt die je in Cursor plakt:

Plaats logo.png op elke pagina van elk bestand in de uitgaande map met 25 % dekking, en lijst vervolgens de bestanden die je hebt geproduceerd.

De stap‑voor‑stap‑versie met configuratie en probleemoplossing staat in de documentatie: Hoe documenten te brandmerken met een logo‑watermerk met AI.

Waarom wijkt handmatig brandmerken af?

Brandmerken die handmatig worden toegepast, verschilt per persoon: het ene team plakt het logo in het bronbestand, een ander stempelt de PDF met volledige sterkte, een derde vergeet het. Een LLM die “een logo toevoegt” door documentinhoud te bewerken heeft ook geen stabiele plaatsing. Het add_image_watermark‑hulpmiddel past het logo toe als een watermerkobject, met expliciete opacity‑ en rotation‑waarden, zodat dezelfde invoer dezelfde sterkte en hoek oplevert. Omdat het een object is en geen geplakte inhoud, kan het logo later worden gevonden en verwijderd wanneer het merk verandert.

Wat beslist de agent, en wat doet de engine?

Stap De agent beslist De engine doet
Welke bestanden vallen binnen de scope Leest de map en je instructie Niets
Welk hulpmiddel aanroepen add_image_watermark voor een logo, add_watermark voor een status Niets
Sterkte en hoek Geeft opacity en rotation door vanuit je standaard Teken het merkteken met precies die waarden
Uitvoer Rapporteert de geproduceerde bestanden Schrijft een nieuw bestand; het origineel wordt niet aangepast

De standaard leeft in je prompt. De server plant zichzelf niet in en heeft geen ingebouwde merk‑policy; het herhaalbare deel is de instructie die je opslaat en hergebruikt.

Hoe handhaaf je de standaard in vijf stappen?

  1. Houd het logo naast de documenten. Zowel het document als de afbeelding worden op naam opgezocht vanuit de opslagmap (GROUPDOCS_MCP_STORAGE_PATH). Gebruik een transparante PNG; een logo op een wit rechthoekig vlak toont dat vlak over de pagina.
  2. Scheid uitgaande bestanden. Stel GROUPDOCS_MCP_OUTPUT_PATH in op een andere map als je merk‑kopieën gescheiden wilt houden van de bronnen. Als dit niet is ingesteld, gaat de output naar de opslagmap.
  3. Controleer de licentie. Vraag: “Wat is de licentiestatus van de watermark‑server?” De agent roept get_license_status aan.
  4. Voer de standaard‑prompt uit. Dekking tussen 0,2 en 0,4 is het bereik dat de documentatie aanbeveelt voor brandmerken; boven 0,6 domineert het logo de pagina.
  5. Verifieer. Vraag om een search_watermarks‑pass op elk geproduceerd bestand en vergelijk het aantal met wat je verwacht.

Kan het merkteken ook een status aangeven?

Ja, met een tweede gekoppelde oproep. Brand en geef de status in één verzoek weer:

Voeg het logo toe met 25 % dekking, en voeg vervolgens een CONFIDENTIAL‑tekstwatermerk toe aan dat resultaat.

Elke oproep schrijft een nieuw bestand, dus “aan dat resultaat” is wat beide merktekens behoudt.

Voorbeeldsessie (verkort)

You:    Put logo.png on report.pdf at 30% opacity.
Agent:  [add_image_watermark: watermarkImage logo.png, opacity 0.3]
        Added image watermark from "logo.png" to "report.pdf"
You:    That is too strong - redo it at 0.2.
Agent:  [add_image_watermark: opacity 0.2, from the original report.pdf]
        Added image watermark from "logo.png" to "report.pdf"
        Two branded copies exist. Delete the 0.3 copy if you do not need it.

Itereren op deze manier is veilig omdat elke poging een nieuw bestand is. Verwijder de afgewezen exemplaren daarna.

Welk leveringskanaal past bij een team‑rollout?

Voor een gedeelde installatie vermijdt het Docker‑image het installeren van iets anders op elke machine, omdat de runtime en native afhankelijkheden erin zitten:

docker run --rm -i -v $(pwd)/documents:/data \
  ghcr.io/groupdocs-watermark/watermark-net-mcp:latest

Het NuGet‑kanaal (dnx GroupDocs.Watermark.Mcp --yes) heeft de .NET 10 SDK nodig. Beide draaien op Windows, Linux en macOS (dnx op Linux/macOS heeft ook libgdiplus nodig), en beide gebruiken dezelfde zes tools, zodat de merk‑prompt niet verandert tussen hen.

Wat zijn de limieten?

Plan rond twee limieten. Ten eerste exposeert het hulpmiddel alleen opacity en rotation: er is geen positie-, grootte‑ of marge‑instelling. Ten tweede, evaluatiemodus: de licentiepagina van de server zegt dat ongelicentieerde output evaluatiebeperkingen heeft (de exacte limieten staan op de bibliotheek‑licentiepagina), dus merk‑kopieën die zonder licentie zijn geproduceerd, mogen niet worden verspreid. Voer get_license_status uit vóór een merk‑rollout. Bij meter‑licenties wordt elk verwerkt bestand gefactureerd, en bij een licentiebestand werkt de server offline. Houd er ook rekening mee dat een watermerk een document labelt; het beschermt de onderliggende inhoud niet.

FAQ

Kan AI ons bedrijfslogo aan alle PDF’s toevoegen?
Ja. Vraag om het logo op bestandsnaam en geef een dekking; de agent roept add_image_watermark één keer per bestand aan. dezelfde oproep werkt ook op Word, PowerPoint, Excel en afbeeldingsbestanden.

Kan ik hetzelfde logo gebruiken op afbeeldingen en documenten?
Ja. Afbeeldingen zijn geldige doelen, dus het brandmerken van productfoto’s werkt net als het brandmerken van een PDF.

Wat gebeurt er als het merk verandert?
remove_watermarks kan het oude logo verwijderen, omdat het als een watermerkobject is toegepast. Zijn textFilter matcht alleen watermerk‑tekst, dus het verwijderen van een afbeelding‑logo betekent het verwijderen van alle watermerken, inclusief tekstmarkeringen. Zoek eerst zodat je weet wat er is, voeg daarna het nieuwe logo toe.

Dieper duiken