An AI エージェントは、どのファイルを変換し、どの形式に変換するかを選択し、変換エンジンが実際の変換を行うべきです。GroupDocs.Conversion.Mcp サーバーを使用すると、Claude、Cursor、または GitHub Copilot がローカル（マシン上）でそのエンジンを呼び出すことができます。たった一文で実行できます。

Convert contract.docx to PDF

設定やトラブルシューティングを含むステップバイステップのバージョンはドキュメントにあります: How to convert documents with AI agents using MCP。本稿では、分割が重要な理由とエージェントが介入すべきでない場所について説明します。

エージェントが自分でファイルを変換すると何が起こるか？

PDF を Word に「変換」する言語モデルは、実際には何も変換しません。与えられたコンテンツを読み取り、ターゲット形式で新しいコンテンツを書き出すだけです。モデルが見ていないものは再現できません。たとえば正確なフォント、列の配置、テーブルの前の改ページ、Word テンプレートが依存するスタイル名などです。戻ってくるものは変換のように見えますが、実際は再入力です。

この投稿が扱う失敗モードはこれです。出力はエラーなく開くため、テーブルがずれたり見出しのスタイルが失われたりするまで誰もチェックしません。レンダリングの忠実度は決定論的なエンジンの仕事であり、生成の仕事ではありません。

エージェントが決めるべきこと、エンジンが行うべきことは？

判断と実行の境界で作業を分割します。

質問 エージェントが決定 エンジンが実行
対象となるファイルはどれか？ プロンプトとストレージフォルダーを読み取る 何もしない
目的の形式は？ 「編集可能にする」を DOCX に、「アーカイブする」を PDF にマッピング 何もしない
ファイルは変換可能か？ get_supported_formats を呼び出し、回答を読む 有効なターゲット形式を報告
ファイルのサイズは？ get_document_info を呼び出し、ページ数を読む タイプ、ページ数、プロパティを読む
実際の変換 convert を呼び出す GroupDocs.Conversion エンジンで出力をレンダリング
失敗時の対応 再試行、質問、またはスキップ 理由をテキストで返す

エージェントはドキュメントのバイト列に触れません。ファイル名と形式を渡し、エンジンがファイルを返します。

エージェントをローカルのエンジンに接続する方法

クライアントでサーバーを一度だけ登録します。Claude Desktop は claude_desktop_config.json、Claude Code は claude mcp add、VS Code + GitHub Copilot は mcp.json、Cursor は ~/.cursor/mcp.json を使用します。サーバーは Visual Studio 2022、Windsurf、Cline、Codex CLI、JetBrains Rider もサポートしています。Claude Desktop のエントリ例は次のとおりです。

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

dnx には .NET 10 SDK が必要です。Docker を好む場合は、自己完結型イメージ ghcr.io/groupdocs-conversion/conversion-net-mcp:latest を使用し、docker run --rm -i -v $(pwd)/documents:/data で実行します。クライアントは stdio 経由でサーバーと通信します：パスはエージェント → ローカルサーバー → ローカルファイルシステムです。登録後にクライアントを再起動してください。

各リクエストがトリガーするツールはどれか？

サーバーは 4 つのツールを公開しています。名前は文字通りで、何かが壊れたときにエージェントが検索します。

  • convert はドキュメントを別の形式に変換し、結果をストレージまたは出力フォルダーに保存します。file、format（例: pdf, docx, xlsx, pptx, html, png, jpg, csv, txt, rtf, md）およびオプションの password を受け取ります。
  • get_supported_formats は、指定されたソースファイルが変換可能なターゲット形式を列挙します。
  • get_document_info は変換せずにファイルタイプ、ページ数、基本プロパティを返します。
  • get_license_status はサーバーが評価モード、ライセンスファイルモード、または従量課金モードのどれで動作しているかを報告します。

エージェントは以下のようにチェーンしてオープンエンドのプロンプトを処理します。

この Visio ファイルをどの形式に変換できるか教えて。その後 PDF に変換してください。

まず whitepaper.pdf のページ数を確認し、次に DOCX に変換してください。

既存のファイルは上書きされません。同じファイルを二度目に変換すると、report (1).pdf のように別名が付けられます。

セッション例

以下はツール説明に基づいて作成した簡略化された例示セッションです。スクリーンショットではありません。

You:    contract-draft.pdf を DOCX に変換して編集できるようにしてください。
Agent:  [calls convert with file.filePath = "contract-draft.pdf", format = "docx"]
Agent:  完了しました。変換されたファイルは output フォルダーに contract-draft.docx として保存されました。

フルループについては、the n8n walkthrough がチャットではなくワークフローで同じエンジンを駆動する様子を示し、announcement がサーバー全体を概説しています。

制限事項は何か？

  • 評価モード。 ライセンスがない場合、サーバーは変換出力に評価用透かしを付加し、各サーバープロセスで開けるドキュメントを 15 件に制限します。サーバーを再起動すればカウントはリセットされます。エージェントに最初に「変換サーバーのライセンスステータスは？」と尋ね、get_license_status でドキュメントを処理せずに回答させてください。
  • OCR 非対応。 サーバーはテキスト層を持つドキュメントのみ変換します。画像のみの PDF（スキャン）は編集可能なテキストにはなりません。
  • 変換は行うが抽出はしない。 このサーバーは文書全体を変換します。フィールドレベルのデータ抽出が必要な場合は、Docker イメージとして提供される companion GroupDocs.Parser.Mcp サーバー（GitHub）の方が適しています。多くのパイプラインは両方を併用しています。

FAQ

Claude は docx を pdf に変換できるか？
はい、変換サーバーが接続されていれば可能です。Claude は convert を format: "pdf" で呼び出し、GroupDocs エンジンがローカルでファイルを生成します。

エージェントがファイルを変換するとき、ファイルはアップロードされるか？
このサーバーではアップロードされません。stdio 経由でローカルで実行され、ドキュメントはストレージフォルダーに残ります。ライセンスファイルもローカルディスクから読み取られます。

サーバーが変換できる形式は何か？
100 以上の文書、スプレッドシート、プレゼンテーション、画像、メール、CAD、Web 形式に対応しており、GroupDocs.Conversion .NET ライブラリと同一です。特定ファイルの正確なリストは get_supported_formats で取得してください。

より深く掘り下げる