A GroupDocs MCP server umožňuje Claude Desktop, Claude Code, Cursor, GitHub Copilot a dalším MCP klientům pracovat s vašimi dokumenty lokálně: klient spustí server jako podřízený proces na vašem počítači a soubory jsou čteny a zapisovány ve složkách, které si zvolíte. Úplná architektura a bezpečnostní model jsou zdokumentovány na stránkách každého produktu pro on‑premise, například Spuštění GroupDocs MCP serverů on‑premise: architektura a bezpečnostní model. Tento příspěvek porovnává tři běžné způsoby, jak připojit AI agenta k dokumentům, a vysvětluje, co opouští stroj a co ne.

Jaké architektury mohou připojit AI agenta k dokumentům?

Existují tři. Liší se otázkou, kterou si bezpečnostní auditor položí jako první: kam dokument putuje?

Nahrání do cloudu Hostovaná API Lokální MCP server
Jak to funguje Asistent nebo plugin nahrává soubor do služby poskytovatele Váš kód nebo agent volá REST API poskytovatele s souborem AI klient spustí serverový proces na vašem počítači
Kam dokument putuje Do cloudové služby třetí strany Do cloudové služby třetí strany nebo do vašeho tenantu Nikam: čte se a zapisuje do místních složek
Síťová plocha Odchozí spojení k poskytovateli Odchozí spojení k poskytovateli Pouze stdio; žádné s licenčním souborem, jen zprávy o využití (žádný obsah dokumentu) při licencování na základě spotřeby
Inbound porty Nepoužitelné Nepoužitelné Žádné
Použití v izolované síti Není možné Obvykle ne; závisí na možnostech nasazení poskytovatele Možné s licenčním souborem
Kdo to spouští Poskytovatel Poskytovatel Vy, jako součást AI klienta

Třetí sloupec představuje to, co implementují GroupDocs MCP servery. Zbytek tohoto příspěvku popisuje, jak to funguje a kde jsou jeho limity.

Jak vypadá tok dat lokálního MCP serveru?

AI klient spustí server jako podřízený proces a komunikuje s ním přes standardní vstup a výstup pomocí JSON‑RPC. Server nikdy neposlouchá na síťovém portu a při použití licenčního souboru také neprovádí žádná odchozí spojení.

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

Bezpečnostní auditor získá čtyři ověřitelné tvrzení:

  • Transport: standardní vstup a výstup do podřízeného procesu. Není co firewallovat ani co vystavovat.
  • Inbound porty: žádné.
  • Telemetry: žádná. Dokumentový engine běží v procesu.
  • Síťové využití: jen při instalaci, aby se stáhl balíček z nuget.org nebo obraz z ghcr.io. V běhu server neprovádí žádné odchozí volání, s jedinou výjimkou licencování popsanou níže.

Můžete si to ověřit místo důvěry: spusťte úlohu a sledujte naslouchající sockety a odchozí spojení.

Co opouští stroj, když agent zpracovává dokument?

Dokumenty neopouštějí stroj. Prompt a citované fragmenty ano.

Model za vaším AI klientem vidí celou konverzaci. Pokud je model hostován v cloudu, váš text instrukce dorazí k poskytovateli modelu a stejně tak vše, co vám agent vrátí. Dva příklady:

  • Po porovnání agent hlásí, že platební podmínka se změnila z 30 na 45 dnů. Tato věta je součástí konverzace a putuje k poskytovateli.
  • Po extrakci agent hlásí celkovou částku faktury. Soubor se nepřesunul, ale hodnota ano.

Užitečný zvyk je formulovat prompt tak, aby odpověď nesla méně obsahu, například se zeptat, které soubory mají celkovou částku nad určitý práh, místo aby se žádaly samotné částky. Pro citlivé korpusy spárujte server s lokálně hostovaným modelem. Pak celý cyklus (klient, model, server, soubory) zůstane uvnitř vaší sítě.

Potřebuje lokální server přístup k internetu?

Ne pro samotné zpracování. Záleží na režimu licence:

  • Licenční soubor: čte se z lokálního disku lokálním procesem. Funguje zcela offline a je vhodný pro izolované sítě.
  • Licencování na základě spotřeby (pay‑per‑use): server odesílá usage (využití) GroupDocs, takže potřebuje odchozí spojení. Zpráva neobsahuje obsah dokumentu, ale samotné spojení musí být povoleno vaším firewallem.

Pokud jsou nakonfigurovány jak licenční klíče na základě spotřeby, tak licenční soubor, mají přednost klíče na základě spotřeby. Uchovávejte klíče v proměnných prostředí místo v committed konfiguraci. Stránka s licencí každého produktu popisuje nastavení a nástroj get_license_status hlásí aktivní režim.

Jak spustit server uvnitř perimetru pomocí Dockeru?

Docker image je často jednodušší volbou pro platformní tým: jeden obraz s nativními závislostmi, žádný SDK na hostiteli a hranice omezena na složky, které připojíte. Každý produkt má svůj vlastní obraz, pojmenovaný ghcr.io/groupdocs-<product>/<product>-net-mcp. Níže uvedený příkaz ukazuje tvar pro jeden produkt; nahraďte zástupné symboly.

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 the tag. Rychlé startovací příkazy používají :latest; pro produkci připněte tag na verzi, kterou jste otestovali, aby přestavba nemohla změnit chování během běhu workflow.
  • Mount deliberately. Kontejner vidí jen složky, které mu dáte, což je přísnější hranice než proces běžící pod vaším uživatelem.
  • Mount the license read‑only.
  • Air‑gapped segments: předem stáhněte obraz, nebo předem načtěte NuGet balíček, a připněte verzi.

Váš AI klient spouští tento docker run příkaz jako serverový příkaz ve své MCP konfiguraci, takže kontejner je podřízeným procesem v diagramu výše. Dokumentace popisuje obrazy jako multi‑arch (linux/amd64 a linux/arm64).

Je lokální MCP server vhodný pro regulované odvětví?

Odstraňuje největší otázku v revizi soukromí, a to přenos dokumentů ke třetí straně. Týmy v právním, finančním, zdravotnickém a veřejném sektoru, jejichž politika zakazuje nahrávání dokumentů, jej mohou použít jako stavební blok pro workflow orientované na HIPAA nebo GDPR. Toto popisuje pouze architektonickou vhodnost. GroupDocs MCP servery nejsou certifikovány pro žádnou regulaci a vaše povinnosti stále závisí na modelu, se kterým je spárujete, na režimu licence a na vašich vlastních kontrolách.

Jaké jsou limity tohoto modelu?

  • Jeden server slouží jednomu klientskému procesu. Stdio server je spuštěn jedním klientem na jednom počítači. Není to víceuživatelská služba. Pro sdílenou službu umístěte vlastní službu před knihovnu GroupDocs místo spouštění mnoha MCP serverů.
  • Licencování na základě spotřeby vyžaduje odchozí spojení. Zprávy o využití odcházejí, jak bylo popsáno výše. Zvolte licenční soubor, pokud musí být síť uzavřena.
  • Prompt stále dosahuje poskytovatele modelu, pokud nepoužíváte lokálně hostovaný model.
  • Evaluační režim má omezení. Bez licence servery běží v evaluačním režimu s produktem‑specifickými omezeními. Například Comparison server porovnává jen první 2 strany a výsledek vodoznakuje. Nejprve zavolejte get_license_status a přečtěte si licenční stránku vašeho produktu.
  • Parser a Search jsou k dispozici jen jako Docker obrazy. GroupDocs.Parser.Mcp a GroupDocs.Search.Mcp nemají NuGet balíček, takže výše uvedená Docker cesta je jediná možnost pro tyto produkty. Na Linux hostiteli spusťte jejich kontejnery s --user "$(id -u):$(id -g)", aby mohly zapisovat do připojených složek.
  • Platformní výjimky. Dvě PDF‑specifické operace v současnosti selhávají na Linuxu, včetně Docker obrazu, protože zpracování obrázků PDF engine závisí na System.Drawing.Common, který .NET podporuje jen na Windows: GroupDocs.Annotation.Mcp generate_pages_preview na PDF souborech (Word dokumenty se renderují), a GroupDocs.Redaction.Mcp redact_image_area a erase_metadata na PDF souborech (redact_text na PDF a všechny tři na Word dokumentech fungují). Spusťte je na Windows s dnx; viz příspěvky produktu.

FAQ

Je MCP bezpečný pro citlivé dokumenty?
S GroupDocs MCP serverem jsou dokumenty zpracovávány v procesu na vašem počítači přes stdio, bez naslouchacích portů a bez telemetry. Co zůstává k posouzení, je model, který váš AI klient používá, protože prompt a citované fragmenty tam putují.

Mohu spustit Claude nástroje bez odesílání dat do cloudu?
Dokumenty zůstávají lokálně v každém případě. Pokud chcete, aby i prompty zůstaly lokální, použijte klienta, který podporuje lokálně hostovaný model, takže žádná část konverzace neopustí vaši síť.

Jaká data MCP server odesílá?
V běhu server neodesílá nic po síti, když je použit licenční soubor. Při licencování na základě spotřeby odesílá zprávy o využití GroupDocs, nikdy obsah dokumentu.

Per product: on‑premise stránky v dokumentaci

Každá stránka pokrývá stejnou architekturu s příkazy pro daný produkt. Jedná se o kanonické reference pro bezpečnostní revizi.

Per product: kde začít na blogu

Každý produkt má sérii příspěvků — čtyři pro většinu, šest pro Search. První vysvětluje vzor; ostatní jej aplikují.