---
author: OOMOL
author_url: https://oomol.com/ja/about/
datePublished: 2026-11-11
title: PDFCraft MCP で PDF を Markdown に変換する
description: AI エージェントを PDFCraft MCP に接続し、サンプル PDF を Markdown
  に変換。結果を確認して、要約や文書処理に再利用する手順を紹介します。
lang: ja
canonical_url: https://oomol.com/ja/blog/pdfcraft-mcp/
markdown_url: https://oomol.com/ja/blog/pdfcraft-mcp.md
---

![自然光の中で開いた本を読む人と、PDF の先へ読書を広げる見出し](/blog/pdfcraft-mcp/ja-cover.webp)

PDF のレポートは、AI エージェントの参考資料として活用できます。Markdown に変換すれば、内容を確認・編集できるファイルになり、要約や情報の抽出にも再利用できます。

[PDFCraft](https://pdfcraft.ai/ja-JP/) は、PDF と EPUB を処理するリモート MCP サービスを提供しています。このチュートリアルでは、小さな公開 PDF を使い、接続からダウンロードした Markdown の確認までを説明します。変換には PDFCraft のクレジットを消費します。

## エージェントに PDFCraft を接続する

[OOMOL Console](https://console.oomol.com/api-key) で API キーを作成し、[PDFCraft MCP 接続ガイド](https://pdfcraft.ai/ja-JP/docs/getting-started/mcp/)に沿ってエージェントにサーバーを追加します。PDFCraft には専用の MCP エンドポイントがあります。すでに OOMOL のアプリ接続を使っている場合も、別のサーバーとして追加してください。

始める前に、クライアントがガイドに記載されたトランスポート、プロトコルバージョン、Bearer 認証ヘッダーに対応しているか確認します。キーはクライアントの保護された設定に保存してください。また、クライアントにはファイルの内容を読み取り、アップロードする手段が必要です。ローカルのファイル名をリモートサーバーに伝えるだけでは、文書はアップロードされません。

エージェントに `get_capabilities` を呼び出し、利用できる変換形式を説明するよう依頼します。ツールが見つからない場合は、ファイルのアップロードや有料タスクの開始前に接続の問題を解決してください。

## 1 ページの PDF から試す

[PDFCraft のサンプル PDF](https://pdfcraft.ai/examples/api-quickstart.pdf) をダウンロードして開きます。結果の確認に使える `Paper to structured text.` という文が含まれています。これは手順を試すための小さな入力ファイルで、スキャンした書籍、表、数式の認識精度を測るものではありません。

クライアントの添付機能で PDF を渡すか、エージェントが読み取れる作業フォルダーに置き、次のように依頼します。

> PDFCraft を使って、添付したサンプル PDF を Markdown に変換する準備をしてください。対応するオプションと残高を確認し、変換費用を見積もって、処理を開始する前に見せてください。あとで同じタスクを確認できるように、タスク UUID を保存してください。

見積もりを確認し、準備ができたら処理を許可します。

> Markdown への変換を開始してください。完了するまで間隔を空けて進捗を確認し、完全な結果をこの作業フォルダーにダウンロードしてください。タスク UUID と保存先を教えてください。失敗した場合は、別のタスクを作成する前にエラーを見せてください。

サービスの処理は、タスクの作成、ファイルのアップロード、処理の開始、進捗確認、ダウンロードリンクの取得という流れです。ツールが見つかっただけでは、アップロードや変換の成功は確認できません。結果を保存して確認するまで、タスク UUID を残しておきましょう。

## 要約を頼む前に結果を確認する

ダウンロードした結果を開きます。圧縮ファイルの場合は展開し、Markdown と付属ファイルを確認してください。エージェントには次のように依頼できます。

> 変換した Markdown を開き、「Paper to structured text.」が含まれているか確認してください。該当箇所を示し、サンプル PDF と照合してください。欠けている文字があれば、補わずに報告してください。

この文が見つかれば、想定した入力が出力に反映されたことを簡単に確認できます。自分の文書では、見出し、段落の順序、表、数値、脚注を原文と比較してください。読みやすい要約でも、数値や数式などの転記ミスが隠れていることがあります。

変換結果を確認したら、保存したテキストを使って作業を依頼できます。

> この Markdown を 5 つの要点にまとめてください。各要点に根拠となる短い引用を添え、元の見出しがあれば示してください。元の Markdown は変更せずに残してください。

要約を書くのは、変換結果を読むエージェントです。PDFCraft は文書処理ツールを提供します。Markdown を保存しておけば、新しい質問のたびに同じ PDF を変換し直す必要はありません。

## 中断したタスクを引き継ぐ

処理中に会話やクライアントが停止した場合は、保存したタスク UUID を次のセッションに渡し、そのタスクを確認するよう依頼します。最初のセッションの進捗表示が見えなくなっただけで、別の変換を開始しないようにしましょう。

ダウンロードリンクが期限切れになった場合は、タスクのファイルが利用できる間に、同じタスクのリンクを再取得します。残高不足で完全な結果をダウンロードできない場合は、クレジットを追加して再度取得してください。状態や復旧方法は[タスクのライフサイクルと復旧ガイド](https://pdfcraft.ai/ja-JP/docs/api/lifecycle/)で確認できます。完了したファイルは期限が切れる前に保存しましょう。

## EPUB への変換と翻訳

PDFCraft は PDF から EPUB への変換と、PDF・EPUB の翻訳にも対応しています。電子書籍リーダーで読みたい本なら、EPUB 出力を指定します。翻訳では、`get_capabilities` で対応言語を調べ、翻訳先の言語と見積もりを確認してから処理するよう依頼してください。

テキストの確認や再利用には Markdown、読書には EPUB と、次の用途に合わせて形式を選びます。大きな文書を変換する前に、内容の特徴が分かる小さな文書で結果を確認してください。

## 仕事で使うアプリにテキストを活用する

Markdown を確認したら、要約を業務アプリに保存したり、プロジェクトに添付したりできます。[OOMOL エージェントのクイックスタート](/ja/docs/agents/)に沿って対象アプリを接続し、書き込みを頼む前に保存先を指定します。PDFCraft の変換サーバーと OOMOL のアプリ接続は、それぞれ設定が必要です。

ブラウザーで PDF を圧縮・結合・分割する場合は、[PDFCraft のオンライン PDF ツール](https://pdfcraft.ai/ja-JP/tools/)を開いてください。エージェントで変換する場合は、[PDFCraft MCP 接続ガイド](https://pdfcraft.ai/ja-JP/docs/getting-started/mcp/)から始められます。
