NextPDF Connect
NextPDF Connect
NextPDF Connect correspond au package nextpdf/server : un service durable qui expose le moteur PDF 2.0 de NextPDF aux agents d’intelligence artificielle (IA) et aux clients du protocole de transfert hypertexte (HTTP). Le même registre d’outils est exposé de trois façons : le Model Context Protocol (MCP) sur l’entrée et la sortie standard, une interface de programmation (API) de transfert d’état représentationnel (REST) décrite par un document OpenAPI 3.1, et gRPC, défini par le package Protocol Buffers nextpdf.connect.v1. Chaque outil déclare un niveau de risque. Le niveau le plus élevé passe par une porte de confirmation avec intervention humaine (HITL) avant son exécution.
Utilise cette section lorsque tu exploites ou intègres le serveur. Lis d’abord la Vue d’ensemble pour comprendre l’architecture, choisis ensuite un transport, puis consulte la référence d’API pour les symboles exacts des outils et des services.
Plan de la section
Section intitulée « Plan de la section »Ces pages couvrent les concepts, la configuration et l’exploitation du serveur.
| Page | À utiliser pour |
|---|---|
| Vue d’ensemble | Le périmètre du package, les trois transports et pourquoi le nombre d’outils est une propriété d’exécution. |
| Démarrage rapide | Une première négociation MCP exécutable et la requête de rendu REST équivalente. |
| Configuration | Le fichier YAML du MCP, les variables d’environnement NEXTPDF_* et le remplacement du niveau de risque réservé à l’élévation. |
| Amorçage et découverte | Comment chaque transport met en place son serveur et découvre les outils et les niveaux à l’amorçage. |
| Catalogue d’outils | L’ensemble vérifié d’outils de base toujours disponibles et comment le nombre total est calculé à l’exécution. |
| Niveaux de risque HITL | Le modèle de risque à quatre niveaux et le défi de confirmation pour les outils nécessitant une approbation. |
| Déploiement | Les profils de workers RoadRunner, Docker, les stores adossés à Redis et le Transport Layer Security (TLS) mutuel de gRPC. |
| Sécurité et exploitation | Le modèle d’authentification, la sécurité du transport, le modèle de menace et la posture de résidence des données. |
Chacun des trois transports dispose d’une page de référence dédiée.
| Page de transport | À utiliser pour |
|---|---|
| Transport MCP | Le framing JavaScript Object Notation Remote Procedure Call (JSON-RPC) 2.0 sur stdio et les méthodes initialize / tools/list / tools/call. |
| Transport REST | Le pipeline PSR-15 de RoadRunner, le contrat OpenAPI 3.1, l’authentification par jeton porteur et les routes contrôlées par niveau. |
| Transport gRPC | Le service nextpdf.connect.v1.NextPDFConnect, les RPC en streaming serveur et l’authentification par métadonnées. |
API principales
Section intitulée « API principales »Ces deux pages servent de points d’entrée aux développeurs qui construisent des intégrations avec le serveur.
| Page | Rôle |
|---|---|
| Référence d’API | Chaque outil enregistré par nom et par classe, les symboles du service et des messages gRPC, le modèle d’erreur et les limites de débit. |
| Guide du développeur | La frontière architecturale, le cycle de vie d’exécution, la résolution des niveaux, la porte de confirmation, les points d’extension et la liste de vérification des tests. |
Voir aussi
Section intitulée « Voir aussi »- Vue d’ensemble — le point d’entrée conceptuel du package
- Référence d’API — les symboles exacts des outils, des RPC et des messages
- Guide du développeur — comment construire, étendre et exploiter le serveur
- Sécurité et exploitation — l’authentification et le modèle de menace