Ask your agent to write the report as Markdown, then to convert that file to PDF and DOCX. With the GroupDocs.Conversion.Mcp server, Claude, Cursor or GitHub Copilot do both steps in one conversation, locally, and the second step runs through a layout engine, not a browser:
將發佈摘要寫入 summary.md,然後將其轉換為 PDF 與 Word。
The step‑by‑step version with config and troubleshooting is in the documentation: 如何使用 MCP 伺服器將 Markdown 匯出為 PDF 或 Word.
為什麼 AI 產生的內容需要匯出步驟?
Agents 以 Markdown 原生撰寫。接收結果的人通常不想要 Markdown:客戶期待 PDF,同事期待可以編輯與評論的 Word 檔。為了彌補這個差距,過去必須使用無頭瀏覽器列印 HTML、LaTeX 工具鏈,或手動貼到文字處理器中。每一步都會增加需要維護的相依性或每週重複的手動步驟。
MCP 轉換伺服器消除了這些相依性。Agent 已經持有 Markdown,於是它將內容寫入檔案,並請引擎將該檔案轉換。
交付工作流程是什麼樣子?
依照以下步驟處理任何週期性文件,例如每週狀態報告、會議摘要或發佈說明。
-
將伺服器指向交付資料夾。 設定
GROUPDOCS_MCP_STORAGE_PATH為 Agent 能寫入並從中轉換的資料夾。可選地設定GROUPDOCS_MCP_OUTPUT_PATH,將完成的檔案與草稿分開保存。 -
提供給 Agent 原始素材。 貼上筆記,或告訴它要彙總哪些檔案。
-
以檔名要求 Markdown 檔案。
將本週的摘要寫入 status.md。
-
要求匯出。
將 status.md 轉換為 PDF,並同時轉換為 DOCX。
通常 Agent 會對每個目標各呼叫一次
convert,一次format: "pdf",再一次format: "docx"。 -
在資料夾中檢查輸出。 回覆會列出每個已保存的檔案名稱。
-
下週重新執行。 伺服器不會覆蓋先前的匯出,因此上週的檔案保持不變,新檔案會取得不同的名稱。
| 步驟 | Agent 決定的事 | 引擎執行的事 |
|---|---|---|
| 內容 | 摘要的文字與標題方式 | 無 |
| 檔名與格式 | status.md,然後是 PDF 與 DOCX |
無 |
| 排版 | 呼叫 convert 並設定 format |
版面排版表格、清單與程式碼區塊 |
| 結果 | 從回覆中讀取已保存的檔名 | 寫入原生 PDF 與原生 DOCX |
引擎做了什麼是瀏覽器列印做不到的?
Markdown 轉 PDF 在邊緣情況下相當困難:跨頁表格、巢狀清單、程式碼區塊、圖片與分頁。瀏覽器列印管線只能近似頁面布局。GroupDocs.Conversion 引擎會對其進行排版,且使用與企業文件工作流相同的渲染方式。一次來源即可同時產出兩種格式。DOCX 為原生、可編輯的 Word 文件,具備標題、清單與表格樣式,而非頁面的影像。
如何設定?
在 Claude Desktop、Claude Code、Cursor 或 VS Code(搭配 GitHub Copilot)中註冊一次伺服器;每個客戶端的設定檔列於 文件中心。以下範例為 Claude Desktop 的設定表單。
{
"mcpServers": {
"groupdocs-conversion": {
"type": "stdio",
"command": "dnx",
"args": ["GroupDocs.Conversion.Mcp", "--yes"],
"env": {
"GROUPDOCS_MCP_STORAGE_PATH": "/path/to/reports",
"GROUPDOCS_MCP_OUTPUT_PATH": "/path/to/reports/delivered"
}
}
}
}
dnx 需要 .NET 10 SDK。亦提供 Docker 映像:ghcr.io/groupdocs-conversion/conversion-net-mcp:latest。註冊完成後請重新啟動客戶端。
其他可用的提示語:
將 meeting-notes.md 轉換為 DOCX,讓團隊可以編輯。
同時將此 Markdown 報告匯出為 PDF 與 Word。
範例對話
以下為根據 convert 工具文件行為示範的簡化對話,非螢幕截圖。
You: Write the release summary to summary.md, then convert it to PDF.
Agent: [writes summary.md to the storage folder]
Agent: [calls convert with file.filePath = "summary.md", format = "pdf"]
Agent: Done. The PDF is saved as summary.pdf in your output folder.
如果交付必須在沒有聊天的情況下執行怎麼辦?
聊天會話並非每週五 17:00 必須執行的工作觸發點。相同的引擎可作為 .NET 函式庫使用,而 n8n 教學 展示了自動化工具呼叫伺服器取代人工輸入。當需要人工審核每份報告時使用聊天工作流程,當不需要任何人介入時則使用腳本化流程。
有哪些限制?
- 評估模式。 未取得授權時,轉換輸出會帶有評估水印,因此交付給客戶的報告必須先取得授權。單一伺服器程序同時最多只能開啟 15 份文件。可先執行
get_license_status(詢問「conversion server 的授權狀態是什麼?」)以確認授權狀態,再進行正式交付。 - 不會審核內容。 引擎只會排版它收到的內容。若 Agent 撰寫錯誤,PDF 也會呈現錯誤內容,因此在匯出前務必檢查 Markdown 的事實正確性。
- 先測試最難的版面。 在自動化每週執行前,先用最寬的表格與最長的程式碼區塊匯出一次真實報告,以驗證排版效果。
常見問題
Claude 能否自行將答案保存為 PDF?
可以。請它將答案寫入儲存資料夾中的 .md 檔,然後再轉換該檔案。這是一次提示內的兩次工具呼叫。
Markdown 轉 DOCX 會產生真正的 Word 文件嗎?
會。輸出的是原生、可編輯的 DOCX,而非頁面的圖片。
匯出 Markdown 為 PDF 是否需要無頭瀏覽器或 LaTeX?
不需要。轉換在本機透過 GroupDocs.Conversion 引擎執行,無需任何瀏覽器或 LaTeX。
深入了解
- 文件與標準操作方式:如何使用 MCP 伺服器將 Markdown 匯出為 PDF 或 Word
- 文件中心:GroupDocs.Conversion MCP Server
- 入門指南:為什麼你的 AI Agent 不應自行轉換文件
- 相關文章:將 PDF 轉為 LLM 可用的 Markdown 的 3 種方法(以及本機方案的優勢)
- 相關文章:一次提示處理整個資料夾:使用 Claude 與 MCP 進行批次轉換
- 公告:你的 AI Agent 現在可以本機轉換文件——推出 GroupDocs.Conversion MCP
- 本地部署與安全模型:AI 文件處理的 3 種架構,以及能將檔案保留在內部網路的方案
- 問題討論:GroupDocs Conversion 論壇
- 原始碼:GroupDocs.Conversion.Mcp on GitHub