Puoi chiedere a un agente IA come Claude, Cursor o GitHub Copilot di firmare un documento e farlo localmente, sulla tua macchina, senza che il file e il certificato lo lascino. L’agente decide cosa firmare e come; il server GroupDocs.Signature.Mcp applica la firma tramite il suo strumento sign. Tutto quanto segue parte da prompt come questo:

Firma contract.pdf digitalmente usando signing-cert.pfx.

La versione passo‑passo con configurazione e risoluzione dei problemi è nella documentazione: How to sign documents with AI agents using MCP.

Cosa significa “firmare” quando chiedi a un agente IA?

Può indicare un segno visivo o una firma crittografica, e la differenza è importante prima di qualsiasi automazione. Lo strumento sign accetta quattro valori per type: text, qrcode, barcode e digital. I primi tre posizionano un segno visivo sulla pagina. Solo digital applica una firma crittografica basata su certificato che registra chi ha firmato e consente a chiunque di rilevare modifiche successive al file.

I modelli linguistici non fanno questa distinzione da soli. Se un prompt dice solo “firma questo”, l’agente deve indovinare a cosa ti riferisci, quindi specifica il tipo. I tre metodi qui sotto sono ordinati dal segno più leggero al più forte.

Metodo 1: Apporre un timbro di testo sulla pagina

Usa una firma di testo quando una persona o un processo ha solo bisogno di vedere che il documento è stato gestito: un nome, una data, un’etichetta di approvazione.

Aggiungi una firma di testo con il mio nome e la data di oggi a report.docx.

L’agente chiama sign con type: "text" e il testo che gli hai fornito. Il server scrive una copia firmata nella cartella di output e lascia intatto l’originale. Questo è un segno, non una prova: mostra un’etichetta sulla pagina e non dice nulla su chi l’ha posizionata o se il file è stato modificato successivamente.

Metodo 2: Aggiungere un codice QR o un codice a barre che trasporta un riferimento

Usa un codice quando sarà una macchina, non una persona, a leggere la firma in seguito. Un codice QR può contenere testo strutturato, e un codice a barre (le famiglie Code39, Code128 e EAN) è adatto a flussi di lavoro a scansione.

Firma contract.pdf con un codice QR contenente ORDER-2026-0418.

L’agente chiama sign con type: "qrcode" e text: "ORDER-2026-0418". Fornisci il testo esplicitamente in ogni prompt che richiede un codice, e leggi il valore indietro con search_qr_codes prima di fare affidamento su di esso. Come un timbro di testo, un codice è un segno visivo: dimostra che il segno è presente, non chi lo ha applicato.

Metodo 3: Applicare una firma digitale basata su certificato

Usa una firma digitale quando devi mostrare chi ha firmato e che il file non è stato modificato da allora. L’agente passa il file del certificato e la sua password a sign:

Firma contract.pdf digitalmente usando signing-cert.pfx.

La chiamata utilizza type: "digital", certificate e certificatePassword. Entrambi sono letti dal disco locale dal processo del server locale, e la firma avviene in-processo. Non è coinvolto alcun servizio di firma, quindi né la chiave né la password vengono trasmessi da nessuna parte. Conserva la password in una variabile d’ambiente anziché in una configurazione client committata.

L’ordine è importante qui. I segni visivi riscrivono il file, quindi qualsiasi timbro di testo o codice aggiunto dopo una firma digitale la invalida. Applica prima tutti i segni visivi e la firma digitale per ultima, e specifica ciò nel prompt ogni volta che l’agente concatena firme.

Sessione di esempio (abbreviata)

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.

Output illustrativo: il nome del file e il valore QR sono inventati. Lo strumento restituisce i campi descritti sopra.

Cosa non può firmare per te un agente IA?

Un agente può applicare una firma; non può rendere quella firma legalmente vincolante. Questo server non è un servizio di firma elettronica ospitato né un fornitore di servizi fiduciari qualificati. Applica una firma con il certificato che fornisci, su una singola macchina, per un singolo processo client.

Se il risultato soddisfa un determinato regime legale, come una firma qualificata eIDAS, dipende dal certificato e dal processo attorno ad esso, non da questo server. Se è plausibile una controversia, chiedi quale certificato e quale processo si applicano prima di automatizzare.

Limiti della valutazione che dovresti conoscere

Senza licenza il server funziona in modalità valutazione: vengono elaborate solo le prime 2 pagine, e un badge di prova è apposto su ogni pagina. Una firma destinata alla pagina 5 di un contratto non verrà posizionata, e nessun errore lo segnala. Prima di qualsiasi operazione di firma importante, chiedi:

Qual è lo stato della licenza del server di firma?

L’agente chiama get_license_status, che riporta la modalità (valutazione, licenziata o a consumo) senza toccare un documento.

FAQ

Può l’IA firmare documenti per me?
Un agente può applicare una firma di testo, QR code, codice a barre o basata su certificato a un documento tramite lo strumento sign, localmente. Se quella firma ha valore legale dipende dal certificato e dalla tua giurisdizione, non dall’agente.

Claude può firmare un PDF senza caricarlo da nessuna parte?
Sì. Il server MCP viene eseguito come processo figlio del client tramite stdio, senza porte in ingresso, endpoint esterni né telemetria. Il percorso è agente, server locale, filesystem locale.

Con quali client funziona?
Claude Desktop, Claude Code, VS Code con GitHub Copilot, Visual Studio 2022 (17.14+), Cursor, Windsurf, Cline, Codex CLI e JetBrains Rider. Installa con dnx GroupDocs.Signature.Mcp --yes o l’immagine Docker ghcr.io/groupdocs-signature/signature-net-mcp.

Approfondisci