A GroupDocs MCP sunucusu, Claude Desktop, Claude Code, Cursor, GitHub Copilot ve diğer MCP istemcilerinin belgelerinizle yerel olarak çalışmasını sağlar: istemci, sunucuyu kendi makinenizde bir alt süreç olarak başlatır ve dosyalar seçtiğiniz klasörlerde okunur ve yazılır. Tam mimari ve güvenlik modeli, her ürünün yerinde sayfasında belgelenmiştir; örneğin Running GroupDocs MCP servers on-premise: architecture and security model. Bu gönderi, bir AI ajanını belgelere bağlamanın üç yaygın yolunu karşılaştırır ve neyin makineden çıkıp neyin çıkmadığını açıklar.

Hangi mimariler bir AI ajanını belgelere bağlayabilir?

Üç tane vardır. Güvenlik inceleyicisinin önce sorduğu soru farklıdır: belge nereye gider?

Bulut yükleme Barındırılan API Yerel MCP sunucusu
Nasıl çalışır Asistan veya bir eklenti dosyayı bir satıcı hizmetine yükler Kodunuz veya ajanın dosyayla birlikte bir satıcı REST API’sini çağırır AI istemcisi makinenizde bir sunucu süreci başlatır
Belgenin gittiği yer Üçüncü taraf bulut Üçüncü taraf bulut veya kendi kiracınız Hiçbir yere: yerel klasörlerden okunur ve yazılır
Ağ yüzeyi Satıcıya giden çıkış Satıcıya giden çıkış yalnızca stdio; lisans dosyasıyla hiçbir şey, sadece kullanım raporları (belge içeriği yok) ölçülü lisanslama ile
Gelen bağlantı noktaları Uygulanamaz Uygulanamaz Hiçbiri
Havayla izole kullanım Mümkün değil Genellikle değil; satıcının dağıtım seçeneklerine bağlı Lisans dosyasıyla mümkün
Kim çalıştırır Satıcı Satıcı Siz, AI istemcisinin bir parçası olarak

Üçüncü sütun, GroupDocs MCP sunucularının uyguladığı şeydir. Bu gönderinin geri kalanı, nasıl çalıştığını ve sınırlarının nerede olduğunu ele alır.

Yerel bir MCP sunucusunun veri akışı nasıl görünür?

AI istemcisi sunucuyu bir alt süreç olarak başlatır ve JSON‑RPC kullanarak standart giriş ve çıkış üzerinden iletişim kurar. Sunucu hiçbir zaman bir ağ bağlantı noktasını dinlemez ve bir lisans dosyasıyla dışa doğru bağlantı yapmaz.

+--------------+          +--------------------+         +------------------+
|  AI client   |  stdio   | MCP server process | reads / | local filesystem |
| (Claude,     | <------> | (GroupDocs engine) | <-----> | storage / output |
|  Cursor, ..) | JSON-RPC |   child process    |  writes |     folders      |
+--------------+          +--------------------+         +------------------+
       |
       | prompts and quoted fragments only
       v
+--------------------+
|   model provider   |  (cloud, or a local model inside your network)
+--------------------+

Bir güvenlik inceleyicisi dört kontrol edilebilir ifade alır:

  • Taşıma: bir alt sürece standart giriş ve çıkış. Güvenlik duvarı için bir şey yok ve açığa çıkarılacak bir şey yok.
  • Gelen bağlantı noktaları: hiçbiri.
  • Telemetri: yok. Belge motoru aynı süreç içinde çalışır.
  • Ağ kullanımı: yalnızca kurulum sırasında, paketi nuget.org’dan veya görüntüyü ghcr.io’dan çekmek için. Çalışma zamanında sunucu dışa doğru hiçbir çağrı yapmaz; aşağıda açıklanan lisanslama istisnası hariç.

Bunu kendiniz doğrulayabilirsiniz: bir görev çalıştırın ve dinleme soketlerini ve dışa doğru bağlantıları izleyin.

Bir ajan bir belgeyi işlediğinde ne makineden çıkar?

Belgeler makineden çıkmaz. İstemler ve alıntılanan parçalar çıkar.

AI istemcinizin arkasındaki model konuşmayı görür. Model bulut‑barındırmalıysa, talimat metniniz model sağlayıcısına ulaşır ve ajan size geri alıntı yaptıkça o da sağlayıcıya gider. İki örnek:

  • Bir karşılaştırmadan sonra, bir ajan ödeme koşulunun 30 günden 45 güne değiştiğini rapor eder. Bu cümle konuşmanın bir parçasıdır ve sağlayıcıya gider.
  • Bir çıkarımdan sonra, bir ajan fatura toplamını rapor eder. Dosya hareket etmez, ancak o değer gider.

Kullanışlı bir alışkanlık, yanıtın daha az içerik taşıması için istemleri şekillendirmektir; örneğin toplamları sormak yerine bir eşik üzerindeki dosyaları sorabilirsiniz. Hassas veri kümeleri için sunucuyu yerel barındırılan bir modelle eşleştirin. Böylece tüm döngü (istemci, model, sunucu, dosyalar) ağınız içinde kalır.

Yerel bir sunucu internet erişimine ihtiyaç duyuyor mu?

İşleme için hayır. Lisans moduna bağlıdır:

  • Lisans dosyası: yerel süreç tarafından yerel diskte okunur. Bu tamamen çevrim dışı çalışır ve havayla izole ağlar için doğru seçimdir.
  • Ölçülü (kullandıkça öde) lisans: sunucu kullanımı GroupDocs’a raporlar, bu yüzden dışa doğru çıkış gerekir. Rapor belge içeriği içermez, ancak bağlantının güvenlik duvarınız tarafından izin verilmesi gerekir.

Hem ölçülü anahtarlar hem de bir lisans dosyası yapılandırılmışsa, ölçülü anahtarlar önceliklidir. Anahtarları, yapılandırmaya bağlı olarak değil, ortam değişkenlerinde tutun. Her ürünün lisanslama sayfası kurulumu açıklar ve get_license_status aracı aktif modu raporlar.

Sunucuyu Docker ile sınır içinde nasıl çalıştırırsınız?

Docker görüntüsü, platform ekibi için genellikle daha kolay bir seçenektir: yerel bağımlılıkları içeren tek bir görüntü, hostta SDK yok ve sınır, bağladığınız klasörlerle sınırlıdır. Her ürünün kendi görüntüsü vardır, adı ghcr.io/groupdocs-<product>/<product>-net-mcp. Aşağıdaki komut bir ürün için şekli gösterir; yer tutucuları değiştirin.

docker run --rm -i \
  -v /srv/documents:/data \
  -v /srv/licenses:/license:ro \
  -e GROUPDOCS_MCP_STORAGE_PATH=/data \
  -e GROUPDOCS_LICENSE_PATH=/license/GroupDocs.<Product>.lic \
  ghcr.io/groupdocs-<product>/<product>-net-mcp:<tag>
  • Etiketi sabitleyin. Hızlı‑başlangıç komutları :latest kullanır; üretimde, test ettiğiniz sürüme etiketi sabitleyin, böylece bir yeniden derleme çalışan bir iş akışı altında davranışı değiştiremez.
  • Bilerek bağlayın. Konteyner yalnızca verdiğiniz klasörleri görür; bu, kullanıcı olarak çalışan bir sürece göre daha sıkı bir sınırdır.
  • Lisansı yalnızca‑okunur bağlayın.
  • Havayla izole bölümler: görüntüyü önceden çekin veya NuGet paketini önbelleğe alın ve sürümü sabitleyin.

AI istemciniz bu docker run komutunu MCP yapılandırmasında sunucu komutu olarak çalıştırır, böylece konteyner yukarıdaki diyagramdaki alt süreç olur. Belgeler, görüntülerin çok‑mimarlı (linux/amd64 ve linux/arm64) olduğunu belirtir.

Yerel bir MCP sunucusu düzenlenmiş sektörler için uygun mu?

Bu, gizlilik incelemesindeki en büyük soruyu ortadan kaldırır: belgelerin üçüncü taraf bir işlemciye aktarılması. Belgeleri yüklemeyi yasaklayan yasal, finans, sağlık ve kamu sektörü ekipleri, HIPAA veya GDPR odaklı iş akışları için bir yapı taşı olarak kullanabilir. Bu sadece mimari uygunluğu tanımlar. GroupDocs MCP sunucuları herhangi bir düzenleme için sertifikalı değildir ve yükümlülükleriniz hâlâ kullandığınız model, lisans modunuz ve kendi kontrollerinize bağlıdır.

Bu modelin sınırlamaları nelerdir?

  • Bir sunucu bir istemci sürecine hizmet eder. Bir stdio sunucusu bir istemci tarafından bir makinede başlatılır. Çok‑kullanıcı hizmeti değildir. Paylaşımlı bir hizmet için, birçok MCP sunucusu çalıştırmak yerine GroupDocs kütüphanesinin önüne kendi hizmetinizi koyun.
  • Ölçülü lisanslama dışa çıkış gerektirir. Kullanım raporları yukarıda açıklandığı gibi dışarı gider. Ağ kapalı olmalıysa lisans dosyasını seçin.
  • İstemler hâlâ model sağlayıcısına ulaşır yerel bir model kullanmadığınız sürece.
  • Değerlendirme modunun sınırlamaları vardır. Lisans olmadan sunucular ürün‑özel kısıtlamalarla değerlendirme modunda çalışır. Örneğin, Comparison sunucusu yalnızca ilk 2 sayfayı karşılaştırır ve sonucu filigranlar. Önce get_license_status çağırın ve ürününüzün lisanslama sayfasını okuyun.
  • Parser ve Search yalnızca Docker görüntüleri olarak sunulur. GroupDocs.Parser.Mcp ve GroupDocs.Search.Mcp’nin NuGet paketi yoktur, bu yüzden yukarıdaki Docker yolu bu ürünler için tek yoldur. Linux hostta, konteynerlerini --user "$(id -u):$(id -g)" ile çalıştırın, böylece bağladığınız klasörlere yazabilirler.
  • Platform istisnaları. İki PDF‑özel işlem şu anda Linux’ta, Docker görüntüsü dahil, başarısız olur; çünkü PDF motorunun görüntü işleme kısmı System.Drawing.Common’a dayanır ve .NET bunu yalnızca Windows’ta destekler: GroupDocs.Annotation.Mcp generate_pages_preview PDF dosyalarında (Word belgeleri render olur), ve GroupDocs.Redaction.Mcp redact_image_area ve erase_metadata PDF dosyalarında (redact_text PDF’de ve üçü de Word belgelerinde çalışır). Bunları Windows’da dnx ile çalıştırın; ürün gönderilerine bakın.

SSS

MCP hassas belgeler için güvenli mi?
GroupDocs MCP sunucusuyla belgeler, stdio üzerinden aynı makinede süreç içinde işlenir; dinleme bağlantı noktası yoktur ve telemetri yoktur. Değerlendirmeniz gereken tek şey, AI istemcinizin kullandığı modeldir; çünkü istemler ve alıntılanan parçalar oraya gider.

Claude araçlarını buluta veri göndermeden çalıştırabilir miyim?
Belgeler her iki durumda da yerel kalır. İstemleri de yerel tutmak için, yerel barındırılan bir modeli destekleyen bir istemci kullanın; böylece konuşmanın hiçbir bölümü ağınızdan çıkmaz.

Bir MCP sunucusu ne tür veri gönderir?
Çalışma zamanında, lisans dosyası kullanıldığında GroupDocs MCP sunucusu ağ üzerinden hiçbir şey göndermez. Ölçülü lisanslama ile kullanım raporları GroupDocs’a gönderilir, belge içeriği asla gönderilmez.

Ürün bazında: belgelerdeki yerinde sayfalar

Her sayfa aynı mimariyi, o ürün için komutları içerir. Bunlar, bir güvenlik incelemesi için kanonik referanslardır.

Ürün bazında: blogda nereden başlayabilirsiniz

Her ürünün bir dizi gönderisi vardır — çoğu için dört, Search için altı. İlk gönderi deseni açıklar; diğerleri uygular.