NextPDF Connect
NextPDF Connect
Auf einen Blick
Abschnitt betitelt „Auf einen Blick“NextPDF Connect ist das nextpdf/server-Paket: ein langlebiger Dienst, der die NextPDF PDF 2.0-Engine für KI-Agenten und Hypertext Transfer Protocol (HTTP)-Clients bereitstellt. Dieselbe Tool-Registry wird auf drei Wegen bereitgestellt — das Model Context Protocol (MCP) über Standardeingabe und -ausgabe, eine durch ein OpenAPI 3.1-Dokument beschriebene Representational State Transfer (REST) Application Programming Interface (API) und gRPC, definiert durch das nextpdf.connect.v1 Protocol Buffers-Paket. Für jedes Tool ist eine Risikostufe deklariert. Tools der höchsten Stufe durchlaufen vor der Ausführung ein Bestätigungs-Gate mit menschlicher Freigabe (human-in-the-loop, HITL).
Verwenden Sie diesen Abschnitt, wenn Sie den Server betreiben oder integrieren. Lesen Sie zuerst die Übersicht zur Architektur, wählen Sie dann einen Transport aus und lesen Sie anschließend die API-Referenz für die genauen Tool- und Service-Symbole.
Abschnittsübersicht
Abschnitt betitelt „Abschnittsübersicht“Diese Seiten behandeln die Konzepte, die Konfiguration und den Betrieb des Servers.
| Seite | Verwendung |
|---|---|
| Übersicht | Die Paketgrenze, die drei Transporte und warum die Anzahl der Tools eine Laufzeiteigenschaft ist. |
| Schnellstart | Ein lauffähiger erster MCP-Handshake und die entsprechende REST-Render-Anfrage. |
| Konfiguration | Die MCP-YAML-Datei, die NEXTPDF_*-Umgebungsvariablen und das nur nach oben wirkende Risiko-Override. |
| Boot und Discovery | Wie jeder Transport seinen Server verdrahtet und beim Booten Tools und Stufen erkennt. |
| Tool-Katalog | Das verifizierte, stets verfügbare Kern-Toolset und wie die Gesamtzahl zur Laufzeit berechnet wird. |
| HITL-Risikostufen | Das vierstufige Risikomodell und die Bestätigungs-Challenge für Tools, die eine Freigabe erfordern. |
| Deployment | RoadRunner-Worker-Profile, Docker, Redis-gestützte Stores und gRPC mit gegenseitiger Transport Layer Security (TLS). |
| Sicherheit und Betrieb | Das Authentifizierungsmodell, die Transportsicherheit, das Bedrohungsmodell und die Position zur Datenresidenz. |
Die drei Transporte haben jeweils eine eigene Referenzseite.
| Transportseite | Verwendung |
|---|---|
| MCP-Transport | JavaScript Object Notation Remote Procedure Call (JSON-RPC) 2.0-Framing über stdio sowie die Methoden initialize / tools/list / tools/call. |
| REST-Transport | Die RoadRunner-PSR-15-Pipeline, der OpenAPI 3.1-Vertrag, Bearer-Authentifizierung und stufengesteuerte Routen. |
| gRPC-Transport | Der nextpdf.connect.v1.NextPDFConnect-Service, serverseitig streamende RPCs und Metadaten-Authentifizierung. |
Primäre APIs
Abschnitt betitelt „Primäre APIs“Diese beiden Seiten sind die Einstiegspunkte für Entwickler, die gegen die Server-APIs entwickeln.
| Seite | Rolle |
|---|---|
| API-Referenz | Jedes registrierte Tool mit Name und Klasse, die gRPC-Service- und Message-Symbole, das Fehlermodell und die Rate-Limits. |
| Entwicklerhandbuch | Die Architekturgrenze, der Laufzeit-Lebenszyklus, die Ermittlung der Stufen, das Bestätigungs-Gate, die Erweiterungspunkte und die Test-Checkliste. |
Siehe auch
Abschnitt betitelt „Siehe auch“- Übersicht — der konzeptionelle Einstiegspunkt für das Paket
- API-Referenz — die genauen Tool-, RPC- und Message-Symbole
- Entwicklerhandbuch — wie Sie den Server entwickeln, erweitern und betreiben
- Sicherheit und Betrieb — Authentifizierung und das Bedrohungsmodell