Connect クックブック
NextPDF Connect は、Model Context Protocol、REST API、および gRPC サービスを通じて、NextPDF エンジンをリモートの呼び出し元や AI システムから利用できるようにします。Connect クックブックはそのサーフェス向けのタスクレシピを集めたもので、このページはそのインデックスです。各レシピのスラッグと、すべてのレシピを読む際のティアおよびトランスポート境界を記録します。これはインデックスであるため、いずれのレシピについても動作に関する主張は行いません。各レシピページは nextpdf/server リポジトリの docs/public/ 配下で執筆され、自身の主張を保持し、ソースの出所を保ったままアグリゲーターによってこのサイトに取り込まれます。
すべての Connect レシピが従う契約を確認するには、レシピの規約をお読みください。エコシステム全体における統合の全体像については、統合クックブックをお読みください。
ティアが実行可能な内容に与える影響
「ティアが実行可能な内容に与える影響」という見出しのセクションConnect デプロイメントのツールセットは、あらかじめ固定されているのではなく、起動時に算出されます。サーバーのツールレジストリは、コアツールを無条件に登録します。次に class_exists() で Pro および Enterprise のプロバイダーを探索し、nextpdf/premium がサーバーと併せてインストールされている場合にのみ、それらのツールを登録します。したがって、Pro または Enterprise のツールに依存するレシピは、そのツールが解決済みのデプロイメントでのみ実行されます。オープンソースのみのインストールにはそのツールが存在せず、呼び出しは静かに劣化するのではなく、未知ツールエラーを返します。各レシピは自身のティアを明記しており、このインデックスではレシピをティアごとにグループ化しているため、特定のデプロイメントが何をサポートするかを一目で把握できます。
ツールの総数は、デプロイメントのランタイム特性です。いずれのレシピも、このインデックスのどの行も、固定の数を主張しません。正本となるカタログはサーバー自身のツールカタログであり、各レシピはそこへリンクします。
トランスポートとエラーモデル
「トランスポートとエラーモデル」という見出しのセクションすべてのレシピは、3 つのトランスポートのいずれでも同じ方法で呼び出せます。MCP の tools/call、REST ツールエンドポイント、または gRPC サービスのいずれであっても、それらは 1 つのツールエグゼキューターを共有するためです。HTTP 経由でリモートサービスに到達するレシピは、トランスポートの失敗と成功でない HTTP ステータスを 2 つの別個のケースとして扱います。PSR-18 クライアントは、リクエストをまったく送信できない場合にのみ、型付きクライアント例外を発生させます — PSR-18 §4。対照的に、4xx または 5xx レスポンスは、例外ではなく、呼び出し元が検査する通常の戻り値です — PSR-18 §4。
レシピのスラッグマップ
「レシピのスラッグマップ」という見出しのセクション各レシピは /cookbook/connect/<recipe>/ に存在します。この表は、スラッグ、レシピを読む際のティア、および 1 行のスコープを記録します。レシピページは nextpdf/server リポジトリの docs/public/ ツリーで執筆され、アグリゲーターを介してこのサイトに公開されます。
| レシピ | ティア | スコープ |
|---|---|---|
hello-world | Core | 初めての Connect 呼び出し：作成、コンテンツ追加、出力 |
multi-page | Core | Connect 経由のマルチページドキュメント |
image-embedding | Core | Connect 経由の画像埋め込み |
html-table | Core | Connect 経由の HTML テーブルのレンダリング |
font-typography | Core | Connect 経由のフォントとタイポグラフィ |
exception-aware | Core | 例外対応のツール呼び出し |
environment-diagnostics | Core | 環境診断ツール |
layout-inspection | Core | レンダリングせずにレイアウトを検査 |
worker-safe | Core | ワーカーセーフなバッチ利用 |
batch-pdf-generation-with-progress-tracking | Core | 非同期の進捗トラッキングで PDF をバッチ生成 |
rest-invoice-end-to-end | Core | REST 経由で 1 通の請求書：送信、ポーリング、ダウンロード、ローカルで検証 |
output-approval | Core | ヒューマン・イン・ザ・ループの出力ゲート |
mcp-agent-session | Core | 承認のラウンドトリップを含む、キャプチャされた MCP エージェントセッション |
event-hooks | Core | ライフサイクルイベントフック |
fill-pdf-form | Pro | Connect 経由で PDF フォームに入力 |
extract-text-content | Pro | Connect 経由でテキストコンテンツを抽出 |
digital-signature | Pro | Connect 経由で PDF に署名（PAdES B-B および B-T） |
accessibility-check | Pro | PDF/UA アクセシビリティチェック |
pii-redaction | Enterprise | 検出された個人データをテキストレイヤーから削除（破壊的） |
aria-tagged-pdf | Pro | ARIA ランドマークロールをタグ付き構造にマッピング |
figure-caption | Pro | ネストされた Caption を持つアクセシブルな Figure |
aria-noteref-pattern | Pro | 脚注の参照と本文のパターン |
compliance-check | Enterprise | 名前付き標準のチェックを実行 |
forensic-analysis | Enterprise | 署名済み PDF のフォレンジック分析 |
ltv-health-check | Enterprise | LTV ヘルスチェック（B-LT/B-LTA、Enterprise 専用） |
batch-compliance | Enterprise | バッチ標準チェック |
ai-ready-certification | Enterprise | AI 対応チェック（認証ではありません） |
page-artifacts | Enterprise | ページネーションのクロムをアーティファクトとしてマーク |
conformance-mode | Enterprise | 適合モードの選択（適合を意図しており、判定はバリデーターが行う） |
cjk-vertical-writing | Enterprise | CJK 縦書きメトリクス |
opentelemetry | Core | OpenTelemetry で Connect を観測 |
tagged-pdf-tutorial | Core | タグ付き PDF のチュートリアル（適合を意図しており、判定は veraPDF が行う） |
スラッグは、レシピの意図を末尾にスラッシュを 1 つだけ付けたケバブケースで表したものです。数値プレフィックス、バージョン番号、ファイル拡張子はありません。レシピのスラッグは公開後に変更されることはなく、移動されたスラッグはリダイレクトを伴います。
適合と認証の境界
「適合と認証の境界」という見出しのセクションいくつかのレシピは標準（PDF/UA-2、PDF/A-4、PAdES）に触れます。Connect クックブックでは、標準へのサポートはあくまでサポートとして扱い、決して適合や認証としては扱いません。エンジンは適合を意図した出力を生成し、適合は独立したバリデーター（例として veraPDF）が判定します。AI 対応レシピは対応チェックであり、認証ではありません。LTV レシピの長期検証用マテリアルは、Enterprise 専用の機能です。それがドキュメント内に存在することは、そのドキュメントが備える機能であり、署名の有効性が無期限であることを保証するものではありません。影響を受ける各レシピは、これらの境界を全面的に再記述します。このインデックスは、それらが存在することを示し、どこから導出されるかを指し示すだけであり、ここで再導出することはありません。