To batch convert a folder with an AI agent, point the GroupDocs.Conversion.Mcp server at the folder and describe the job in one sentence. The agent works through the files, calls the conversion engine once per document, and reports what it produced, all locally in Claude, Cursor or GitHub Copilot. It is batch processing driven by a sentence:

Convert every DOCX in my documents folder to PDF, keep the originals

The step-by-step version with config and troubleshooting is in the documentation: How to batch-convert a folder of documents with an AI agent. This post walks through the same job as a short session, from the first prompt to handling failures.

どこから始めますか: ストレージフォルダーかプロンプトか？

ストレージフォルダーから始めます。バッチジョブはフォルダーのマッピングで成功または失敗が決まり、マッピングはサーバーエントリで一度だけ設定され、各プロンプトで設定する必要はありません。2つの環境変数がそれを制御します。

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

GROUPDOCS_MCP_STORAGE_PATH はエージェントが読み取れるフォルダーです。GROUPDOCS_MCP_OUTPUT_PATH は変換後のファイルが保存される場所です。両方が設定されていれば、元のフォルダーはそのままで、すべての結果は converted に入ります。これはバッチ処理に最もクリーンなレイアウトです。dnx コマンドは .NET 10 SDK が必要です。Docker イメージ ghcr.io/groupdocs-conversion/conversion-net-mcp:latest はフォルダーを /data としてマウントします。サーバーを登録したら Claude Desktop、Claude Code、VS Code、または Cursor を再起動してください。

最初のプロンプトは何をしますか？

まずエージェントにシンプルなケースを与えます。

このフォルダー内のすべてを DOCX から PDF に変換してください。

エージェントはフォルダーを列挙し、各ファイルに対して format: "pdf" を指定して convert ツールを呼び出します。各呼び出しはストレージからファイル名を取得し、保存されたファイル名を返します。2 回実行すると、2 回目は最初のファイルの隣に新しい名前のファイルが作成されます。

フィルターやルールはどう追加しますか？

プロンプトがオーケストレーション層です。フィルタリング、シーケンス、エラーポリシーは自然言語で記述します。

すべての PDF を Markdown に変換し、すでに変換済みのファイルはスキップしてください。

請求書を PDF/A に変換してアーカイブし、失敗したファイルをリストアップしてください。

すべてのプレゼンテーションの PNG プレビューを作成してください。

シーケンスが必要な場合、エージェントはまず get_document_info を呼び出すことができ、これにより変換せずにファイルタイプ、ページ数、基本プロパティが取得できます。

各 PDF のページ数を先に確認し、10 ページ以上のものだけを変換してください。

「10 ページ以上」という判断はエージェントが行い、実際の変換はエンジンが担当します。

1 つのファイルが失敗した場合はどうなりますか？

エンジンがファイルを変換できない場合（例: ソース形式が未対応、パスワードが間違っているなど）、そのファイルに対するレスポンステキストは操作と理由で始まります。存在しないファイル名が指定された場合、サーバーが見えるファイル一覧が返され、エージェントは自ら修正できます。保護されたファイルの場合、convert はオプションの password パラメータを受け付けます。

このため、失敗ポリシーはプロンプトに組み込む必要があります。「失敗したファイルをリストアップしてください」と指示すれば、実行後にレポートが得られ、失敗が見逃されません。レポートを確認し、失敗したものだけを再実行してください。

セッション例

以下は簡略化した例示的セッションです。ファイル名は架空で、返信はドキュメント化された動作に基づいて構築されています（スクリーンショットではありません）。

You:    請求書を PDF/A に変換してアーカイブし、失敗したファイルをリストアップしてください。
Agent:  [請求書ファイルを列挙]
Agent:  [各ファイルに対して 1 つずつ convert を呼び出し]
Agent:  11 ファイルを出力フォルダーに変換しました。
        失敗: invoice-0412.docx (パスワード保護、パスワード未指定)。

大量フォルダーの進捗はどう追跡しますか？

エージェントは通常、ファイルを 1 つずつ順に処理するため、実行時間はファイル数とサイズに比例して伸びます。進捗報告が欲しい場合は、プロンプトに「10 ファイルごとに教えて」や「最後に要約してください」と指示します。数百件のドキュメントでも問題なく処理でき、最終レポートで何が起きたかが分かります。まず小さなサブセットでコピーを作り、2〜3 件の出力を目視で確認してから、全フォルダーで実行してください。

バッチを無人で実行しなければならない場合は？

エージェントセッションは人が開始する必要があります。スケジュールされたパイプライン向けには、n8n のハウツー が同じサーバーを駆動するワークフローツールの例を示しています。また、エンジンは GroupDocs.Conversion .NET ライブラリを通じてもスクリプト化可能です。レポートを読み取りたいアドホックなバッチにはチャットを利用してください。

制限は何ですか？

  • 評価モードではバッチは最大 15 ドキュメントに制限されます。 ライセンスがない場合、1 つのサーバープロセスで同時に開けるドキュメントは最大 15 件で、出力には評価用の透かしが入ります。それ以降はサーバーが再起動されるまで呼び出しが失敗します。実際のバッチを開始する前に get_license_status でモードを確認するか、「変換サーバーのライセンスステータスは？」と尋ねてください。
  • 従量課金ライセンスは外部アクセスが必要です。 従量キーを使用すると使用状況が GroupDocs サーバーに報告されるため、ファイアウォールで保護されたマシンではライセンスファイルを使用すべきです。ドキュメントの内容は送信されません。
  • スキャンは画像のままです。 OCR はサーバーに組み込まれていないため、画像のみの PDF バッチではテキスト層は生成されません。

FAQ

AI でフォルダー内のすべての DOCX を PDF に変換するにはどうすればいいですか？
ストレージフォルダーを設定し、エージェントに「フォルダー内のすべての DOCX を PDF に変換してください」と 1 文で指示します。エージェントはローカルサーバーを介してファイルを 1 つずつ変換し、アップロードは行われません。

AI エージェントはフォルダー全体をローカルで処理できますか？
はい。エージェントと変換サーバーはどちらもローカルマシン上で動作し、ファイルは自分のフォルダーから読み書きされます。

ドキュメント変換パイプラインを自動化する最適な方法は？
レビューしたいアドホックバッチにはチャットを使用します。スケジュール実行が必要なパイプラインの場合は、n8n などのワークフローツールで同じサーバーを駆動するか、.NET ライブラリをスクリプト化してください。

さらに深掘り