Mehrseitiges Dokument mit NextPDF Connect erstellen

Auf einen Blick

Erstellen Sie mit NextPDF Connect ein Dokument mit mehreren Seiten. add_page hängt eine Seite an, die entweder die Standardgeometrie des Dokuments übernimmt oder die Ausrichtung überschreibt. Nach jedem add_page wird der Cursor an den oberen linken Rand der neuen Seite zurückgesetzt. Sie verwenden vier Tools, alle aus Core: create_pdf, add_text, add_page und output_pdf.

Installation

composer require nextpdf/server

Binden Sie einen Transport an: MCP-stdio, REST oder gRPC. Es ist keine lizenzierte Stufe erforderlich.

Konzeptioneller Überblick

Ein Dokument wird als Seitenbaum modelliert. Jede Seite ist ein Knoten, der über diesen Baum erreicht wird (ISO 32000-2 §7.7.3). Eine Seite führt eigene Geometrieattribute, einschließlich der Media-Box, die den sichtbaren Bereich definiert (ISO 32000-2 §7.7.3.3). create_pdf erstellt die erste Seite automatisch, und add_page hängt danach jede weitere Seite an. Lassen Sie page_size/orientation weg, damit die Seite den Dokumentstandard übernimmt. Setzen Sie orientation: "landscape", um eine A4-Seite auf 297×210 mm zu drehen.

API-Oberfläche

Tool	Rolle	Risikostufe
`create_pdf`	Sitzung öffnen; erste Seite wird erstellt	Sicher
`add_text`	Text an der Cursorposition schreiben	Vorsicht
`add_page`	Eine Seite anhängen (erben oder überschreiben)	Vorsicht
`output_pdf`	Das PDF rendern und zurückgeben	Genehmigung erforderlich / Prüfung (base64)

Tool-Namen sind die Protokollnamen der Registry. Der Tool-Katalog ist der maßgebliche Katalog. Welche Tools Ihnen zur Verfügung stehen, hängt von der installierten Stufe ab.

Codebeispiel — Schnellstart

Ablauf in Prosa:

create_pdf (A4-Hochformat, Titel, Autor) → document_id.
add_text (Titel, große Schrift, zentriert), dann add_text (Einleitungsabsatz, Schrift für Fließtext).
add_page nur mit der document_id → übernimmt A4-Hochformat. Die neue page_number wird zurückgegeben, und der Cursor wird zurückgesetzt.
add_text für die Abschnittsüberschrift und den Fließtext auf Seite 2.
add_page mit orientation: "landscape" → eine A4-Seite im Querformat.
add_text für den breiten Inhalt.
output_pdf → base64.

Codebeispiel — Produktion

Validieren Sie jede Antwort. Nach add_page sollte der Inhalt oben auf der neuen Seite beginnen. Das Zurücksetzen des Cursors ist beabsichtigtes Verhalten und kein Fehler. Verfolgen Sie position.page aus den add_text-Antworten, um zu erkennen, wann Inhalt auf eine Folgeseite umgebrochen wurde. Rufen Sie output_pdf genau einmal auf und verwerfen Sie anschließend die document_id.

Randfälle & Stolpersteine

Zurücksetzen des Cursors. Nach add_page befindet sich der Cursor am oberen linken Rand der neuen Seite. Wer erwartet, dass er von der vorherigen Seite aus weiterläuft, begeht den häufigsten Fehler.
Erforderliche document_id. Jedes Tool außer create_pdf benötigt die document_id. Wenn Sie sie weglassen, ist das ein Fehler.
Ungültige Ausrichtung. Nur "portrait" und "landscape" sind gültig.
Bearbeitung nach der Ausgabe. Inhalt, der nach output_pdf mit destroy: true hinzugefügt wird, schlägt fehl, weil die Sitzung nicht mehr existiert.

Leistung

Ein mehrseitiges Textdokument bleibt innerhalb des Seitenbudgets; die Ausgabe ist nur einige KB groß. Das Profil ist structural: Das /ID des Trailers und die Zeitstempel sind nicht über Läufe hinweg stabil.

Sicherheitshinweise

Der base64-Modus hat keine Nebenwirkungen. Die Dateiausgabe ist abgesichert; siehe HITL-Abschnitt. Die document_id ist ein opakes Handle. Geben Sie sie nicht über mehrere gleichzeitige Anfragen hinweg weiter.

Konformität

Aussage	Spezifikation	Klausel	reference_id
Seiten werden über den Seitenbaum erreicht.	ISO 32000-2	§7.7.3
Ein Seitenobjekt definiert seine eigenen Geometrieattribute.	ISO 32000-2	§7.7.3.3

Kommerzieller Kontext

Nicht zutreffend — alle Tools gehören zu Core.

Transportverfügbarkeit

Transport	Verfügbar	Hinweise
MCP (stdio)	Ja	`tools/call` pro Tool.
REST	Ja	Eine Operation pro Tool.
gRPC	Ja	Unärer Aufruf pro Tool.

HITL-Risikostufe

create_pdf ist Sicher; add_text und add_page sind Vorsicht; output_pdf ist Genehmigung erforderlich und im base64-Modus auf Prüfung herabgestuft. Für die Dateiausgabe bleibt Genehmigung erforderlich. Siehe output-approval und HITL-Risikostufen.

JSON-Umschlag des Bestätigungsgates

Für die base64-Ausgabe gilt hier:

{ "allowed": true }

Die Challenge-Form wird in output-approval gezeigt.