NextPDF Connect
NextPDF Connect
한눈에 보기
섹션 제목: “한눈에 보기”NextPDF Connect는 nextpdf/server 패키지로, NextPDF의 PDF 2.0 엔진을 인공지능(AI) 에이전트와 HTTP(Hypertext Transfer Protocol) 클라이언트에 노출하는 장기 실행 서비스입니다. 동일한 도구 레지스트리는 세 가지 방식으로 제공됩니다. 표준 입력 및 출력을 통한 MCP(Model Context Protocol), OpenAPI 3.1 문서로 기술된 REST(Representational State Transfer) API(Application Programming Interface), 그리고 nextpdf.connect.v1 Protocol Buffers 패키지로 정의된 gRPC입니다. 모든 도구는 위험 수준을 선언합니다. 위험 수준이 가장 높은 도구는 실행되기 전에 휴먼 인 더 루프(HITL) 확인 게이트를 통과합니다.
서버를 운영하거나 통합할 때는 이 섹션을 참고하십시오. 먼저 아키텍처를 파악하려면 개요를 읽고, 그다음 전송 방식을 선택한 후, 정확한 도구와 서비스 심볼을 확인하려면 API 참조를 읽으십시오.
섹션 맵
섹션 제목: “섹션 맵”이 페이지들은 서버의 개념, 구성, 운영을 다룹니다.
| 페이지 | 용도 |
|---|---|
| 개요 | 패키지 경계, 세 가지 전송 방식, 도구 개수가 런타임 속성인 이유를 설명합니다. |
| 빠른 시작 | 실행 가능한 첫 MCP 핸드셰이크와 그에 상응하는 REST 렌더링 요청을 안내합니다. |
| 구성 | MCP YAML 파일, NEXTPDF_* 환경 변수, 그리고 상향 조정만 허용되는 위험 재정의를 설명합니다. |
| 부팅 및 디스커버리 | 각 전송 방식이 자체 서버를 연결하고, 부팅 시 도구와 등급을 검색하는 방법을 설명합니다. |
| 도구 카탈로그 | 검증되어 항상 사용할 수 있는 핵심 도구 집합과 런타임에 총 개수가 계산되는 방식을 설명합니다. |
| HITL 위험 등급 | 4 단계 위험 모델과 승인이 필요한 도구의 확인 챌린지를 설명합니다. |
| 배포 | RoadRunner 워커 프로파일, Docker, Redis 기반 저장소, 그리고 gRPC 상호 TLS(Transport Layer Security)를 다룹니다. |
| 보안 및 운영 | 인증 모델, 전송 보안, 위협 모델, 그리고 데이터 레지던시 정책을 다룹니다. |
세 가지 전송 방식에는 각각 전용 참조 페이지가 있습니다.
| 전송 페이지 | 용도 |
|---|---|
| MCP 전송 | stdio를 통한 JSON-RPC(JavaScript Object Notation Remote Procedure Call) 2.0 프레이밍과 initialize / tools/list / tools/call 메서드를 설명합니다. |
| REST 전송 | RoadRunner PSR-15 파이프라인, OpenAPI 3.1 계약, bearer 인증, 그리고 등급별로 게이트되는 라우트를 설명합니다. |
| gRPC 전송 | nextpdf.connect.v1.NextPDFConnect 서비스, 서버 스트리밍 RPC, 그리고 메타데이터 인증을 설명합니다. |
기본 API
섹션 제목: “기본 API”이 두 페이지는 서버 대상 개발을 위한 개발자 진입점입니다.
| 페이지 | 역할 |
|---|---|
| API 참조 | 이름과 클래스별로 등록된 모든 도구, gRPC 서비스 및 메시지 심볼, 오류 모델, 그리고 속도 제한을 정리합니다. |
| 개발자 가이드 | 아키텍처 경계, 런타임 수명 주기, 등급 해석, 확인 게이트, 확장 지점, 그리고 테스트 체크리스트를 다룹니다. |