Yapay zekâ ile kurulum, ayrıntılı olarak

Yapay zekâ ile kurulum kısa versiyondur. Bu sayfa ise arka planda olanları anlatır: iki yol, aracınızın attığı her adım, nelere erişip nelere erişemeyeceği ve bir çalıştırma yarıda kaldığında nasıl kurtarılacağı.

Aracınız deponuzda çalışır ve ilerledikçe Rendel'in yönetim paneli dolar: görünüm, uygulama içi asistan, bilgi birikimi, ekranlar ve aksiyonlar. Yazdığı her ayar yönetim panelinde elle de değiştirilebilir. Kurallarınız kodunuzu araçlardan uzak tutuyorsa araçsız kurulum yapın.

İki yol

Yönetim panelindeki kart, her araç için kurulum dosyasıdır. MCP sunucusunu bağlamak Claude Code içindir ve bir araca izin verilmediğinde prompt'u kendiliğinden dosyaya geri döner.

Kurulum dosyası (herhangi bir araç)

1. Overview ekranındaki prompt'u aracınıza yapıştırın:

Bu prompt, araca SDK'yı eklemesini ve şemanın belirttiği gibi (açıklamaları kılavuz niteliğindedir; kopyaları her iki SDK ile birlikte gelir) uygulamanızı rendel/setup.json içinde tanımlamasını ve hiçbir yere hiçbir şey göndermemesini söyler.

2. Overview ekranının size verdiği komutla dosyayı projenizin kök dizininden içe aktarın (kod oturumunuza aittir ve oturum açıkken çalışır):

curl -fsS -H "Authorization: Bearer …" -F manifest=@rendel/setup.json -F logo=@assets/logo.svg "https://rendel.ai/api/setup/import"

Kod Authorization başlığında taşınır, böylece istek kayıtlarının dışında kalır; kabuk geçmişiniz oturum sonlanana kadar kodu tutmaya devam eder.

Ya da Overview ekranında Drop rendel/setup.json here yazan yere bırakın (bunu da içe aktarmak için logoyu da beraberinde bırakın). İçe aktarma, herhangi bir şey yazmadan önce tüm dosyayı kontrol eder; bu nedenle reddedilen bir içe aktarma, yönetim panelini olduğu gibi bırakır. Ardından her bölümü doldurur ve bir test sohbeti çalıştırır; tam bir içe aktarma ise bir aracın kurulumu gibi sonlanır: taslakları yayınlar ve dört Go live kontrolü geçtiğinde canlıya geçer. Overview Imported. Everything it set is in the console now. ifadesini gösterir ve oturum kapanır. Araç, şemanın kılavuzunun istediği gibi rendel/setup.json dosyasını .gitignore'a ekler.

Çok büyük bir bilgi tabanı, yalnızca $schema, version, app ve knowledge içeren bir dosyada ilk olarak gönderilebilir; yaklaşık 4,4 MB'ın üzerindeki bir içe aktarma, nasıl bölüneceğini belirten bir mesajla reddedilir. Setup API referansı tüm yanıtları listeler.

Aracınızı bağlayın (Claude Code)

Her makine için bir kez Rendel'in MCP sunucusunu ekleyin:

claude mcp add --transport http --scope user rendel https://rendel.ai/api/mcp

Ardından, Claude Code içinde:

1. Giriş yapın. /mcp → rendel → Authenticate. Tarayıcınız tek bir uygulamayı onaylamanızı ister.
2. Araçlara bir kez izin verin. /permissions → Allow → mcp__rendel__*. Otomatik modda çağrıların geçmesine izin veren kural budur.
3. Uygulamanızın slug'ı ile birlikte prompt'u yapıştırın:

Araç ilk olarak rendel_start çağrısını yapar; bu çağrı araca kurulum kılavuzunu, uygulamanızın yayınlanabilir anahtarlarını ve SDK kod parçacıklarını iletir ve Overview ekranı Agent connected durumunu gösterir. Buradan itibaren araç her adıma ulaştıkça Overview ekranında o adım yanar. Bir sonraki kurulumunuz veya eşitlemeniz için /mcp → rendel → Re-authenticate yolunu izleyin. Araçlar MCP referansı sayfasında listelenmiştir.

Araç neden Rendel'e kendisi istek göndermez?

Bir yapay zekâ kodlama aracının kendi güvenlik kontrolleri, yapıştırılan bir talimat üzerine projenizin ayrıntılarını dış bir adrese göndermesini engeller. Bunu Claude Code'da varsayılan modeliyle test ettik: yapıştırılan daha uzun bir kurulum prompt'u üç çalıştırmanın üçünde de “yalnızca yapıştırılmış metin” gerekçesiyle reddedildi; yazıldığında ise yüklemeleri veri sızıntısı gerekçesiyle geri çevrildi. Dolayısıyla dosya yolunda araç hiçbir şey göndermez, siz gönderirsiniz; MCP yolunda ise adıyla onayladığınız araçlar üzerinden yazar ve bu yöntem üç çalıştırmanın üçünde de başarılı oldu.

Aracın yaptıkları

Dosya yolunda 4 ila 8. adımlar rendel/setup.json dosyasının bölümleridir ve test, siz dosyayı içe aktardığınızda çalışır. 0 ve 9. adımlar MCP yoluna aittir: burada araç test etmeden önce uygulamanızın çağrı yapmasını bekler.

Nereye yazar

Her yazma işlemi, aracın seçtiği bir adla (external_key) anahtarlanır; böylece kurulumun yeniden çalıştırılması ikinci bir kopya eklemek yerine mevcut olanı günceller. Aracın yazdığı hiçbir şey bir şeyi silmez; kodunuzdan kaldırılan bir ögeyi daha sonraki bir eşitleme arşivlenmek üzere önerir.

Güvenlik

• Tek bir uygulama ve tek bir oturum için yetkilendirme. MCP yolunda aracı tarayıcınızda tek bir uygulama için onaylarsınız; yetkilendirme, bir saat süreli erişim belirteçleriyle birlikte kurulum bitene kadar sürer. Oturumu durdurduğunuzda (Overview ekranında veya Settings → AI setup sessions bölümünde), aracın erişimi bir sonraki çağrısında sona erer. Dosya yolunda ise hiçbir yetkilendirme yoktur: içe aktarma kodu oturum açıkken en fazla 24 saat çalışır.
• Deponuzda veya prompt'unuzda belirteç bulunmaz. Aracın saklaması gereken hiçbir şey gizli bilgi değildir.
• Kimlik bilgisine benzeyen hiçbir şey kabul edilmez. Sunucu her yazma işlemini tarar ve hangi yoldan gelirse gelsin bir parolayı, API anahtarını veya belirteci reddeder; böyle bir bilgi içeren içe aktarma bütünüyle reddedilir (422 secret_refused). Paylaşılan bir anahtar gerektiren bir uç nokta kapalı olarak kaydedilir ve anahtarı yönetim panelinde siz girersiniz.
• Canlıdaki bir uygulamanın ayarlarına doğrudan erişemez. Canlıdaki bir uygulamada her değişiklik, bir kişinin Sync review ekranında inceleyeceği bir öneri haline gelir.
• Şunları okuyamaz: sohbetleri, kullanıcıları ya da tasarım gereği herkese açık olan iki yayınlanabilir anahtar dışındaki hiçbir anahtarı.
• Web sitenizi Rendel'in sunucuları okur; bilgi bağlantılarını özel adreslerden uzak tutan aynı koruma üzerinden, araç hiçbir zaman okumaz.

Her değişiklik, uygulamanızın denetim kaydında ilgili kurulum oturumu altında yer alır. Settings → AI setup sessions bölümü geçmiş ve çalışan oturumları listeler ve çalışan bir oturumu durdurur.

Takılıp kalırsa

Kendi istemcinizi yazma

Her iki yol da belgelenmiştir: dosyanın JSON Şeması ile birlikte MCP araçları ve Setup API.