A GroupDocs MCP server cho phép Claude Desktop, Claude Code, Cursor, GitHub Copilot và các khách hàng MCP khác làm việc với tài liệu của bạn cục bộ: khách hàng khởi chạy máy chủ như một tiến trình con trên máy của bạn, và các tệp được đọc và ghi trong các thư mục bạn chọn. Kiến trúc đầy đủ và mô hình bảo mật được tài liệu hoá trên trang on‑premise của mỗi sản phẩm, ví dụ Running GroupDocs MCP servers on-premise: architecture and security model. Bài viết này so sánh ba cách phổ biến để kết nối một tác nhân AI với tài liệu và giải thích những gì rời khỏi máy và những gì không.

Kiến trúc nào có thể kết nối một tác nhân AI với tài liệu?

Có ba cách. Chúng khác nhau ở câu hỏi mà người đánh giá bảo mật đặt đầu tiên: tài liệu sẽ đi đâu?

Tải lên đám mây API được lưu trữ Máy chủ MCP cục bộ
Cách hoạt động Trợ lý hoặc plugin tải tệp lên dịch vụ của nhà cung cấp Mã của bạn hoặc tác nhân gọi API REST của nhà cung cấp kèm tệp Khách hàng AI khởi chạy một tiến trình máy chủ trên máy của bạn
Nơi tài liệu được lưu Đám mây của bên thứ ba Đám mây của bên thứ ba hoặc tenant của bạn Không nơi nào: đọc và ghi vào các thư mục cục bộ
Bề mặt mạng Gửi ra bên ngoài tới nhà cung cấp Gửi ra bên ngoài tới nhà cung cấp chỉ stdio; không có gì khi có file giấy phép, chỉ báo cáo sử dụng (không có nội dung tài liệu) khi có giấy phép tính phí
Cổng vào Không áp dụng Không áp dụng Không
Sử dụng không kết nối Không khả thi Thường không; phụ thuộc vào tùy chọn triển khai của nhà cung cấp Có thể với file giấy phép
Ai chạy nó Nhà cung cấp Nhà cung cấp Bạn, như một phần của khách hàng AI

Cột thứ ba là những gì các máy chủ GroupDocs MCP thực thi. Phần còn lại của bài viết này sẽ đề cập đến cách chúng hoạt động và giới hạn của chúng.

Dòng dữ liệu của máy chủ MCP cục bộ trông như thế nào?

Khách hàng AI khởi chạy máy chủ như một tiến trình con và giao tiếp với nó qua đầu vào/đầu ra tiêu chuẩn bằng JSON‑RPC. Máy chủ không bao giờ lắng nghe trên cổng mạng, và khi có file giấy phép nó cũng không thực hiện kết nối ra bên ngoài.

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

Một nhà đánh giá bảo mật nhận được bốn tuyên bố có thể kiểm tra:

  • Transport: đầu vào và đầu ra tiêu chuẩn tới một tiến trình con. Không có gì để tường lửa và không có gì để phơi bày.
  • Cổng vào: không có.
  • Telemetry: không có. Động cơ tài liệu chạy trong cùng tiến trình.
  • Sử dụng mạng: chỉ vào thời điểm cài đặt, để tải gói từ nuget.org hoặc ảnh từ ghcr.io. Khi chạy, máy chủ không thực hiện cuộc gọi ra bên ngoài, ngoại trừ một ngoại lệ giấy phép được mô tả bên dưới.

Bạn có thể xác minh điều này thay vì tin tưởng: chạy một tác vụ và quan sát các socket đang lắng nghe và các kết nối ra bên ngoài.

Những gì rời khỏi máy khi một tác nhân xử lý tài liệu?

Tài liệu không rời khỏi máy. Các lời nhắc và đoạn trích dẫn có rời đi.

Mô hình phía sau khách hàng AI của bạn nhìn thấy toàn bộ cuộc trò chuyện. Nếu mô hình được lưu trữ trên đám mây, văn bản hướng dẫn của bạn sẽ đến nhà cung cấp mô hình, và bất kỳ đoạn nào mà tác nhân trích dẫn lại cho bạn cũng sẽ được gửi. Hai ví dụ:

  • Sau một lần so sánh, tác nhân báo cáo rằng điều khoản thanh toán đã thay đổi từ 30 ngày lên 45 ngày. Câu này là một phần của cuộc trò chuyện và được gửi tới nhà cung cấp.
  • Sau một lần trích xuất, tác nhân báo cáo tổng số tiền trên hoá đơn. Tệp không di chuyển, nhưng giá trị đó đã được gửi.

Một thói quen hữu ích là diễn đạt lời nhắc sao cho câu trả lời mang ít nội dung hơn, ví dụ hỏi “các tệp nào có tổng giá trị vượt qua ngưỡng” thay vì yêu cầu đưa ra toàn bộ tổng. Đối với các tập dữ liệu nhạy cảm, hãy ghép máy chủ với một mô hình được lưu trữ cục bộ. Khi đó toàn bộ vòng lặp (khách hàng, mô hình, máy chủ, tệp) sẽ ở trong mạng nội bộ của bạn.

Máy chủ cục bộ có cần truy cập internet không?

Không cần cho việc xử lý. Nó phụ thuộc vào chế độ giấy phép:

  • File giấy phép: được đọc từ đĩa cục bộ bởi tiến trình địa phương. Điều này hoạt động hoàn toàn offline và là lựa chọn phù hợp cho mạng không kết nối.
  • Tính phí (pay‑per‑use): máy chủ báo cáo sử dụng cho GroupDocs, vì vậy cần kết nối ra bên ngoài. Báo cáo không chứa nội dung tài liệu, nhưng kết nối này phải được tường lửa cho phép.

Nếu cả khóa tính phí và file giấy phép đều được cấu hình, khóa tính phí sẽ được ưu tiên. Giữ các khóa trong biến môi trường thay vì trong cấu hình đã commit. Trang giấy phép của mỗi sản phẩm mô tả cách thiết lập, và công cụ get_license_status sẽ báo cáo chế độ đang hoạt động.

Làm thế nào để chạy máy chủ bên trong biên giới với Docker?

Ảnh Docker thường là lựa chọn dễ dàng hơn cho đội nền tảng: một ảnh chứa các phụ thuộc gốc, không cần SDK trên host, và ranh giới chỉ giới hạn ở các thư mục bạn gắn. Mỗi sản phẩm có ảnh riêng, tên ghcr.io/groupdocs-<product>/<product>-net-mcp. Lệnh dưới đây cho thấy dạng chung cho một sản phẩm; hãy thay thế các placeholder.

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>
  • Ghim thẻ. Các lệnh khởi động nhanh sử dụng :latest; cho môi trường sản xuất, ghim thẻ tới phiên bản bạn đã kiểm thử để việc xây dựng lại không thay đổi hành vi trong quy trình đang chạy.
  • Gắn kết có chủ đích. Container chỉ thấy các thư mục bạn cung cấp, đây là ranh giới chặt chẽ hơn so với một tiến trình chạy dưới người dùng của bạn.
  • Gắn kết giấy phép chỉ đọc.
  • Phân đoạn không kết nối: kéo trước ảnh, hoặc lưu trước gói NuGet, và ghim phiên bản.

Khách hàng AI của bạn chạy lệnh docker run này như lệnh máy chủ trong cấu hình MCP, vì vậy container là tiến trình con trong sơ đồ ở trên. Tài liệu mô tả các ảnh là đa kiến trúc (linux/amd64 và linux/arm64).

Máy chủ MCP cục bộ có phù hợp cho các ngành được quy định không?

Nó loại bỏ câu hỏi lớn nhất trong một cuộc đánh giá quyền riêng tư, đó là việc chuyển tài liệu tới bên xử lý bên thứ ba. Các đội pháp lý, tài chính, y tế và khu vực công có chính sách cấm tải lên tài liệu có thể sử dụng nó như một khối xây dựng cho quy trình tuân thủ HIPAA hoặc GDPR. Điều này chỉ mô tả tính phù hợp về kiến trúc. Các máy chủ GroupDocs MCP không được chứng nhận cho bất kỳ quy định nào, và nghĩa vụ của bạn vẫn phụ thuộc vào mô hình bạn ghép, chế độ giấy phép và các kiểm soát nội bộ của bạn.

Những giới hạn của mô hình này là gì?

  • Một máy chủ phục vụ một tiến trình khách hàng. Một máy chủ stdio được khởi chạy bởi một khách hàng trên một máy. Nó không phải là dịch vụ đa người dùng. Đối với dịch vụ chia sẻ, hãy đặt dịch vụ của riêng bạn phía trước thư viện GroupDocs thay vì chạy nhiều máy chủ MCP.
  • Tính phí cần kết nối ra ngoài. Báo cáo sử dụng được gửi ra, như đã mô tả ở trên. Chọn file giấy phép nếu mạng phải được đóng.
  • Các lời nhắc vẫn tới nhà cung cấp mô hình trừ khi bạn sử dụng mô hình được lưu trữ cục bộ.
  • Chế độ đánh giá có giới hạn. Khi không có giấy phép, các máy chủ chạy ở chế độ đánh giá với các hạn chế riêng của sản phẩm. Ví dụ, máy chủ Comparison chỉ so sánh 2 trang đầu và đặt watermark lên kết quả. Hãy gọi get_license_status trước và đọc trang giấy phép của sản phẩm.
  • Parser và Search chỉ có ảnh Docker. GroupDocs.Parser.Mcp và GroupDocs.Search.Mcp không có gói NuGet, vì vậy cách Docker ở trên là duy nhất cho các sản phẩm này. Trên host Linux, chạy container của chúng với --user "$(id -u):$(id -g)" để chúng có thể ghi vào các thư mục bạn gắn.
  • Ngoại lệ nền tảng. Hai thao tác đặc thù PDF hiện đang thất bại trên Linux, kể cả ảnh Docker, vì việc xử lý ảnh của engine PDF phụ thuộc vào System.Drawing.Common, mà .NET chỉ hỗ trợ trên Windows: GroupDocs.Annotation.Mcp generate_pages_preview trên file PDF (các file Word vẫn render), và GroupDocs.Redaction.Mcp redact_image_area và erase_metadata trên file PDF (redact_text trên PDF, và cả ba trên file Word, đều hoạt động). Hãy chạy chúng trên Windows với dnx; xem các bài viết sản phẩm.

Câu hỏi thường gặp

MCP có an toàn cho tài liệu nhạy cảm không?
Với một máy chủ GroupDocs MCP, tài liệu được xử lý trong‑process trên máy của bạn qua stdio, không có cổng lắng nghe và không có telemetry. Điều còn lại cần đánh giá là mô hình AI mà khách hàng của bạn sử dụng, vì các lời nhắc và đoạn trích dẫn sẽ tới đó.

Tôi có thể chạy công cụ Claude mà không gửi dữ liệu lên đám mây không?
Tài liệu vẫn ở cục bộ trong mọi trường hợp. Để giữ lời nhắc cũng ở cục bộ, hãy dùng khách hàng hỗ trợ mô hình được lưu trữ cục bộ, vì vậy không có phần nào của cuộc trò chuyện rời khỏi mạng của bạn.

Máy chủ MCP gửi dữ liệu gì?
Khi chạy với file giấy phép, máy chủ GroupDocs MCP không gửi gì qua mạng. Với giấy phép tính phí, nó gửi báo cáo sử dụng cho GroupDocs, không bao giờ gửi nội dung tài liệu.

Theo sản phẩm: các trang on‑premise trong tài liệu

Mỗi trang mô tả cùng một kiến trúc với các lệnh cho sản phẩm đó. Đây là các tham chiếu chuẩn cho một cuộc đánh giá bảo mật.

Theo sản phẩm: nơi bắt đầu trên blog

Mỗi sản phẩm có một loạt các bài viết — bốn cho hầu hết, sáu cho Search. Bài đầu tiên giải thích mẫu; các bài còn lại áp dụng nó.