NextPDF Connect
NextPDF Connect
In een oogopslag
Sectie met titel “In een oogopslag”NextPDF Connect is het pakket nextpdf/server. Het draait als langlevende service die de NextPDF PDF 2.0-engine beschikbaar stelt aan AI-agents en clients voor het Hypertext Transfer Protocol (HTTP). Hetzelfde toolregister is via drie transporten beschikbaar: Model Context Protocol (MCP) via standaardinvoer en -uitvoer, een Application Programming Interface (API) volgens Representational State Transfer (REST), beschreven in een OpenAPI 3.1-document, en gRPC, gedefinieerd door het Protocol Buffers-pakket nextpdf.connect.v1. Elke tool specificeert een risiconiveau. Tools in het hoogste niveau moeten vóór uitvoering een human-in-the-loop (HITL)-bevestigingscontrole doorlopen.
Gebruik dit gedeelte voor serverbeheer of integratie. Begin met het Overzicht om de architectuur te begrijpen en een transport te kiezen, en gebruik daarna de API-referentie voor de exacte tool- en servicesymbolen.
Sectieoverzicht
Sectie met titel “Sectieoverzicht”Deze pagina’s behandelen de concepten, configuratie en bediening van de server.
| Pagina | Gebruik hiervoor |
|---|---|
| Overzicht | De pakketgrens, de drie transporten en waarom het aantal tools een runtime-eigenschap is. |
| Snelstartgids | Een uitvoerbare eerste MCP-handshake en het bijbehorende REST-renderverzoek. |
| Configuratie | Het MCP-YAML-bestand, de omgevingsvariabelen NEXTPDF_* en de risico-override die alleen naar boven kan worden bijgesteld. |
| Opstart en detectie | Hoe elk transport verbinding maakt met de bijbehorende server en bij het opstarten tools en niveaus detecteert. |
| Toolcatalogus | De geverifieerde, altijd beschikbare set kerntools en hoe de runtime het totale aantal berekent. |
| HITL-risiconiveaus | Het risicomodel met vier niveaus en de bevestigingschallenge voor tools die goedkeuring vereisen. |
| Implementatie | RoadRunner-workerprofielen, Docker, op Redis gebaseerde opslag en wederzijdse Transport Layer Security (TLS) voor gRPC. |
| Beveiliging en bediening | Authenticatie, transportbeveiliging, het dreigingsmodel en het standpunt over gegevenslocatie. |
Elk transport heeft een eigen referentiepagina.
| Transportpagina | Gebruik hiervoor |
|---|---|
| MCP-transport | JavaScript Object Notation Remote Procedure Call (JSON-RPC) 2.0-framing via stdio en de methoden initialize / tools/list / tools/call. |
| REST-transport | De RoadRunner PSR-15-pijplijn, het OpenAPI 3.1-contract, bearer-authenticatie en routes met niveaucontrole. |
| gRPC-transport | De service nextpdf.connect.v1.NextPDFConnect, server-streaming-RPC’s en authenticatie via metadata. |
Belangrijkste API’s
Sectie met titel “Belangrijkste API’s”Gebruik deze twee pagina’s voor ontwikkeling tegen de server.
| Pagina | Rol |
|---|---|
| API-referentie | Elke geregistreerde tool, met naam en klasse, gRPC-service- en berichtsymbolen, het foutmodel en de rate limits. |
| Ontwikkelaarsgids | De architectuurgrens, de runtime-levenscyclus, de niveaubepaling, de bevestigingscontrole, de uitbreidingspunten en de testchecklist. |
Zie ook
Sectie met titel “Zie ook”- Overzicht — conceptueel startpunt voor het pakket
- API-referentie — exacte tool-, RPC- en berichtsymbolen
- Ontwikkelaarsgids — de server bouwen, uitbreiden en beheren
- Beveiliging en bediening — authenticatie en het dreigingsmodel