Un agente IA può aggiungere filigrane ai documenti sul tuo computer, senza caricamento: chiedi in linguaggio naturale, l’agente chiama il server GroupDocs.Watermark.Mcp e una copia contrassegnata appare accanto all’originale. Questo funziona in Claude Desktop, Claude Code, Cursor, VS Code con GitHub Copilot e Windsurf. Una tipica prima richiesta, eseguita localmente:

Aggiungi una filigrana diagonale CONFIDENZIALE a contract.pdf.

La versione passo‑passo con configurazione e risoluzione dei problemi è nella documentazione: Come aggiungere filigrane ai documenti con agenti IA usando MCP.

Perché i documenti creati con un LLM dovrebbero portare un’etichetta?

Una volta che un LLM redige, riassume o riformatta i documenti, i file circolano senza alcun segno di come siano stati prodotti. Chiedere al modello di “aggiungere una nota in cima” modifica il contenuto stesso, e un modello che riscrive un documento può cambiare più della nota. Una filigrana viene applicata dal motore come un oggetto separato su una copia salvata, quindi il testo sottostante non viene rigenerato. Il server scrive ogni risultato come un nuovo file; l’originale rimane intatto. Il segno è testo semplice o un’immagine che scegli; il server non rileva se un documento è stato generato dall’IA e non incorpora metadati di provenienza. Questo rende l’etichettatura una politica che puoi esprimere in una frase: ogni documento che esce da questa cartella porta un segno.

Una filigrana è un deterrente, non un controllo di accesso. Rende visibile la provenienza e rende scomodo il riutilizzo occasionale. Non impedisce la copia e può essere rimossa da chi lo desidera. Se hai bisogno di prova di manomissione, usa invece una firma digitale.

Metodo 1: Apporre uno stato come testo

Usa add_watermark quando l’etichetta è una parola o una breve frase: BOZZA, CONFIDENZIALE, una data, “Generato con IA”.

Aggiungi una filigrana diagonale AI-GENERATA a summary.docx.

L’agente chiama add_watermark con text, un fontSize opzionale (predefinito 36) e rotation (predefinito -45, la classica diagonale). Risultato atteso: un messaggio del tipo Added text watermark "AI-GENERATED" to "summary.docx" e il percorso del nuovo file nella tua cartella di output.

Metodo 2: Contrassegnare la fonte con un’immagine

Usa add_image_watermark quando l’etichetta è un logo, un timbro o una firma scansionata. L’immagine può essere PNG, JPG, BMP o TIFF e viene risolta per nome dalla stessa cartella di archiviazione del documento.

Posiziona approved-stamp.png su ogni pagina di report.pdf al 30% di opacità.

opacity varia da 0,0 a 1,0 con valore predefinito 0,5. Valori tra 0,2 e 0,4 di solito vengono percepiti come un’etichetta piuttosto che come un’ostruzione.

Metodo 3: Combinare uno stato e un segno di origine

Usa due chiamate quando un solo segno non è sufficiente, ad esempio il logo della fonte più uno stato. Concatenale e specifica:

Aggiungi il logo al 30% di opacità, poi aggiungi una filigrana di testo BOZZA a quel risultato.

Ogni chiamata scrive un nuovo file. Senza “to that result” la seconda chiamata parte dall’originale e solo il segno BOZZA rimane.

Come verificare che l’etichetta sia presente?

Usa search_watermarks per chiedere cosa contiene un documento. Restituisce un oggetto JSON con count e un array watermarks; ogni voce ha type (text o image), text, page, x, y, width, height e rotateAngle.

Il file proposal.pdf ha già una filigrana, e cosa dice?

Eseguilo prima di un passaggio di etichettatura e un file che mostra già CONFIDENZIALE non verrà timbrato due volte a due angoli. Eseguilo dopo un passaggio e avrai la prova che il segno è presente.

Sessione di esempio (abbreviata)

You:    Add a diagonal CONFIDENTIAL watermark to contract.pdf, then
        check that it is there.
Agent:  [add_watermark: text "CONFIDENTIAL", rotation -45]
        Added text watermark "CONFIDENTIAL" to "contract.pdf"
Agent:  [search_watermarks on the new copy]
        count: 1 - type: text, text: "CONFIDENTIAL", page: 1
        The copy carries one text watermark. contract.pdf is unchanged.

Come configurarlo?

Con il SDK .NET 10 installato, il server si avvia con un solo comando, e il tuo client lo avvia per te una volta registrato:

dnx GroupDocs.Watermark.Mcp --yes

Imposta GROUPDOCS_MCP_STORAGE_PATH sulla cartella che contiene i tuoi documenti. Esistono blocchi di registrazione per Claude Desktop, Claude Code, Cursor, VS Code con GitHub Copilot, Windsurf, Cline e Codex CLI; la configurazione esatta per ciascuno è nel hub di documentazione collegato qui sotto.

Quali sono i limiti?

Il primo limite è la licenza. Il server si avvia in modalità valutazione, dove, secondo la pagina di licenza del server, l’output presenta limitazioni di valutazione; i limiti esatti sono nella pagina di licenza della libreria. Per uno strumento di filigranatura questo è importante: una copia prodotta in modalità valutazione è una bozza, non qualcosa da distribuire. Chiedi all’agente di chiamare get_license_status prima; restituisce mode (evaluation, licensed o metered) senza toccare un documento.

FAQ

Claude può aggiungere una filigrana a un PDF senza caricarlo?
Sì. Il server funziona come un processo locale che il tuo client avvia, e il percorso dei dati è agente, server locale, filesystem locale. Il modello vede il tuo prompt e le risposte testuali del server; i file dei documenti rimangono su disco.

Quali formati può filigranare un agente IA?
PDF, Word, Excel, PowerPoint, immagini e oltre 50 altri formati di documenti e immagini, con gli stessi due strumenti per tutti.

Come etichettare molti file contemporaneamente?
Indica la cartella nel prompt; l’agente chiama lo strumento per ogni file. Una guida completa è nel post batch collegato qui sotto.

Approfondisci