PagieraDoküman
Entegrasyonlar

Entegrasyonlar

Uygulamanızı, veritabanınızı, veri kaynaklarınızı ve yapay zekâ araçlarınızı kendi altyapınızda bağlayın.

İhtiyacınız olan bağlantıyı seçin

Pagiera uygulamanızın içinde çalışır. Uygulama adaptörleri, sunucu servisleri ve veri kaynakları farklı görevler üstlenir: paketle gelen sunucu PostgreSQL ve Redis gerektirir; yapay zekâ ve MCP bağlantıları isteğe bağlıdır. Kimlik doğrulamayı uygulamanız sağlar. Entegrasyon kataloğu yüklenebilir bir eklenti mağazası yerine bu bağlantıları anlatır.

BağlantıGörevBaşlangıç
Next.js App RouterStüdyoyu ve Node.js sunucusunu çalıştırırNext.js kurulumu
React renderYerel belgeleri çözülmüş veri ve rota bağlamıyla gösterirÖnizleme ve yayımlama
PostgreSQLSayfaları, revizyonları ve yüklenen varlıkları saklarKurulum
RedisYayımlanan sayfaları ve şablonları önbelleğe alır; yapay zekâ isteklerini sınırlarDağıtım
JSON uç noktalarıAPI veya CMS içeriğini Request ve Repeat'e taşırDinamik veri
OpenRouterİsteğe bağlı Luma yapay zekâ üretimini açarYapay zekâ üretimi
MCPİşleticinin onayladığı sunuculardaki araçları keşfederMCP keşfi
Kimlik sağlayıcınızEditör, önizleme ve API erişimini yetkilendirirGüvenlik

1. Uygulamayı ve gerekli servisleri bağlayın

Üretimden ayrı bir geliştirme uygulaması, PostgreSQL veritabanı ve Redis servisiyle başlayın. pagiera paketini kurun, pagiera/full.css dosyasını içe aktarın ve servis adreslerini yalnızca sunucuda tanımlayın:

PAGIERA_POSTGRES_URL=postgresql://postgres:postgres@localhost:5432/pagiera
PAGIERA_REDIS_URL=redis://localhost:6379

Korumalı API'yi bağlamak, editörün başlangıç verisini yüklemek ve stüdyoyu göstermek için Next.js kurulumunu izleyin. Sunucu Node.js çalışma ortamı gerektirir; statik dışa aktarım veya yalnızca Edge kullanan dağıtım bu bağlantıları çalıştıramaz. Tek başına React render işlemi sunucu veya kimlik doğrulama sağlamaz.

Doğrulayın: oturum açın, /api/pagiera/health yanıtını kontrol edin, sayfa oluşturup kaydedin ve yeniden yükleyin. Ardından çıkış yapıp editör işlemlerinin reddedildiğini doğrulayın. Veritabanını ve Redis'i özel ağda tutun. Sağlık kontrolü başarısızsa yapay zekâ veya veri bağlamayı denemeden önce servis ya da yetkilendirme sorununu çözün.

2. Bir API veya CMS bağlayın

Uygun JSON uç noktası sunan servislerden sayfa verisi alabilirsiniz. Bu bir HTTP veri kaynağı bağlantısıdır; her CMS için pakete gömülü SDK veya hesap bağlantısı olduğu anlamına gelmez.

  1. Stüdyonun veri kaynağı arayüzünde uç noktayı ekleyip yanıtı inceleyin.
  2. Nesne için Request, koleksiyon için Repeat kullanın. Gerekirse $.items gibi iç içe liste yolunu seçin.
  3. Alt katmanları dönen alanlara bağlayın. Rota değerlerini {{params.slug}} gibi belirteçlerle aktarın.
  4. Yayımlamadan önce boş, hatalı ve bulunamayan yanıtları önizleyin.

Kalıcı kimlik bilgilerini sayfa adresine veya başlıklarına koymayın: editörler belgeyi görebilir. Gizli anahtarları sunucuda ekleyen ve istenen kaynakları doğrulayan, uygulamanıza ait bir proxy kullanın. İşletici açıkça izin vermedikçe özel ağ adresleri engellenir. İç servislere bağlanmadan önce kaynak sınırlarını ve hata davranışını okuyun.

3. İsteğe bağlı yapay zekâ ve ajan araçlarını ekleyin

Luma için sunucuda OPENROUTER_API_KEY ve OPENROUTER_MODEL tanımlayın. Sağlayıcı erişimini ve ücretlendirmeyi kontrol edip sınırlı bir düzenleme kapsamında üretin. Yayımlamadan önce katmanları inceleyip önizleyin. Editörün elle kullanılan araçları yapay zekâ anahtarı olmadan çalışır.

MCP keşfi için onaylı mcpServers bağlantılarını tanımlayıp authorizeMcp kontrolünü uygulayın. Bağlantılar stdio, HTTP veya SSE kullanabilir; stdio ayrıca çalıştırılabilir dosyanın sunucu ortamında kurulu olmasını gerektirir. Yetkilendirme geri çağırımı yoksa keşif reddedilir. Araçları listelemek veya incelemek onları otomatik çalıştırmaz. Yapılandırma sözleşmesi için yapay zekâ ve MCP rehberini okuyun.

CLI, kodlama ajanlarının yerel belgeleri inceleyip güncellemesinin ayrı bir yoludur. Uygulamanın API'sini ve yetkilendirme kurallarını kullanır; çalışan bir sunucu entegrasyonunun yerini almaz.

Bağlantı sorununu teşhis edin

BelirtiKontrol
Sağlık kontrolü başarısızVeritabanı adresi, Redis adresi, ağ ve uygulama oturumu
Stüdyo stilsiz açılıyorpagiera/full.css içe aktarımı
Repeat boşYanıt yapısı, liste yolu ve bağlanan alan adları
İç API engelleniyorİşleticinin özel ağ izinleri ve veri kaynağı politikası
Yapay zekâ üretimi başarısızSunucudaki anahtar, model erişimi, ücretlendirme ve istek sınırları
MCP keşfi 403 dönüyorİstek sahibinin oturumu ve authorizeMcp

Sonraki teşhis adımları için sorun gidermeyi kullanın. Bir bağlantıyı çalıştırmak için üretim kimlik bilgilerini tarayıcı yapılandırmasına kopyalamayın veya editörü korumasız açmayın.

Bu sayfada