NextPDF Connect
NextPDF Connect
In breve
Sezione intitolata “In breve”NextPDF Connect è il pacchetto nextpdf/server: un servizio persistente che espone il motore PDF 2.0 di NextPDF ad agenti di intelligenza artificiale (IA) e a client Hypertext Transfer Protocol (HTTP). Lo stesso registro di strumenti viene esposto attraverso tre trasporti: Model Context Protocol (MCP) su standard input e output, un’Application Programming Interface (API) Representational State Transfer (REST) descritta da un documento OpenAPI 3.1 e gRPC definito dal pacchetto Protocol Buffers nextpdf.connect.v1. Ogni strumento dichiara un livello di rischio. Il livello più alto passa attraverso un gate di conferma human-in-the-loop (HITL) prima dell’esecuzione.
Usare questa sezione per gestire o integrare il server. Leggere prima la Panoramica per l’architettura, scegliere quindi un trasporto e consultare infine il Riferimento API per i simboli esatti di strumenti e servizi.
Mappa della sezione
Sezione intitolata “Mappa della sezione”Queste pagine coprono i concetti, la configurazione e le operazioni del server.
| Pagina | Utilizzo |
|---|---|
| Panoramica | Il perimetro del pacchetto, i tre trasporti e il motivo per cui il numero di strumenti è una proprietà di runtime. |
| Avvio rapido | Un primo handshake MCP eseguibile e la richiesta di rendering REST equivalente. |
| Configurazione | Il file YAML di MCP, le variabili di ambiente NEXTPDF_* e l’override del rischio ammesso solo in upgrade. |
| Avvio e individuazione | Come ciascun trasporto collega il proprio server e rileva strumenti e livelli all’avvio. |
| Catalogo degli strumenti | L’insieme verificato e sempre disponibile degli strumenti principali e il modo in cui il conteggio totale viene calcolato in fase di runtime. |
| Livelli di rischio HITL | Il modello di rischio a quattro livelli e il controllo di conferma per gli strumenti che richiedono approvazione. |
| Distribuzione | Profili di worker RoadRunner, Docker, archivi basati su Redis e Transport Layer Security (TLS) reciproco per gRPC. |
| Sicurezza e operazioni | Il modello di autenticazione, la sicurezza del trasporto, il modello delle minacce e l’impostazione di residenza dei dati. |
Ciascuno dei tre trasporti ha una pagina di riferimento dedicata.
| Pagina del trasporto | Utilizzo |
|---|---|
| Trasporto MCP | Il framing JavaScript Object Notation Remote Procedure Call (JSON-RPC) 2.0 su stdio e i metodi initialize / tools/list / tools/call. |
| Trasporto REST | La pipeline RoadRunner PSR-15, il contratto OpenAPI 3.1, l’autenticazione bearer e le route con gate per livello. |
| Trasporto gRPC | Il servizio nextpdf.connect.v1.NextPDFConnect, gli RPC server-streaming e l’autenticazione tramite metadati. |
API principali
Sezione intitolata “API principali”Queste due pagine sono i punti di ingresso per gli sviluppatori che creano applicazioni basate sul server.
| Pagina | Ruolo |
|---|---|
| Riferimento API | Ogni strumento registrato per nome e classe, i simboli dei servizi e dei messaggi gRPC, il modello degli errori e i limiti di frequenza. |
| Guida per sviluppatori | Il perimetro dell’architettura, il ciclo di vita di runtime, la risoluzione dei livelli, il gate di conferma, i punti di estensione e la checklist di test. |
Vedere anche
Sezione intitolata “Vedere anche”- Panoramica — il punto di ingresso concettuale per il pacchetto
- Riferimento API — simboli esatti di strumenti, RPC e messaggi
- Guida per sviluppatori — come creare, estendere e gestire il server
- Sicurezza e operazioni — autenticazione e modello delle minacce