Claude, Cursor veya GitHub Copilot gibi bir AI ajanına bir belgeyi imzalamasını isteyebilir ve bunu yerel olarak, kendi makinenizde, dosya ve sertifikanın asla dışarı çıkmadığı şekilde yapabilirsiniz. Ajan neyi ve nasıl imzalayacağını belirler; GroupDocs.Signature.Mcp sunucusu imzayı sign aracıyla uygular. Aşağıdakiler bu gibi bir komutla başlar:

contract.pdf dosyasını signing-cert.pfx kullanarak dijital olarak imzala.

Yapılandırma ve sorun giderme adımlarıyla birlikte adım adım sürüm dokümantasyonda bulunur: AI ajanlarıyla MCP kullanarak belgeleri imzalama.

Bir AI ajanına “sign” komutunu verdiğinizde ne anlama gelir?

Bu, görsel bir işaret ya da kriptografik bir imza anlamına gelebilir ve fark, otomasyona geçmeden önce önemlidir. sign aracı type için dört değer kabul eder: text, qrcode, barcode ve digital. İlk üçü sayfaya görsel bir işaret ekler. Yalnızca digital, kim tarafından imzalandığını kaydeden ve dosyada daha sonraki değişiklikleri herkesin tespit etmesini sağlayan sertifika destekli kriptografik bir imza uygular.

Dil modelleri bu ayrımı kendi başlarına yapmaz. Bir komut sadece “sign this” (bunu imzala) derse, ajan hangi türden bahsettiğinizi tahmin etmek zorundadır, bu yüzden türü belirtin. Aşağıdaki üç yöntem, en hafif işaretten en güçlüye doğru sıralanmıştır.

Yöntem 1: Sayfayı metin imzası ile damgalayın

Bir kişi ya da sürecin yalnızca belgenin işlendiğini görmesi gerektiğinde metin imzası kullanın: bir isim, bir tarih, bir onay etiketi.

report.docx dosyasına adım ve bugünün tarihini içeren bir metin imzası ekle.

Ajan, type: "text" ve verdiğiniz metinle sign komutunu çağırır. Sunucu, imzalı bir kopyayı çıktı klasörüne yazar ve orijinali dokunulmaz bırakır. Bu bir işarettir, kanıt değildir: sayfada bir etiket gösterir ve kim tarafından konulduğu ya da dosyanın sonradan değişip değişmediği hakkında bir şey söylemez.

Yöntem 2: Referans taşıyan bir QR kodu veya barkod ekleyin

İmzayı daha sonra bir makine, insan değil, okuyacaksa bir kod kullanın. QR kodu yapılandırılmış metin tutabilir ve barkod (Code39, Code128 ve EAN ailesi) tarama hatları iş akışlarına uygundur.

contract.pdf dosyasını ORDER-2026-0418 içeren bir QR kodu ile imzala.

Ajan, type: "qrcode" ve text: "ORDER-2026-0418" ile sign komutunu çağırır. Kodu isteyen her komutta metni açıkça verin ve ona güvenmeden önce search_qr_codes ile değeri geri okuyun. Metin damgası gibi, kod da görsel bir işarettir: işaretin varlığını kanıtlar, kim tarafından uygulandığını değil.

Yöntem 3: Sertifikaya dayalı dijital imza uygulayın

Kim tarafından imzalandığını ve dosyanın o zamandan beri değişmediğini göstermeniz gerektiğinde dijital imza kullanın. Ajan, sertifika dosyasını ve şifresini sign komutuna iletir:

contract.pdf dosyasını signing-cert.pfx kullanarak dijital olarak imzala.

Çağrı type: "digital", certificate ve certificatePassword kullanır. İkisi de yerel sunucu süreci tarafından yerel diskte okunur ve imzalama aynı süreç içinde gerçekleşir. Bir imzalama hizmeti kullanılmadığından, anahtar ya da şifre hiçbir yere iletilmez. Şifreyi, bağlı bir istemci yapılandırmasına eklemek yerine bir ortam değişkeninde tutun.

Burada sıralama önemlidir. Görsel işaretler dosyayı yeniden yazar, bu yüzden dijital imzadan sonra eklenen herhangi bir metin damgası veya kod onu geçersiz kılar. Tüm görsel işaretleri önce, dijital imzayı ise son olarak uygulayın ve ajan birden fazla imza zincirleyecekse bunu komutta belirtin.

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

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.

Örnek çıktı: dosya adı ve QR değeri uydurulmuştur. Araç yukarıda açıklanan alanları döndürür.

Bir AI ajanının sizin için imzalayamayacağı şeyler nelerdir?

Bir ajan bir imza uygulayabilir; bu imzayı yasal olarak bağlayıcı hâle getiremez. Bu sunucu barındırılan bir e-imza hizmeti ya da nitelikli bir güven hizmeti sağlayıcısı değildir. Sağladığınız sertifikayla, tek bir makinede, tek bir istemci süreci için imza uygular.

Sonucun, eIDAS nitelikli imza gibi belirli bir yasal rejime uygun olup olmadığı, bu sunucudan ziyade sertifika ve onun etrafındaki sürece bağlıdır. Bir anlaşmazlık olasıysa, otomasyona geçmeden önce hangi sertifikanın ve sürecin uygulanacağını sorun.

Bilmeniz gereken değerlendirme sınırlamaları

Lisans olmadan sunucu değerlendirme modunda çalışır: yalnızca ilk 2 sayfa işlenir ve her sayfaya bir deneme rozeti damgalanır. Bir sözleşmenin 5. sayfası için tasarlanmış bir imza yerleştirilmez ve bunu belirten bir hata mesajı da gösterilmez. Önemli bir imzalama işleminden önce şunu sorun:

İmza sunucusunun lisans durumu nedir?

Ajan, belgeye dokunmadan modu (değerlendirme, lisanslı veya ölçülü) raporlayan get_license_status komutunu çağırır.

SSS

AI belgeleri benim için imzalayabilir mi?
Bir ajan, sign aracıyla yerel olarak bir belgeye metin, QR kodu, barkod veya sertifikaya dayalı bir imza uygulayabilir. Bu imzanın yasal ağırlığı, sertifikaya ve sizin yargı bölgenize bağlıdır, ajana değil.

Claude bir PDF’i hiçbir yere yüklemeden imzalayabilir mi?
Evet. MCP sunucusu, istemcinin bir alt süreci olarak stdio üzerinden çalışır; gelen bağlantı noktaları, dış uç noktalar ve telemetri yoktur. Yol ajan, yerel sunucu, yerel dosya sistemi şeklindedir.

Bu hangi istemcilerle çalışır?
Claude Desktop, Claude Code, GitHub Copilot ile VS Code, Visual Studio 2022 (17.14+), Cursor, Windsurf, Cline, Codex CLI ve JetBrains Rider. dnx GroupDocs.Signature.Mcp --yes komutuyla ya da Docker görüntüsü ghcr.io/groupdocs-signature/signature-net-mcp ile kurun.

Daha derine inin