A GroupDocs MCP server memungkinkan Claude Desktop, Claude Code, Cursor, GitHub Copilot, dan klien MCP lainnya bekerja dengan dokumen Anda secara lokal: klien memulai server sebagai proses anak di mesin Anda sendiri, dan file dibaca serta ditulis di folder yang Anda pilih. Arsitektur lengkap dan model keamanannya didokumentasikan pada halaman on‑premise masing‑masing produk, misalnya Menjalankan server GroupDocs MCP on‑premise: arsitektur dan model keamanan. Posting ini membandingkan tiga cara umum untuk menghubungkan agen AI ke dokumen dan menjelaskan apa yang keluar dan tidak keluar dari mesin.

Arsitektur apa yang dapat menghubungkan agen AI ke dokumen?

Ada tiga. Mereka berbeda dalam pertanyaan yang diajukan peninjau keamanan pertama kali: ke mana dokumen pergi?

Unggah ke Cloud API yang Dihosting Server MCP Lokal
Cara kerjanya Asisten atau plugin mengunggah file ke layanan vendor Kode atau agen Anda memanggil REST API vendor dengan file Klien AI memulai proses server di mesin Anda
Ke mana dokumen pergi Cloud pihak ketiga Cloud pihak ketiga atau tenant Anda sendiri Tidak ke mana‑pun: dibaca dan ditulis ke folder lokal
Permukaan jaringan Keluar ke vendor Keluar ke vendor Hanya stdio; tidak ada dengan file lisensi, laporan penggunaan saja (tanpa konten dokumen) dengan lisensi bermeter
Port masuk Tidak berlaku Tidak berlaku Tidak ada
Penggunaan air‑gapped Tidak memungkinkan Biasanya tidak; tergantung pada opsi penyebaran vendor Memungkinkan dengan file lisensi
Siapa yang menjalankannya Vendor Vendor Anda, sebagai bagian dari klien AI

Kolom ketiga adalah apa yang diimplementasikan oleh server GroupDocs MCP. Sisa posting ini membahas cara kerjanya dan batasannya.

Bagaimana aliran data server MCP lokal?

Klien AI meluncurkan server sebagai proses anak dan berkomunikasi dengannya melalui standar input dan output menggunakan JSON‑RPC. Server tidak pernah mendengarkan pada port jaringan, dan dengan file lisensi tidak membuat koneksi keluar sama sekali.

+--------------+          +--------------------+         +------------------+
|  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)
+--------------------+

Peninjau keamanan mendapatkan empat pernyataan yang dapat diperiksa:

  • Transport: standar input dan output ke proses anak. Tidak ada yang perlu difirewall dan tidak ada yang perlu diekspos.
  • Port masuk: tidak ada.
  • Telemetry: tidak ada. Mesin dokumen berjalan dalam proses.
  • Penggunaan jaringan: hanya pada saat instalasi, untuk mengambil paket dari nuget.org atau gambar dari ghcr.io. Pada saat runtime server tidak membuat panggilan keluar, kecuali satu pengecualian lisensi yang dijelaskan di bawah.

Anda dapat memverifikasinya alih‑alih mempercayainya: jalankan sebuah tugas dan perhatikan socket yang mendengarkan serta koneksi keluar.

Apa yang keluar dari mesin ketika agen memproses dokumen?

Dokumen tidak keluar dari mesin. Prompt dan fragmen yang dikutip yang keluar.

Model di belakang klien AI Anda melihat percakapan. Jika model di‑hosting di cloud, teks instruksi Anda mencapai penyedia model, dan begitu pula apa pun yang agen kutip kembali kepada Anda. Dua contoh:

  • Setelah perbandingan, agen melaporkan bahwa ketentuan pembayaran berubah dari 30 menjadi 45 hari. Kalimat itu merupakan bagian dari percakapan dan dikirim ke penyedia.
  • Setelah ekstraksi, agen melaporkan total faktur. File tidak berpindah, tetapi nilai tersebut berpindah.

Kebiasaan yang berguna adalah merumuskan prompt sehingga jawabannya membawa konten yang lebih sedikit, misalnya menanyakan file mana yang memiliki total di atas ambang batas alih‑alih menanyakan totalnya. Untuk korpus sensitif, padukan server dengan model yang di‑hosting secara lokal. Maka seluruh lingkaran (klien, model, server, file) tetap berada di dalam jaringan Anda.

Apakah server lokal memerlukan akses internet?

Tidak untuk pemrosesan. Itu tergantung pada mode lisensi:

  • File lisensi: dibaca dari disk lokal oleh proses lokal. Ini berfungsi sepenuhnya offline dan merupakan pilihan yang tepat untuk jaringan air‑gapped.
  • Ber‑meter (bayar‑per‑pakai): server melaporkan penggunaan ke GroupDocs, sehingga memerlukan egress keluar. Laporan tidak berisi konten dokumen, tetapi koneksi itu sendiri harus diizinkan oleh firewall Anda.

Jika kedua kunci ber‑meter dan file lisensi dikonfigurasi, kunci ber‑meter yang diutamakan. Simpan kunci dalam variabel lingkungan daripada dalam konfigurasi yang dikomit. Halaman lisensi masing‑masing produk menjelaskan penyiapannya, dan alat get_license_status melaporkan mode aktif.

Bagaimana cara menjalankan server di dalam perimeter dengan Docker?

Image Docker sering menjadi opsi yang lebih mudah bagi tim platform: satu image dengan dependensi native, tanpa SDK di host, dan batasan terbatas pada folder yang Anda mount. Setiap produk memiliki image‑nya sendiri, bernama ghcr.io/groupdocs-<product>/<product>-net-mcp. Perintah di bawah menunjukkan bentuk untuk satu produk; ganti placeholder‑nya.

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>
  • Pin tag-nya. Perintah quick‑start menggunakan :latest; untuk produksi, pin tag ke versi yang Anda uji sehingga rebuild tidak dapat mengubah perilaku dalam alur kerja yang berjalan.
  • Mount dengan sengaja. Kontainer hanya melihat folder yang Anda berikan, yang merupakan batasan lebih ketat daripada proses yang berjalan sebagai pengguna Anda.
  • Mount lisensi read‑only.
  • Segmen air‑gapped: pra‑tarik image, atau pra‑cache paket NuGet, dan pin versinya.

Klien AI Anda menjalankan perintah docker run ini sebagai perintah server dalam konfigurasi MCP‑nya, sehingga kontainer menjadi proses anak dalam diagram di atas. Dokumentasi menjelaskan image‑nya sebagai multi‑arch (linux/amd64 dan linux/arm64).

Apakah server MCP lokal cocok untuk industri yang diatur?

Ini menghilangkan pertanyaan terbesar dalam tinjauan privasi, yaitu transfer dokumen ke pemroses pihak ketiga. Tim di bidang hukum, keuangan, perawatan kesehatan, dan sektor publik yang kebijakannya melarang mengunggah dokumen dapat menggunakannya sebagai blok bangunan untuk alur kerja berorientasi HIPAA atau GDPR. Ini hanya menggambarkan kesesuaian arsitektural. Server GroupDocs MCP tidak disertifikasi untuk regulasi apa pun, dan kewajiban Anda tetap bergantung pada model yang Anda padukan, mode lisensi, dan kontrol Anda sendiri.

Apa batasan model ini?

  • Satu server melayani satu proses klien. Server stdio dimulai oleh satu klien pada satu mesin. Ini bukan layanan multi‑pengguna. Untuk layanan bersama, letakkan layanan Anda sendiri di depan pustaka GroupDocs alih‑alih menjalankan banyak server MCP.
  • Lisensi ber‑meter memerlukan egress. Laporan penggunaan dikirim keluar, seperti dijelaskan di atas. Pilih file lisensi jika jaringan harus ditutup.
  • Prompt tetap mencapai penyedia model kecuali Anda menggunakan model yang di‑hosting secara lokal.
  • Mode evaluasi memiliki batasan. Tanpa lisensi server berjalan dalam mode evaluasi dengan pembatasan spesifik produk. Misalnya, server Comparison hanya membandingkan 2 halaman pertama dan menambahkan watermark pada hasil. Panggil get_license_status terlebih dahulu dan baca halaman lisensi produk Anda.
  • Parser dan Search hanya tersedia sebagai image Docker. GroupDocs.Parser.Mcp dan GroupDocs.Search.Mcp tidak memiliki paket NuGet, sehingga rute Docker di atas adalah satu‑satunya cara untuk produk‑produk tersebut. Pada host Linux, jalankan kontainer mereka dengan --user "$(id -u):$(id -g)" agar dapat menulis ke folder yang Anda mount.
  • Pengecualian platform. Dua operasi khusus PDF saat ini gagal di Linux, termasuk image Docker, karena penanganan gambar mesin PDF bergantung pada System.Drawing.Common, yang .NET dukung hanya di Windows: GroupDocs.Annotation.Mcp generate_pages_preview pada file PDF (dokumen Word dirender), dan GroupDocs.Redaction.Mcp redact_image_area serta erase_metadata pada file PDF (redact_text pada PDF, dan ketiganya pada dokumen Word, berfungsi). Jalankan itu di Windows dengan dnx; lihat posting produk.

FAQ

Apakah MCP aman untuk dokumen sensitif?
Dengan server GroupDocs MCP dokumen diproses dalam proses di mesin Anda melalui stdio, tanpa port yang mendengarkan dan tanpa telemetry. Yang perlu dinilai adalah model yang digunakan klien AI Anda, karena prompt dan fragmen yang dikutip dikirim ke sana.

Bisakah saya menjalankan alat Claude tanpa mengirim data ke cloud?
Dokumen tetap lokal dalam kedua kasus. Untuk menjaga prompt tetap lokal juga, gunakan klien yang mendukung model yang di‑hosting secara lokal, sehingga tidak ada bagian percakapan yang meninggalkan jaringan Anda.

Data apa yang dikirim server MCP?
Saat runtime server GroupDocs MCP tidak mengirim apa‑apa melalui jaringan ketika file lisensi digunakan. Dengan lisensi ber‑meter ia mengirim laporan penggunaan ke GroupDocs, tidak pernah konten dokumen.

Per produk: halaman on‑premise dalam dokumentasi

Setiap halaman mencakup arsitektur yang sama dengan perintah untuk produk tersebut. Ini adalah referensi kanonik untuk tinjauan keamanan.

Per produk: tempat memulai di blog

Setiap produk memiliki serangkaian posting — empat untuk kebanyakan, enam untuk Search. Posting pertama menjelaskan pola; yang lainnya menerapkannya.