---
author: OOMOL
author_url: https://oomol.com/zh-tw/about/
datePublished: 2026-11-11
title: 透過 PDFCraft MCP 將 PDF 轉為 Markdown
description: 為 AI Agent 接入 PDFCraft MCP，用範例 PDF 完成 Markdown 轉換、檢查結果，再將文字用於摘要和文件處理。
lang: zh-TW
canonical_url: https://oomol.com/zh-tw/blog/pdfcraft-mcp/
markdown_url: https://oomol.com/zh-tw/blog/pdfcraft-mcp.md
---

![自然光下翻閱書籍的讀者，配文讓閱讀超越 PDF](/blog/pdfcraft-mcp/zh-tw-cover.webp)

PDF 報告可以成為 AI Agent 的參考資料。先將它轉成 Markdown，你就能檢查、編輯並重複使用其中的文字，再讓 Agent 整理摘要或擷取資訊。

[PDFCraft](https://pdfcraft.ai/zh-Hant/) 提供處理 PDF 和 EPUB 的遠端 MCP 服務。本文用一個小型公開 PDF，說明從接入到檢查下載結果的完整流程。轉換會消耗 PDFCraft credits。

## 為 Agent 接入 PDFCraft

在 [OOMOL Console](https://console.oomol.com/api-key) 建立 API key，再按照 [PDFCraft MCP 接入指南](https://pdfcraft.ai/zh-Hant/docs/getting-started/mcp/)新增伺服器。PDFCraft 使用獨立的 MCP 網址；如果已經接入 OOMOL Apps，需要另外新增這個伺服器。

開始前，確認用戶端是否支援接入指南列出的傳輸方式、協定版本和 Bearer 驗證標頭。將金鑰保存在用戶端的受保護設定中。用戶端還需要能夠讀取並上傳檔案內容：把本機檔名告訴遠端伺服器，並不會上傳文件。

讓 Agent 呼叫 `get_capabilities`，說明目前支援的轉換格式。如果它無法找到工具，先解決連線問題，再上傳檔案或啟動付費任務。

## 從一頁 PDF 開始

下載並開啟 [PDFCraft 範例 PDF](https://pdfcraft.ai/examples/api-quickstart.pdf)。檔案包含 `Paper to structured text.`，可以用這句話檢查轉換結果。這是用於練習的小型輸入檔案，不能用來評估掃描書籍、表格或公式的辨識品質。

透過用戶端的附件功能提供 PDF，或將它放在 Agent 能讀取的工作目錄中，然後提出請求：

> 使用 PDFCraft，準備將附件中的範例 PDF 轉成 Markdown。先檢查支援的選項和我的餘額，估算轉換費用，在開始處理前把估算結果給我看。保留任務 UUID，方便之後繼續查詢同一個任務。

查看費用估算，確認後再授權開始處理：

> 開始轉成 Markdown，間隔查詢進度直到完成，然後把完整結果下載到目前的工作目錄。告訴我任務 UUID 和檔案儲存位置。如果失敗，先顯示錯誤，不要直接建立另一個任務。

服務的處理流程是建立任務、上傳檔案、啟動處理、查詢進度，再取得下載連結。能找到工具，並不代表上傳或轉換已經成功。在儲存並檢查結果前，請保留任務 UUID。

## 先檢查結果，再產生摘要

開啟下載結果。如果是壓縮檔，先解壓縮，再檢查 Markdown 和附帶的資源檔案。可以讓 Agent 執行：

> 開啟轉換後的 Markdown，檢查是否包含「Paper to structured text.」。顯示對應段落，並與範例 PDF 對照。如果缺少文字，請指出，不要自行補齊。

找到這句話，只能初步確認輸出對應預期的輸入。處理自己的文件時，還應對照原文檢查標題、段落順序、表格、數字和註腳。摘要讀起來通順，也可能掩蓋數字或公式的辨識錯誤。

檢查轉換結果後，再讓 Agent 使用儲存的文字：

> 根據這份 Markdown 整理五點摘要。每一點附上一小段原文作為依據，有標題時註明來源標題。保留原始 Markdown，不要修改。

摘要由 Agent 根據轉換結果產生，PDFCraft 提供文件處理工具。儲存 Markdown 後，後續提問可以重複使用這份文字，無須每次重新轉換同一個 PDF。

## 中斷後繼續查詢原任務

如果處理過程中對話或用戶端中斷，把儲存的任務 UUID 交給新的對話，讓它查詢原任務。不要因為看不到原對話的進度，就重新啟動一次轉換。

下載連結過期時，只要任務檔案仍然可用，就可以為同一個任務重新取得連結。如果餘額不足導致無法完整下載，儲值後再請求結果。具體狀態與恢復方式見 PDFCraft 的[任務生命週期與恢復指南](https://pdfcraft.ai/zh-Hant/docs/api/lifecycle/)。請在檔案過期前儲存完成的結果。

## 轉成 EPUB 或翻譯文件

PDFCraft 還支援 PDF 轉 EPUB，以及 PDF 或 EPUB 翻譯。如果要把書放到電子閱讀器中閱讀，可以選擇 EPUB 輸出。需要翻譯時，讓 Agent 透過 `get_capabilities` 檢查支援的語言，確認目標語言，並在處理前估算費用。

按接下來的用途選擇格式：檢查和重複使用文字時選擇 Markdown，閱讀書籍時選擇 EPUB。處理大型文件前，先用一份有代表性的小文件檢查效果。

## 將文字用於工作應用程式

檢查 Markdown 後，你可能想把摘要儲存到工作應用程式，或附在某個專案中。透過 [OOMOL Agent 快速開始](/zh-tw/docs/agents/)接入對應應用程式，並在讓 Agent 寫入前明確指定儲存位置。PDFCraft 轉換伺服器與 OOMOL 已連接的 Apps 需要分別設定。

如果只想在瀏覽器中壓縮、合併或分割 PDF，可以開啟 [PDFCraft 線上 PDF 工具](https://pdfcraft.ai/zh-Hant/tools/)。需要由 Agent 執行轉換時，從 [PDFCraft MCP 接入指南](https://pdfcraft.ai/zh-Hant/docs/getting-started/mcp/)開始。
