Một AI agent nên chọn tệp nào để chuyển đổi và định dạng nào để chuyển đổi sang, trong khi một engine chuyển đổi sẽ thực hiện việc chuyển đổi. Với máy chủ GroupDocs.Conversion.Mcp, Claude, Cursor hoặc GitHub Copilot có thể gọi engine này cục bộ, trên máy của bạn, chỉ bằng một câu:

Convert contract.docx to PDF

Phiên bản từng bước với cấu hình và khắc phục sự cố có trong tài liệu: Cách chuyển đổi tài liệu bằng AI agents sử dụng MCP. Bài viết này giải thích tại sao việc chia tách quan trọng và nơi mà agent nên nhường chỗ cho engine.

Điều gì xảy ra sai khi một agent tự chuyển đổi tệp?

Một mô hình ngôn ngữ “chuyển đổi” PDF sang Word thực chất không thực hiện chuyển đổi nào. Nó chỉ đọc nội dung đã cho và ghi lại nội dung mới ở định dạng đích. Bất kỳ thứ gì mà mô hình không nhìn thấy, nó không thể tái tạo: phông chữ chính xác, cấu trúc cột, ngắt trang trước bảng, tên kiểu mà một mẫu Word phụ thuộc vào. Những gì trả về trông giống như một chuyển đổi nhưng thực chất là việc gõ lại.

Đó là chế độ thất bại mà bài viết này đề cập. Nó yên lặng: đầu ra mở mà không có lỗi, vì vậy không ai kiểm tra cho đến khi một bảng bị dịch chuyển hoặc một tiêu đề mất kiểu. Độ trung thực khi hiển thị là công việc của engine quyết định, không phải công việc sinh ra nội dung.

Agent nên quyết định gì, còn engine thì làm gì?

Hãy chia công việc theo ranh giới giữa phán đoán và thực thi.

Câu hỏi Agent quyết định Engine thực hiện
Những tệp nào nằm trong phạm vi? Đọc prompt của bạn và thư mục lưu trữ Không làm gì
Định dạng đích là gì? Ánh xạ “make it editable” thành DOCX, “archive it” thành PDF Không làm gì
Tệp có thể chuyển đổi được không? Gọi get_supported_formats và đọc câu trả lời Báo cáo các định dạng đích hợp lệ
Kích thước tệp là bao nhiêu? Gọi get_document_info và đọc số trang Đọc loại, số trang, thuộc tính
Quá trình chuyển đổi Gọi convert Kết xuất đầu ra bằng engine GroupDocs.Conversion
Xử lý khi gặp lỗi Thử lại, hỏi bạn, hoặc bỏ qua tệp Trả về lý do dưới dạng văn bản

Agent không bao giờ chạm vào byte của tài liệu của bạn. Nó chỉ truyền tên tệp và định dạng, còn engine trả về một tệp.

Cách kết nối agent với engine cục bộ?

Đăng ký máy chủ một lần trong client của bạn. Claude Desktop sử dụng claude_desktop_config.json, Claude Code dùng claude mcp add, VS Code với GitHub Copilot dùng mcp.json, và Cursor dùng ~/.cursor/mcp.json. Máy chủ cũng hỗ trợ Visual Studio 2022, Windsurf, Cline, Codex CLI và JetBrains Rider. Một mục nhập Claude Desktop trông như sau:

{
  "mcpServers": {
    "groupdocs-conversion": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Conversion.Mcp", "--yes"],
      "env": { "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents" }
    }
  }
}

dnx yêu cầu .NET 10 SDK. Nếu bạn thích Docker, hình ảnh tự chứa là ghcr.io/groupdocs-conversion/conversion-net-mcp:latest, chạy bằng docker run --rm -i -v $(pwd)/documents:/data. Client giao tiếp với server qua stdio: đường dẫn là agent → server cục bộ → hệ thống tệp cục bộ. Khởi động lại client sau khi đăng ký.

Công cụ nào được kích hoạt cho mỗi yêu cầu?

Server cung cấp bốn công cụ. Tên của chúng là nguyên văn; agents sẽ tìm kiếm chúng khi có sự cố.

  • convert chuyển đổi tài liệu sang định dạng khác và lưu kết quả vào thư mục lưu trữ hoặc thư mục đầu ra của bạn. Nó nhận các tham số file, format (ví dụ pdf, docx, xlsx, pptx, html, png, jpg, csv, txt, rtf, md) và tùy chọn password.
  • get_supported_formats liệt kê các định dạng đích mà một tệp nguồn nhất định có thể chuyển sang.
  • get_document_info trả về loại tệp, số trang và các thuộc tính cơ bản mà không thực hiện chuyển đổi.
  • get_license_status báo cáo server đang chạy ở chế độ đánh giá, file license hoặc chế độ tính phí.

Các prompt mở rộng hoạt động vì agent xâu chuỗi chúng lại:

What formats can I turn this Visio file into? Then convert it to PDF.

Check the page count of whitepaper.pdf first, then convert it to DOCX.

Các tệp hiện có không bao giờ bị ghi đè. Lần chuyển đổi thứ hai của cùng một tệp sẽ nhận một tên riêng, chẳng hạn report (1).pdf.

Phiên bản mẫu

Đây là một phiên bản rút gọn, minh hoạ, được xây dựng dựa trên mô tả công cụ trong tài liệu, không phải ảnh chụp màn hình.

You:    Convert contract-draft.pdf to DOCX so I can edit it.
Agent:  [calls convert with file.filePath = "contract-draft.pdf", format = "docx"]
Agent:  Done. The converted file is saved as contract-draft.docx in your output folder.

Để xem toàn bộ quy trình, hướng dẫn n8n walkthrough trình bày cùng một engine được điều khiển bởi workflow thay vì chat, và thông báo giới thiệu chung về server.

Giới hạn là gì?

  • Chế độ đánh giá. Khi không có license, server sẽ thêm watermark đánh giá vào đầu ra đã chuyển đổi và giới hạn mỗi tiến trình server tối đa 15 tài liệu mở; khởi động lại server sẽ đặt lại số đếm. Hãy hỏi agent “what is the license status of the conversion server?” trước; get_license_status sẽ trả lời mà không cần xử lý tài liệu.
  • Không có OCR. Server chỉ chuyển đổi các tài liệu có lớp văn bản. Một bản scan lưu dưới dạng PDF chỉ chứa hình ảnh sẽ không xuất ra dưới dạng văn bản có thể chỉnh sửa.
  • Chuyển đổi, không trích xuất. Server này biến đổi toàn bộ tài liệu. Đối với việc trích xuất dữ liệu ở mức trường, server GroupDocs.Parser.Mcp (cung cấp dưới dạng Docker image) là lựa chọn phù hợp hơn, và nhiều pipeline thường dùng cả hai.

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

Claude có thể chuyển đổi docx sang pdf không?
Có, khi có server chuyển đổi được gắn kèm. Claude gọi convert với format: "pdf", và engine GroupDocs tạo ra tệp trên máy của bạn.

Các tệp của tôi có bị tải lên khi agent chuyển đổi không?
Không, với server này. Nó chạy cục bộ qua stdio, và các tài liệu vẫn ở trong thư mục lưu trữ của bạn. File license của bạn cũng được đọc từ ổ đĩa cục bộ.

Server có thể chuyển đổi những định dạng nào?
Hơn 100 định dạng tài liệu, bảng tính, trình chiếu, hình ảnh, email, CAD và web, cùng bộ như thư viện GroupDocs.Conversion .NET. Hãy hỏi get_supported_formats để nhận danh sách chính xác cho một tệp cụ thể.

Đi sâu hơn