You can have an AI agent put its review comments inside the document instead of in the chat. The GroupDocs.Annotation.Mcp server lets an LLM in Claude, Cursor or GitHub Copilot add highlights, notes and strikeouts to a PDF, Word, Excel or PowerPoint file, and it writes them locally on your machine:

Sayfada 2 ödeme maddesini vurgulayın ve hukuk biriminin onaylamasını isteyen bir not ekleyin.

AI geri bildiriminin sohbet penceresinde kaybolmasının nedeni nedir?

Bir asistana bir sözleşmeyi gözden geçirmesini istediğinizde bir liste alırsınız: “Madde 4 sorumluluğu devreder, madde 7 açık bir tarih içeriyor.” Bu liste bir konuşmanın içinde kalır. Sözleşmeyi gelecek hafta açacak olan meslektaş bu bilgiyi görmez ve her bir noktayı doğru paragrafla elle eşleştirmeniz gerekir.

Sorun ajan değil. Dosyaya yazma yeteneği yok. Bir inceleme, okuyucunun metnin yanına geldiği yerde faydalıdır; yani ilgili metnin yanında.

Yanlış yaklaşım nasıl görünür?

Yaygın geçici çözüm, belge metnini bir sohbete yapıştırıp yorum istemektir. Üç sorun ortaya çıkar ve bunları kendi belgenizde kontrol edebilirsiniz:

  • Yorumların konumu yoktur. “Sayfa 2, ikinci paragraf” bir açıklamadır ve siz çözümlemeniz gerekir.
  • Sonuç bir transkript olur, teslim edilebilir bir şey değildir. Bir sonraki gözden geçirmeye sadece ekran görüntüsü ya da yapıştırılmış bir blok gönderilebilir.
  • Belge değişmez, bu yüzden inceleme filtrelenemez, sayısı bulunamaz ya da bir sonraki taslağa taşınamaz.

Doğru yaklaşım: belgeleri bir AI ajanı ile ekleyin

İşi her iki tarafın da iyi olduğu alana bölün. Ajan “riskimizi artıran her şeyi işaretle” talimatını anlar. Motor ise gerçek dosyaya gerçek bir ek açıklama yazar. Yazma işini yapan araç add_annotationdır. Yedi ek açıklama türünü kabul eder: textfield, area, point, arrow, highlight, underline ve strikeout. Argümanları dosya, tür, metin, 1‑tabanlı sayfa numarası ve x/y belge koordinatlarıdır.

Sonuç, orijinal dosyanızın yanına <name>_annotated.<ext> olarak kaydedilir. Orijinal dosya hiç değiştirilmez. Aynı çağrı, motorun desteklediği 50+ formatta çalışır; böylece bir Word taslağı ve bir PDF aynı şekilde işaretlenir.

Hangi araçlar konumu doğru yapar?

Koordinatlar, sayfayı göremeyen herhangi bir ajan için zayıf noktadır ve dokümantasyon bunu açıkça söyler. Üç araç tahmin işini azaltır:

  • get_document_info dosya tipini, sayfa sayısını ve boyutunu, motor bunları raporladığında sayfa başına genişlik ve yüksekliği döndürür; bu da ajana bir sayfa kutusu verir.
  • get_annotations mevcut ek açıklamaları sınırlayıcı kutularıyla döndürür; ajan bunları referans olarak kullanabilir.
  • generate_pages_preview bir sayfayı resim olarak render eder, böylece görsel yeteneği olan bir model metni konumlandırmadan önce bulabilir. Şu anda Linux’ta PDF dosyaları için başarısız olur; limitler bölümüne bakın.

Zincirli ek açıklamalarda tek tuzak nedir?

Her yazma aracı yeni bir dosya kaydeder. İkinci ek açıklama, ilk çağrının ürettiği dosyaya uygulanmalı, orijinale değil; aksi takdirde ilk ek açıklama, kimsenin tekrar açmadığı bir dosyada kalır. Bunu istemde belirtin:

Ödeme maddesini vurgulayın, ardından oluşan dosyada eski teslim tarihini üzerini çizin.

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

Bu, araçların belgelenen davranışına dayanarak hazırlanmış bir örnek, yakalanmış bir ekran görüntüsü değildir.

You:   Highlight the payment clause on page 2 of contract.pdf and add a note
       asking legal to confirm.

Agent: [calls get_document_info on contract.pdf]
       contract.pdf is a PDF with 6 pages.
       [calls add_annotation: type=highlight, page=2, x=100, y=250,
        text="Legal to confirm these payment terms"]
       Added highlight annotation to contract.pdf on page 2.
       The annotated copy is contract_annotated.pdf. Your original is unchanged.

AI istemcimde ek açıklama sunucusunu nasıl başlatırım?

Bir konteyner olarak çalıştırmak için belgelerinizin bulunduğu klasörü /data altında bağlayın:

docker run --rm -i -v $(pwd)/documents:/data \
  -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output \
  ghcr.io/groupdocs-annotation/annotation-net-mcp:latest

Konteyner kullanmak istemiyorsanız .NET 10 SDK’yı kurun ve dnx GroupDocs.Annotation.Mcp --yes komutunu başlatın; Windows’ta bu aynı zamanda PDF sayfa önizlemeleri için kullanılan kanaldır. Hub sayfası Claude Desktop, Claude Code, VS Code with GitHub Copilot, Cursor, Windsurf ve diğer istemciler için hazır kayıt snippet’leri sunar. Düzenlemeleri zincirlerken üretilecek dosyanın depolama klasöründen farklı bir klasöre GROUPDOCS_MCP_OUTPUT_PATH ayarlayın. Varsayılan (çıktılar depolama klasörüne gider) ile ikinci yazma being used by another process hatası verir; ayrı bir çıktı klasörüyle add_reply, update_annotation ve remove_annotations üretilecek dosyada başarılı olur. Docker imajı ile -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output parametresini geçin. Kayıt sonrası istemci sunucuyu kendisi başlatır ve stdio üzerinden iletişim kurar; böylece hiçbir şey ağ portunda dinlemez ve sunucu belge içeriğini bir bulut servisine göndermez.

Dürüst limitler

  • Değerlendirme modu. Lisans olmadan, her sayfanın üstüne bir deneme rozeti damgalanır, bu yüzden ek açıklamalı çıktı dağıtılamaz. İlk olarak “Ek açıklama sunucusunun lisans durumu nedir?” sorun; ajan get_license_status çağırır.
  • Yardım olmadan konum yaklaşık olur. Bir ajanın istemden x/y tahmin etmesi, bir area ya da point ek açıklamasını yaklaşık olarak yerleştirir. Kesin konum için önce okuyun ya da önce render edin.
  • Linux’ta önizleme. generate_pages_preview şu anda Linux’ta PDF dosyaları için başarısız olur, Docker imajı dahil (TypeInitializationException for Gdip: System.Drawing.Common is not supported on non-Windows platforms); Word ve diğer Office belgeleri render olur ve Windows’ta dnx ile her format render edilir. Diğer on araç etkilenmez.

SSS

Claude bir PDF’ye yorum ekleyebilir mi? Evet, bir MCP sunucusu aracılığıyla bir ek açıklama aracı sunar. GroupDocs.Annotation.Mcp ile ajan add_annotation çağırır ve yorum <name>_annotated.pdf içine yazılır.

AI belgeyi eklemek için yüklemeli mi? Hayır, sunucu üzerinden değil: Dosyayı bağladığınız klasörde açar ve ek açıklamalı kopyayı yanına kaydeder. Modelin kendisinin gördüğü şeyler, örneğin yapıştırdığınız metin ya da ajanın görüntülediği sayfa resimleri, model sağlayıcınıza gider.

Sadece PDF değil, Word ve Excel’da da çalışır mı? Evet. Aynı ek açıklama türleri PDF, DOCX, XLSX, PPTX ve resimler üzerinde çalışır; dokümantasyonda listelenen 50+ formatla uyumludur.

Daha derine in