NextPDF Connect

Bir bakışta

NextPDF Connect, nextpdf/server paketidir. NextPDF PDF 2.0 motorunu yapay zeka (AI) aracılarına ve Köprü Metni Aktarım Protokolü (HTTP) istemcilerine sunan, uzun ömürlü bir hizmet olarak çalışır. Aynı araç kayıt defteri üç aktarım üzerinden kullanılabilir: standart giriş ve çıkış üzerinden Model Context Protocol (MCP), bir OpenAPI 3.1 belgesiyle tanımlanan bir Temsili Durum Aktarımı (REST) Uygulama Programlama Arayüzü (API) ve nextpdf.connect.v1 Protocol Buffers paketiyle tanımlanan gRPC. Her araç bir risk düzeyi bildirir. En yüksek risk düzeyindeki araçlar, çalıştırılmadan önce insanın döngüde olduğu (HITL) bir onay kapısından geçmelidir.

Sunucuyu işletirken veya entegre ederken bu bölümü kullanın. Mimariyi anlamak için Genel bakış ile başlayın, bir aktarım seçin, ardından tüm araç ve hizmet sembolleri için API başvurusunu kullanın.

Bölüm haritası

Bu sayfalar sunucunun kavramlarını, yapılandırmasını ve işlemlerini kapsar.

Sayfa	Ne için kullanılır
Genel bakış	Paket sınırını, üç aktarımı ve araç sayısının neden bir çalışma zamanı özelliği olduğunu anlamak için.
Hızlı başlangıç	İlk çalıştırılabilir MCP el sıkışmasını ve buna karşılık gelen REST işleme isteğini denemek için.
Yapılandırma	MCP YAML dosyasını, NEXTPDF_* ortam değişkenlerini ve yalnızca yükseltmeye izin veren risk geçersiz kılmasını yapılandırmak için.
Önyükleme ve keşif	Her aktarımın sunucuya nasıl bağlandığını ve önyükleme sırasında araçları ve kademeleri nasıl keşfettiğini görmek için.
Araç kataloğu	Doğrulanmış ve her zaman kullanılabilir çekirdek araç kümesini ve çalışma zamanının toplam sayıyı nasıl hesapladığını görmek için.
HITL risk kademeleri	Dört düzeyli risk modelini ve onay gerektiren araçlar için onay sorgusunu anlamak için.
Dağıtım	RoadRunner çalışan profillerini, Docker’ı, Redis destekli depoları ve gRPC karşılıklı TLS’yi dağıtmak için.
Güvenlik ve işlemler	Kimlik doğrulamayı, aktarım güvenliğini, tehdit modelini ve veri yerleşikliği duruşunu incelemek için.

Her aktarım için ayrı bir başvuru sayfası vardır.

Aktarım sayfası	Ne için kullanılır
MCP aktarımı	stdio üzerinden JavaScript Nesne Gösterimi Uzaktan Yordam Çağrısı (JSON-RPC) 2.0 çerçevelemesini ve initialize / tools/list / tools/call yöntemlerini incelemek için.
REST aktarımı	RoadRunner PSR-15 işlem hattını, OpenAPI 3.1 sözleşmesini, taşıyıcı kimlik doğrulamayı ve kademe denetimli rotaları incelemek için.
gRPC aktarımı	Sunucu akışlı RPC’leri ve meta veri kimlik doğrulamasını sunan nextpdf.connect.v1.NextPDFConnect hizmetini incelemek için.

Birincil API’ler

Sunucu için geliştirme yaparken bu iki sayfayı kullanın.

Sayfa	Ne için kullanılır
API başvurusu	Kayıtlı her aracın adını ve sınıfını, gRPC hizmetini ve mesaj sembollerini, hata modelini ve hız sınırlarını görmek için.
Geliştirici kılavuzu	Mimari sınırı, çalışma zamanı yaşam döngüsünü, kademe çözümlemeyi, onay kapısını, genişletme noktalarını ve test denetim listesini anlamak için.

Ayrıca bakınız

• Genel bakış — paketin kavramsal başlangıç noktası
• API başvurusu — tüm araç, RPC ve mesaj sembolleri
• Geliştirici kılavuzu — sunucunun nasıl oluşturulacağı, genişletileceği ve işletileceği
• Güvenlik ve işlemler — kimlik doğrulama ve tehdit modeli