すべてのリポジトリは、最終的に文書として必要になる構造化データを蓄積します:リリースの変更点、年間の貢献者、API インベントリ、未解決リスクの一覧などです。データはすでに JSON 形式です;不足しているのは、顧客や監査人、マネージャーが実際に開くような、整形された PDF または Word ファイルです。GroupDocs.Assembly.Mcp を Claude Code の隣でローカルに実行すると(claude mcp add と dnx GroupDocs.Assembly.Mcp --yes)、エージェントはリポジトリ内に保存された Word テンプレートにリポジトリ内の JSON ファイルからデータを埋め込み、PDF を生成します。テーブルを手作業で整形する必要はありません。

Generate the release notes PDF for 4.2.0 from data/release-4.2.0.json with templates/release-notes.docx, and a contribution certificate for every contributor in data/contributors-2026.json.

設定やトラブルシューティングを含むステップバイステップのバージョンは、ドキュメントにあります: リポジトリの JSON データから PDF または Word レポートを Claude Code で生成する方法.

コーディングエージェントに文書を書かせない理由

コーディングエージェントはデータ生成には非常に優れているが、文書生成はかなり苦手です。「PDF 形式のリリースノート」を求めると、まず Markdown ファイルを書き、次にそれを変換するスクリプトを書き、さらにスクリプトのフォントをデバッグします。次のリリースでもまた少し違うやり方でやります。出力は変換ライブラリのデフォルトに従ったものになり、会社が送る文書とはかけ離れた見た目になります。

テンプレートを使えば外観が固定され、バージョン管理下に置くことができます。templates/release-notes.docx はロゴ、見出しスタイル、テーブル、そしていくつかの <<…>> タグが入った普通の Word ファイルです。レイアウトを所有する人が Word で編集し、エージェントは決して触れません。JSON はリリースツールが生成するか、git log からエージェントが生成しますが、これはコーディングエージェントが得意とする部分です。

また、作業がレビュー可能になります。data/release-4.2.0.json を変更するプルリクエストは、リリースノートにどの変更が反映されるかを行単位で diff として示します。一方、生成された PDF を変更するプルリクエストは何も表示しません。データとレイアウトを別々のバージョン管理ファイルとして保持し、文書はそれらからレンダリングするものとみなす考え方は、ソースコードとビルド成果物を分離するのと同じ理屈で、文書にも当てはまります。

リポジトリの構成例

./  (the repository, registered as the storage folder)
  data/
    release-4.2.0.json       {"release":{...}, "changes":[...4 items]}
    contributors-2026.json   {"contributors":[...3 items]}
  templates/
    release-notes.docx       <<[release.Version]>>, <<foreach [c in
                             changes]>> table row, counts
    certificate.docx         <<[contributor.Name]>> ...
  out/                       GROUPDOCS_MCP_OUTPUT_PATH, in .gitignore
        |
        |  Claude Code -> GroupDocs.Assembly MCP server (local, stdio)
        v
  release-notes-4.2.0.pdf    pnair.pdf  tvarga.pdf  mrossi.pdf

呼び出し例

リポジトリのルートがサーバーのストレージフォルダーになるため、すべてのパスはそれに対して相対です。まずエージェントはテンプレートが期待するフィールドを確認し、JSON に不足がないかを教えてくれます。

-> get_template_fields {"template":{"filePath":
     "templates/release-notes.docx"}}
<- { "dataSourceNames": [ "release", "changes" ],
     "fields": [ "release.Product", "release.Version", "release.Date",
                 "changes[].Type", "changes[].Title",
                 "changes[].PullRequest", "changes[].Author" ] }

次に 1 回の呼び出しでレンダリングします。

-> assemble_document {"template":{"filePath":
     "templates/release-notes.docx"},
     "data":{"filePath":"data/release-4.2.0.json"},
     "format":"pdf","outputName":"release-notes-4.2.0.pdf"}
<- Assembled 'release-notes.docx' with 'release-4.2.0.json' (JSON
   object) as PDF
   Saved to: .../release-notes-4.2.0.pdf

テンプレートのテーブル行は変更ごとに 1 回ずつ繰り返され、最後の行で changes.Count() と changes.Select(c => c.Author).Distinct().Count() によって変更数とユニークな作者数をカウントします。これらの数値はレンダリング時点のデータから取得され、エージェントからではありません。

証明書はファンアウト方式です。contributors 配列の要素ごとに 1 つずつ PDF が生成され、貢献者のハンドル名でファイル名が付けられます。

-> assemble_per_record {"template":{"filePath":
     "templates/certificate.docx"},
     "data":{"filePath":"data/contributors-2026.json"},
     "recordsPath":"contributors","fileNameField":"Handle",
     "format":"pdf"}
<- Assembled 3 of 3 document(s) from 'certificate.docx' with
   'contributors-2026.json', one per record (each record as
   'contributor'), as PDF.
   Saved to:
   .../pnair.pdf
   .../tvarga.pdf
   .../mrossi.pdf

recordsPath は JSON ファイルがオブジェクトである場合に配列の場所をサーバーに指示します。実際のデータファイルはこの形が一般的です。

習慣化し、プロンプトにしない

エージェントは「いつツールを使うか」についてプロジェクトの指示に従います。CLAUDE.md や AGENTS.md に数行書くだけで、以下のような慣例になります。

Documents for people (release notes, reports, certificates) are generated
with the groupdocs-assembly MCP server from templates/*.docx and data/*.json.
Call get_template_fields first; never edit a template. Generated files land
in out/, which is in .gitignore. Dates in JSON as yyyy-MM-ddTHH:mm:ss.

出力は git 管理外に置きます。デフォルトではサーバーはストレージフォルダー(ここではリポジトリのルート)に書き込みますが、サーバー登録時に GROUPDOCS_MCP_OUTPUT_PATH をリポジトリの out/ フォルダーに設定し、.gitignore にそのフォルダーを追加します。JSON とテンプレートがソースで、PDF は数秒で再生成できるビルド成果物です。PDF をコミットしてもレビューできない差分しか生まれません。

正直な制限事項

  • Evaluation mode: すべての PDF は “Evaluation Only. Created with GroupDocs.Assembly 26.7…” という文言で始まります。試用には問題ありませんが、チーム外に出す前にサーバーにライセンスを適用してください。
  • テンプレートは信頼できる入力。画像や文書のタグは式が返すパスや URL を読み込むため、プルリクエストからのテンプレートはコードと同様に扱い、サーバーには 1 つのストレージフォルダーだけを与えてください。
  • 日付: 2026-11-03T00:00:00 のように記述し、テンプレート側で <<[release.Date]:"d MMMM yyyy">> とフォーマットします。UTC+2 のマシンでテストした際に日付文字列が 1 日ずれるバグがありましたが、Docker イメージは UTC で動作します。
  • レコード単位生成 は JSON のみを読み取り、maxDocuments(デフォルト 100)が予期せぬ大配列を事前に遮断します。
  • get_template_fields は静的です。Select や GroupBy の投影内で計算された値は追跡されません。

FAQ

Claude Code はリポジトリ内の JSON から PDF を生成でき、クラウドサービスは不要ですか?
はい。MCP サーバーは Claude Code の子プロセスとしてローカルで動作し、テンプレートと JSON を指定したフォルダーから読み取ります。

CI で実行できますか?
サーバーは MCP サーバーなので MCP クライアントが必要です。ヘッドレスモードの Claude Code か任意のエージェントランナーを使用します。パイプライン向けの Docker イメージ(ghcr.io/groupdocs-assembly/assembly-net-mcp)が便利です。Linux ランナーでは --user "$(id -u):$(id -g)" を付与してください。イメージは非 root ユーザーで動作し、チェックアウトディレクトリへの書き込みが必要です。

Word か PDF、どちらが良いですか?
どちらでも構いません。format を省略すればテンプレートと同じ DOCX が出力され、"format":"pdf" と指定すれば PDF が生成されます。get_supported_formats はテンプレートごとのすべての対象形式を列挙します。

さらに掘り下げる