NextPDF Connect

En resumen

NextPDF Connect es el paquete nextpdf/server: un servicio de larga vida que expone el motor PDF 2.0 de NextPDF a agentes de inteligencia artificial (IA) y clientes HTTP. El mismo registro de herramientas se ofrece mediante tres vías: Model Context Protocol (MCP) sobre entrada y salida estándar, una interfaz de programación de aplicaciones (API) de transferencia de estado representacional (REST) descrita por un documento OpenAPI 3.1, y gRPC definido por el paquete de Protocol Buffers nextpdf.connect.v1. Cada herramienta declara un nivel de riesgo. El nivel más alto pasa por una compuerta de confirmación con intervención humana (HITL) antes de ejecutarse.

Usar esta sección al operar o integrar el servidor. Leer primero la Descripción general para conocer la arquitectura, elegir después un transporte y, por último, consultar la Referencia de la API para identificar los símbolos exactos de las herramientas y los servicios.

Mapa de la sección

Estas páginas son la fuente canónica de los conceptos, la configuración y las operaciones del servidor.

Página	Uso
Descripción general	El límite del paquete, los tres transportes y por qué el número de herramientas es una propiedad en tiempo de ejecución.
Inicio rápido	Un primer protocolo de enlace de MCP ejecutable y la solicitud REST de renderizado equivalente.
Configuración	El archivo YAML de MCP, las variables de entorno NEXTPDF_* y la anulación de riesgo exclusivamente al alza.
Arranque y descubrimiento	Cómo cada transporte conecta su servidor y descubre las herramientas y los niveles durante el arranque.
Catálogo de herramientas	El conjunto verificado de herramientas básicas siempre disponibles y cómo se calcula el total en tiempo de ejecución.
Niveles de riesgo HITL	El modelo de riesgo de cuatro niveles y el desafío de confirmación para las herramientas que requieren aprobación.
Despliegue	Perfiles de worker de RoadRunner, Docker, almacenes respaldados por Redis y seguridad de la capa de transporte (TLS) mutua para gRPC.
Seguridad y operaciones	El modelo de autenticación, la seguridad del transporte, el modelo de amenazas y la postura de residencia de datos.

Cada uno de los tres transportes tiene una página de referencia dedicada.

Página del transporte	Uso
Transporte MCP	El formato de encuadre JSON-RPC 2.0 sobre stdio y los métodos initialize / tools/list / tools/call.
Transporte REST	La canalización PSR-15 de RoadRunner, el contrato OpenAPI 3.1, la autenticación bearer y las rutas gobernadas por nivel.
Transporte gRPC	El servicio nextpdf.connect.v1.NextPDFConnect, los RPC de streaming desde el servidor y la autenticación por metadatos.

API principales

Estas dos páginas son los puntos de entrada para desarrollar integraciones con el servidor.

Página	Rol
Referencia de la API	Cada herramienta registrada por nombre y clase, los símbolos del servicio y los mensajes de gRPC, el modelo de errores y los límites de frecuencia.
Guía del desarrollador	El límite de la arquitectura, el ciclo de vida en tiempo de ejecución, la resolución de niveles, la compuerta de confirmación, los puntos de extensión y la lista de comprobación de pruebas.

Consulta también

• Descripción general — el punto de entrada conceptual del paquete
• Referencia de la API — los símbolos exactos de las herramientas, los RPC y los mensajes
• Guía del desarrollador — cómo construir, extender y operar el servidor
• Seguridad y operaciones — la autenticación y el modelo de amenazas