Pour marquer automatiquement les documents, donnez à un agent IA une instruction permanente et laissez‑le appeler un outil de filigrane d’image localement pour chaque fichier du dossier de sortie. Avec le serveur GroupDocs.Watermark.Mcp, cette instruction peut être une seule ligne dans un fichier de règles, une instruction de projet dans Claude Code, ou une invite que vous collez dans Cursor :
Placez logo.png sur chaque page de chaque fichier du dossier de sortie à 25 % d’opacité, puis listez les fichiers que vous avez produits.
La version étape par étape avec configuration et dépannage se trouve dans la documentation : Comment marquer les documents avec un filigrane de logo à l’aide de l’IA.
Pourquoi le marquage manuel dérive-t-il ?
Le marquage appliqué manuellement varie selon la personne : une équipe colle le logo dans le fichier source, une autre tamponne le PDF à pleine intensité, une troisième oublie. Un LLM qui « ajoute un logo » en modifiant le contenu du document n’a pas non plus de placement stable. L’outil add_image_watermark applique le logo comme un objet de filigrane, avec des valeurs explicites opacity et rotation, de sorte que les mêmes entrées donnent la même intensité et le même angle. Parce qu’il s’agit d’un objet et non d’un contenu collé, le logo peut être trouvé et retiré plus tard lorsque la marque change.
Que décide l’agent, et que fait le moteur ?
| Étape | Décide l’agent | Fait le moteur |
|---|---|---|
| Quels fichiers sont concernés | Lit le dossier et votre instruction | Rien |
| Quel outil appeler | add_image_watermark pour un logo, add_watermark pour un statut |
Rien |
| Intensité et angle | Transmet opacity et rotation de votre norme |
Dessine le filigrane avec exactement ces valeurs |
| Sortie | Signale les fichiers produits | Écrit un nouveau fichier ; l’original n’est pas modifié |
La norme vit dans votre invite. Le serveur ne se planifie pas lui‑même et n’a aucune politique de marque intégrée ; la partie réutilisable est l’instruction que vous enregistrez et réutilisez.
Comment appliquer la norme en cinq étapes ?
- Conservez le logo à côté des documents. Le document et l’image sont résolus par leur nom depuis le dossier de stockage (
GROUPDOCS_MCP_STORAGE_PATH). Utilisez un PNG transparent ; un logo sur un rectangle blanc affichera ce rectangle sur la page. - Séparez les fichiers de sortie. Définissez
GROUPDOCS_MCP_OUTPUT_PATHvers un dossier différent si vous souhaitez que les copies marquées soient séparées des sources. Si non défini, la sortie va dans le dossier de stockage. - Vérifiez la licence. Demandez : « Quel est l’état de la licence du serveur de filigrane ? » L’agent appelle
get_license_status. - Exécutez l’invite standard. Une opacité entre 0,2 et 0,4 est la plage recommandée par la documentation pour le marquage ; au‑dessus de 0,6 le logo domine la page.
- Vérifiez. Demandez un passage
search_watermarkssur chaque fichier produit et comparez le nombre avec ce que vous attendez.
Le filigrane peut‑il également indiquer un statut ?
Oui, avec un deuxième appel en chaîne. Marquez et indiquez le statut en une seule requête :
Ajoutez le logo à 25 % d’opacité, puis ajoutez un filigrane texte CONFIDENTIAL à ce résultat.
Chaque appel écrit un nouveau fichier, donc « à ce résultat » est ce qui conserve les deux filigranes.
Exemple de session (abrégé)
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.
Itérer de cette façon est sûr car chaque tentative crée un nouveau fichier. Supprimez les fichiers rejetés par la suite.
Quel canal de distribution convient à un déploiement d’équipe ?
Pour une configuration partagée, l’image Docker évite d’installer quoi que ce soit d’autre sur chaque machine, car le runtime et les dépendances natives sont à l’intérieur :
docker run --rm -i -v $(pwd)/documents:/data \
ghcr.io/groupdocs-watermark/watermark-net-mcp:latest
Le canal NuGet (dnx GroupDocs.Watermark.Mcp --yes) nécessite le SDK .NET 10. Les deux fonctionnent sous Windows, Linux et macOS (dnx sous Linux/macOS nécessite également libgdiplus), et les deux utilisent les mêmes six outils, de sorte que l’invite de marque ne change pas entre eux.
Quelles sont les limites ?
Planifiez autour de deux limites. Premièrement, l’outil n’expose que opacity et rotation : il n’y a aucun réglage de position, de taille ou de marge. Deuxièmement, le mode d’évaluation : la page de licence du serveur indique que la sortie non licenciée comporte des limitations d’évaluation (les limites exactes sont sur la page de licence), ainsi les copies marquées produites sans licence ne sont pas distribuables. Exécutez get_license_status avant un déploiement de marque. Sous licence à la consommation chaque fichier traité est facturé, et sous licence fichier le serveur fonctionne hors ligne. Gardez également à l’esprit qu’un filigrane étiquette un document ; il ne protège pas le contenu qui se trouve en dessous.
FAQ
L’IA peut‑elle ajouter le logo de notre entreprise à tous les PDF ?
Oui. Demandez le logo par son nom de fichier et indiquez une opacité ; l’agent appelle add_image_watermark une fois par fichier. Le même appel fonctionne également sur Word, PowerPoint, Excel et les fichiers image.
Puis‑je utiliser le même logo sur les images et les documents ?
Oui. Les images sont des cibles valides, donc le marquage des photos de produit fonctionne comme le marquage d’un PDF.
Que se passe‑t‑il lorsque la marque change ?
remove_watermarks peut retirer l’ancien logo, car il a été appliqué comme un objet de filigrane. Son textFilter ne correspond qu’au texte du filigrane, donc supprimer un logo image signifie supprimer tous les filigranes, y compris les marques texte. Recherchez d’abord pour savoir ce qui est présent, puis ajoutez le nouveau logo.
Approfondir
- Documentation, guide canonique : Comment marquer les documents avec un filigrane de logo à l’aide de l’IA
- Hub de documentation : GroupDocs.Watermark MCP Server
- Commencez ici : 3 façons d’étiqueter les documents générés par IA avec des filigranes via MCP
- Lié : Filigraner un dossier entier en une seule invite
- Lié : Pourquoi auditer les filigranes dans vos propres documents avant d’en supprimer
- Sur site et modèle de sécurité : 3 architectures pour le traitement de documents IA, et celle qui garde les fichiers dans votre réseau
- Questions : GroupDocs Watermark forum
- Source : GroupDocs.Watermark.Mcp on GitHub