A GroupDocs MCP 伺服器讓 Claude Desktop、Claude Code、Cursor、GitHub Copilot 以及其他 MCP 用戶端能 本機 與您的文件互動：用戶端在您自己的機器上以子行程方式啟動伺服器，檔案則在您指定的資料夾中讀寫。每個產品的內部部署頁面都有完整的架構與安全模型說明，例如 Running GroupDocs MCP servers on-premise: architecture and security model。本文比較三種常見的 AI 代理與文件連接方式，並說明哪些會離開機器、哪些不會。

哪些架構可以將 AI 代理連接到文件？

有三種。它們的差異在於安全審查員首先會問的問題：文件會去向何處？

雲端上傳 托管 API 本機 MCP 伺服器
運作方式 助理或外掛將檔案上傳至供應商服務 您的程式碼或代理呼叫供應商的 REST API 並傳送檔案 AI 用戶端在您的機器上啟動伺服器行程
文件去向 第三方雲端 第三方雲端或您自己的租戶 無處：從本機資料夾讀取並寫入
網路表面 向供應商的外部連線 向供應商的外部連線 僅 stdio；使用授權檔時無外部連線，使用計量授權時僅傳送使用報告（不含文件內容）
入站埠 不適用 不適用 無
隔離環境使用 不可行 通常不可，取決於供應商的部署選項 使用授權檔時可行
誰執行 供應商 供應商 您，作為 AI 用戶端的一部分

第三欄即為 GroupDocs MCP 伺服器所實作的方式。本文其餘部分說明其運作方式與限制。

本機 MCP 伺服器的資料流是什麼樣子？

AI 用戶端以子行程方式啟動伺服器，並透過 JSON‑RPC 使用標準輸入與輸出與之通訊。伺服器永不監聽網路埠，且在使用授權檔時也不會建立任何外部連線。

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

安全審查員可檢查以下四項聲明：

  • 傳輸方式： 以子行程的標準輸入與輸出。沒有防火牆需要設定，也沒有任何東西需要暴露。
  • 入站埠： 無。
  • 遙測： 無。文件引擎在同一行程內執行。
  • 網路使用： 僅在安裝時，從 nuget.org 取得套件或從 ghcr.io 拉取映像檔。執行時伺服器不會發出任何外部呼叫，唯一的授權例外在下方說明。

您可以自行驗證：執行任務並觀察是否有監聽 socket 或外部連線。

當代理處理文件時，什麼會離開機器？

文件本身不會離開機器。提示詞與被引用的片段會離開。

支援您 AI 用戶端的模型會看到整個對話。如果模型是雲端託管的，您的指令文字會傳送至模型提供者，代理回傳給您的任何內容也會一併傳送。兩個例子：

  • 在比較之後，代理回報付款條件從 30 天變為 45 天。這句話屬於對話內容，會傳送給提供者。
  • 在抽取之後，代理回報發票總額。檔案未移動，但該數值已傳送。

養成將提示詞寫得讓答案內容更少的習慣，例如詢問「哪些檔案的總額超過某個門檻」而不是直接要求所有總額。對於敏感語料，請將伺服器與本機託管的模型搭配使用，整個迴路（用戶端、模型、伺服器、檔案）即可完全留在您的網路內。

本機伺服器需要網際網路存取嗎？

處理本身不需要。這取決於授權模式：

  • 授權檔： 由本機行程從本機磁碟讀取。完全離線運作，是隔離網路的正確選擇。
  • 計量（按使用付費）： 伺服器會向 GroupDocs 回報 使用量，因此需要向外連線。回報不含文件內容，但連線本身必須被防火牆允許。

若同時設定了計量金鑰與授權檔，計量金鑰優先。請將金鑰放在環境變數中，而非寫入版本控制的設定檔。每個產品的授權頁面都有設定說明，get_license_status 工具會回報目前使用的模式。

如何在 Docker 中於防火牆內部執行伺服器？

對平台團隊而言，Docker 映像通常是較簡單的選擇：只需一個包含原生相依性的映像，主機上不需要 SDK，且邊界僅限於您掛載的資料夾。每個產品都有自己的映像，名稱為 ghcr.io/groupdocs-<product>/<product>-net-mcp。以下指令示範單一產品的使用方式，請自行替換佔位符。

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>
  • 固定標籤。 快速入門指令使用 :latest；在正式環境請固定為您測試過的版本，以免重新建置時改變行為。
  • 刻意掛載。 容器只能看到您提供的資料夾，這比以您身分執行的行程有更嚴格的邊界。
  • 以唯讀方式掛載授權檔。
  • 隔離環境段落： 事先拉取映像或快取 NuGet 套件，並固定版本。

您的 AI 用戶端會在其 MCP 設定中以 docker run 指令作為伺服器指令執行，因此容器即為上圖中的子行程。文件說明映像支援多平台（linux/amd64 與 linux/arm64）。

本機 MCP 伺服器適用於受規範管制的產業嗎？

它消除了隱私審查中最大的疑慮——將文件傳送給第三方處理者。法律、金融、醫療與公共部門且政策禁止上傳文件的團隊，可將其作為符合 HIPAA 或 GDPR 工作流程的建構模組。此處僅說明架構適用性，GroupDocs MCP 伺服器未取得任何法規認證，您的責任仍取決於所搭配的模型、授權模式與您自行的控制措施。

此模型的限制是什麼？

  • 一個伺服器服務一個用戶端行程。 stdio 伺服器由單一用戶端在單一機器上啟動，並非多使用者服務。若需共享服務，請在 GroupDocs 函式庫前自行建置服務，而非同時執行多個 MCP 伺服器。
  • 計量授權需要外部連線。 如前所述會傳送使用報告。若必須封閉網路，請改用授權檔。
  • 提示詞仍會傳送至模型提供者，除非您使用本機託管的模型。
  • 評估模式有其限制。 未持有授權時，伺服器以評估模式運行，並受產品特定限制。例如 Comparison 伺服器僅比較前兩頁且會加上浮水印。請先呼叫 get_license_status，並閱讀您產品的授權說明頁面。
  • Parser 與 Search 只以 Docker 映像提供。 GroupDocs.Parser.Mcp 與 GroupDocs.Search.Mcp 沒有 NuGet 套件，因此上述 Docker 方式是唯一途徑。於 Linux 主機上執行其容器時，請加上 --user "$(id -u):$(id -g)" 以便寫入您掛載的資料夾。
  • 平台例外。 目前有兩項 PDF 專屬操作在 Linux（包括 Docker 映像）上會失敗，原因是 PDF 引擎的影像處理依賴 System.Drawing.Common，而 .NET 只在 Windows 上支援：GroupDocs.Annotation.Mcp 的 generate_pages_preview 在 PDF 檔案上（Word 文件則可渲染），以及 GroupDocs.Redaction.Mcp 的 redact_image_area 與 erase_metadata 在 PDF 檔案上（redact_text 在 PDF 以及三者在 Word 文件上皆可運作）。請於 Windows 上使用 dnx 執行，相關說明請參考產品文章。

FAQ

MCP 對敏感文件安全嗎？
使用 GroupDocs MCP 伺服器時，文件於您的機器上以 stdio 方式在同一行程內處理，沒有監聽埠也沒有遙測。剩下需要評估的是您 AI 用戶端所使用的模型，因為提示詞與引用片段會傳送至該模型。

我可以在不將資料傳到雲端的情況下執行 Claude 工具嗎？
文件無論如何都會保留在本機。若也想讓提示詞保持本機，請使用支援本機託管模型的用戶端，這樣對話的任何部分都不會離開您的網路。

MCP 伺服器會傳送哪些資料？
在使用授權檔的情況下，GroupDocs MCP 伺服器在執行時不會透過網路傳送任何資料。使用計量授權時會向 GroupDocs 傳送使用報告，永不傳送文件內容。

每個產品：文件中的內部部署頁面

每個頁面都說明相同的架構與該產品的指令，這些是安全審查的正式參考。

每個產品：部落格的起點

每個產品都有一系列文章——大多為四篇，Search 為六篇。第一篇說明模式，其餘則套用該模式。