Bir AI ajanı, belgeleri kendi makinenizde, yükleme yapmadan filigranlayabilir: Düz bir dille sorarsınız, ajan GroupDocs.Watermark.Mcp sunucusunu çağırır ve işaretlenmiş bir kopya orijinalin yanında ortaya çıkar. Bu, Claude Desktop, Claude Code, Cursor, GitHub Copilot ile VS Code ve Windsurf’ta çalışır. Yerel olarak çalıştırılan tipik bir ilk istek:

contract.pdf dosyasına çapraz bir CONFIDENTIAL filigranı ekle.

Adım adım yapılandırma ve sorun giderme sürümü belgelerde bulunabilir: AI ajanlarıyla belgeleri filigranlamanın MCP kullanarak nasıl yapılacağı.

Neden LLM ile oluşturulan belgeler bir etiket taşımalı?

Bir LLM bir belgeyi taslak, özet ya da yeniden biçimlendirdiğinde, dosyalar nasıl üretildiğine dair hiçbir işaret olmadan dolaşır. Modele “üstte bir not ekle” demek içeriği değiştirir ve belgeyi yeniden yazan bir model nottan daha fazlasını değiştirebilir. Filigran, motor tarafından kaydedilmiş bir kopyada ayrı bir nesne olarak uygulanır, böylece altındaki metin yeniden üretilmez. Sunucu her sonucu yeni bir dosya olarak yazar; orijinal dosya aynı kalır. İşaret, seçtiğiniz düz metin ya da bir görüntüdür; sunucu belgenin AI tarafından üretilip üretilmediğini algılamaz ve hiçbir kaynak meta verisi eklemez. Bu, bir politika olarak tek cümleyle ifade edilebilir: bu klasörden çıkan her belge bir işaret taşır.

Filigran bir caydırıcıdır, erişim kontrolü değildir. Kaynağı görünür kılar ve rastgele yeniden kullanımını zorlaştırır. Kopyalamayı durdurmaz ve isteyen biri tarafından kaldırılabilir. Eğer müdahale kanıtına ihtiyacınız varsa, bunun yerine dijital imza kullanın.

Yöntem 1: Durumu metin olarak ekleyin

Etiket bir kelime veya kısa bir ifade olduğunda add_watermark kullanın: DRAFT, CONFIDENTIAL, bir tarih, “Generated with AI”.

summary.docx dosyasına çapraz bir AI-GENERATED filigranı ekle.

Ajan, text ile birlikte isteğe bağlı bir fontSize (varsayılan 36) ve rotation (varsayılan -45, klasik çapraz) parametreleriyle add_watermark çağırır. Beklenen sonuç: Added text watermark "AI-GENERATED" to "summary.docx" biçiminde bir mesaj ve çıktı klasörünüzdeki yeni dosyanın yolu.

Yöntem 2: Kaynağı bir görüntüyle işaretleyin

Etiket bir logo, damga ya da taranmış imza olduğunda add_image_watermark kullanın. Görüntü PNG, JPG, BMP veya TIFF olabilir ve belgeyle aynı depolama klasöründeki adından çözülür.

approved‑stamp.png dosyasını report.pdf dosyasının her sayfasına %30 opaklıkta yerleştir.

opacity 0.0 ile 1.0 arasında çalışır, varsayılan 0.5’tir. 0.2 ile 0.4 arasındaki değerler genellikle bir etiket olarak algılanır, engel değil.

Yöntem 3: Durumu ve kaynak işaretini birleştirin

Bir işaret yeterli olmadığında, örneğin kaynak logosu artı bir durum gibi, iki çağrı kullanın. Zincirleyin ve şöyle söyleyin:

Logoyu %30 opaklıkta ekleyin, ardından o sonuca DRAFT metin filigranı ekleyin.

Her çağrı yeni bir dosya yazar. “o sonuca” ifadesi olmadan ikinci çağrı orijinalden başlar ve yalnızca DRAFT işareti kalır.

Etiketin orada olduğunu nasıl kontrol edersiniz?

Bir belgenin ne taşıdığını sormak için search_watermarks kullanın. count ve bir watermarks dizisi içeren bir JSON nesnesi döndürür; her giriş type (text veya image), text, page, x, y, width, height ve rotateAngle içerir.

proposal.pdf dosyasında zaten bir filigran var mı ve ne diyor?

Etiketleme işleminden önce çalıştırın; zaten CONFIDENTIAL gösteren bir dosya iki açıyla iki kez damgalanmaz. İşlemden sonra çalıştırın ve işaretin orada olduğuna dair kanıt elde edin.

Örnek oturum (kısaltılmış)

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.

Nasıl kurulur?

.NET 10 SDK yüklü olduğunda, sunucu tek bir komutla başlar ve istemciniz kayıtlı olduğunda sizin için başlatır:

dnx GroupDocs.Watermark.Mcp --yes

GROUPDOCS_MCP_STORAGE_PATH değişkenini belgelerinizi tutan klasöre ayarlayın. Claude Desktop, Claude Code, Cursor, GitHub Copilot ile VS Code, Windsurf, Cline ve Codex CLI için kayıt blokları mevcuttur; her biri için kesin yapılandırma aşağıdaki belge merkezinde bulunur.

Sınırlamalar nelerdir?

İlk sınırlama lisanslamadır. Sunucu değerlendirme modunda başlar; sunucunun lisans sayfasına göre, çıktı değerlendirme kısıtlamaları taşır; kesin sınırlamalar kütüphanenin lisans sayfasında bulunur. Bir filigranlama aracı için bu önemlidir: değerlendirme modunda üretilen bir kopya bir taslaktır, dağıtılacak bir şey değildir. Ajanı önce get_license_status çağırmaya yönlendirin; belgeye dokunmadan mode (evaluation, licensed or metered) döndürür.

SSS

Claude bir PDF’yi yüklemeden filigranlayabilir mi?
Evet. Sunucu, istemcinizin başlattığı yerel bir süreç olarak çalışır ve veri yolu ajan, yerel sunucu, yerel dosya sistemi olur. Model, istemcinizi ve sunucunun metin yanıtlarını görür; belge dosyaları diskte kalır.

Hangi formatları bir AI ajanı filigranlayabilir?
PDF, Word, Excel, PowerPoint, görüntüler ve 50+ başka belge ve görüntü formatı, hepsi için aynı iki araç kullanılabilir.

Birçok dosyayı aynı anda nasıl etiketlerim?
Klasör adını istemde belirtin; ajan her dosya için aracı çağırır. Tam bir yürütme kılavuzu aşağıdaki toplu gönderide bulunur.

Daha derine in