Je kunt een AI‑agent zoals Claude, Cursor of GitHub Copilot vragen om een document te ondertekenen en dit lokaal laten uitvoeren, op je eigen machine, waarbij het bestand en het certificaat het systeem nooit verlaten. De agent beslist wat er ondertekend wordt en hoe; de GroupDocs.Signature.Mcp‑server past de handtekening toe via zijn sign‑tool. Alles hieronder begint met prompts zoals deze:

Sign contract.pdf digitaal met signing-cert.pfx.

De stap‑voor‑stap versie met configuratie en probleemoplossing staat in de documentatie: Hoe documenten te ondertekenen met AI‑agents via MCP.

Wat betekent “sign” wanneer je een AI‑agent vraagt?

Het kan een visueel merkteken of een cryptografische handtekening betekenen, en het verschil is belangrijk voordat iets geautomatiseerd wordt. De sign‑tool accepteert vier waarden voor type: text, qrcode, barcode en digital. De eerste drie plaatsen een visueel merkteken op de pagina. Alleen digital past een certificaat‑ondersteunde cryptografische handtekening toe die registreert wie heeft ondertekend en iedereen later wijzigingen in het bestand laat detecteren.

Taalmodellen maken dit onderscheid niet vanzelf. Als een prompt alleen “sign this” zegt, moet de agent raden welke je bedoelt, dus benoem het type. De drie onderstaande manieren zijn geordend van het lichtste merkteken tot het sterkste.

Manier 1: De pagina stempelen met een teksthandtekening

Gebruik een teksthandtekening wanneer een persoon of proces alleen hoeft te zien dat een document is verwerkt: een naam, een datum, een goedkeuringslabel.

Voeg een teksthandtekening met mijn naam en de datum van vandaag toe aan report.docx.

De agent roept sign aan met type: "text" en de tekst die je hebt opgegeven. De server schrijft een ondertekende kopie naar de output‑map en laat het origineel onaangeroerd. Dit is een merkteken, geen bewijs: het toont een label op de pagina en zegt niets over wie het heeft geplaatst of of het bestand later is gewijzigd.

Manier 2: Een QR‑code of barcode toevoegen die een referentie bevat

Gebruik een code wanneer een machine, niet een persoon, later de handtekening zal lezen. Een QR‑code kan gestructureerde tekst bevatten, en een barcode (de Code39, Code128 en EAN‑familie) past bij scan‑lijn workflows.

Sign contract.pdf met een QR‑code die ORDER-2026-0418 bevat.

De agent roept sign aan met type: "qrcode" en text: "ORDER-2026-0418". Geef de tekst expliciet in elke prompt die om een code vraagt, en lees de waarde terug met search_qr_codes voordat je erop vertrouwt. Net als een tekststempel is een code een visueel merkteken: het bewijst dat het merkteken aanwezig is, niet wie het heeft aangebracht.

Manier 3: Een certificaat‑gebaseerde digitale handtekening toepassen

Gebruik een digitale handtekening wanneer je moet aantonen wie heeft ondertekend en dat het bestand sindsdien niet is gewijzigd. De agent geeft het certificaatbestand en het wachtwoord door aan sign:

Sign contract.pdf digitaal met signing-cert.pfx.

De oproep gebruikt type: "digital", certificate en certificatePassword. Beide worden gelezen van de lokale schijf door het lokale serverproces, en de ondertekening gebeurt in‑process. Er is geen ondertekeningsservice betrokken, dus noch de sleutel noch het wachtwoord wordt ergens naartoe verzonden. Bewaar het wachtwoord in een omgevingsvariabele in plaats van in een gecommitte configuratie van de client.

Volgorde is hier belangrijk. Visuele merktekens herschrijven het bestand, dus elke tekststempel of code die na een digitale handtekening wordt toegevoegd, maakt deze ongeldig. Pas eerst elk visueel merkteken toe en de digitale handtekening als laatste, en vermeld dit in de prompt wanneer de agent handtekeningen aaneenschakelt.

Voorbeeldsessie (verkort)

You:    Sign contract.pdf with a QR code containing ORDER-2026-0418.

Agent:  [sign] file=contract.pdf, type=qrcode, text="ORDER-2026-0418"
        -> Signed contract.pdf with qrcode signature
        The signed copy was saved to the output folder.
        The original contract.pdf was not modified.

Illustratieve output: de bestandsnaam en de QR‑waarde zijn verzonnen. Het hulpmiddel retourneert de hierboven beschreven velden.

Wat kan een AI‑agent niet voor jou ondertekenen?

Een agent kan een handtekening toepassen; hij kan die handtekening niet juridisch bindend maken. Deze server is geen gehoste e‑handtekeningservice of gekwalificeerde trust‑serviceprovider. Hij past een handtekening toe met het certificaat dat je levert, op één machine, voor één client‑proces.

Of het resultaat voldoet aan een bepaald juridisch regime, zoals een eIDAS‑gekwalificeerde handtekening, hangt af van het certificaat en het proces eromheen, niet van deze server. Als een geschil mogelijk is, vraag dan welk certificaat en welk proces van toepassing zijn voordat je automatiseert.

Evaluatiebeperkingen die je moet weten

Zonder licentie draait de server in evaluatiemodus: alleen de eerste 2 pagina’s worden verwerkt, en een proef‑badge wordt op elke pagina gestempeld. Een handtekening bedoeld voor pagina 5 van een contract wordt niet geplaatst, en er wordt geen foutmelding gegeven. Vraag vóór elke belangrijke ondertekeningsrun:

Wat is de licentiestatus van de handtekeningsserver?

De agent roept get_license_status aan, die de modus (evaluatie, gelicentieerd of gemeten) rapporteert zonder een document aan te raken.

Veelgestelde vragen

Kan AI documenten voor mij ondertekenen?
Een agent kan via de sign‑tool lokaal een tekst‑, QR‑code‑, barcode‑ of certificaat‑gebaseerde handtekening op een document toepassen. Of die handtekening juridische kracht heeft, hangt af van het certificaat en jouw jurisdictie, niet van de agent.

Kan Claude een PDF ondertekenen zonder het ergens te uploaden?
Ja. De MCP‑server draait als een child‑process van de client via stdio, zonder inkomende poorten, zonder externe eindpunten en zonder telemetrie. Het pad is agent, lokale server, lokaal bestandssysteem.

Met welke clients werkt dit?
Claude Desktop, Claude Code, VS Code met GitHub Copilot, Visual Studio 2022 (17.14+), Cursor, Windsurf, Cline, Codex CLI en JetBrains Rider. Installeer met dnx GroupDocs.Signature.Mcp --yes of de Docker‑image ghcr.io/groupdocs-signature/signature-net-mcp.

Dieper duiken