MCP sunucusu
Bir yapay zekâ kodlama aracının bir uygulamayı kurmak veya senkronize etmek için kullandığı Rendel MCP araçları ve bir reddin nasıl döndüğü.
Rendel, https://rendel.ai/api/mcp adresinde bir MCP sunucusu çalıştırır (akış yapılabilir HTTP, durum bilgisi tutmayan JSON-RPC). Bir yapay zekâ kodlama aracı buraya bağlanır, tek bir uygulama için tarayıcınız üzerinden oturum açar ve kodunuz üzerinde çalışırken yönetim panelini doldurmak için bu araçları kullanır. Yapay zekâ ile kurulum, Claude Code'un nasıl bağlanacağını açıklar.
Araçlar, Setup API ile aynı işlemleri çağırır; dolayısıyla her iki yol da aynı satırları yazar. Adları ve açıklamaları bir uygulama için asla değişmez: mcp__rendel__* üzerindeki bir izin kuralı tam olarak bunları onaylar.
Araçlar
| Araç | Ne işe yarar |
|---|---|
rendel_start({app, tool, model?, os?, detected?}) | İlk olarak çağırın. İstemde belirtilen uygulamaya (app, uygulamanın slug'ı) bağlanır ve Overview'a yapay zekâ kodlama aracının bağlandığını bildirir. Uygulamayı, bunun bir kurulum mu yoksa bir eşitleme mi olduğunu (ve eşitleme için geliştiricinin tarif ettiği değişikliği), her iki yayınlanabilir anahtarı, SDK sürümlerini ve kod parçacıklarını, ayrıca kurulum kılavuzunu döndürür. Tekrar çağrılmasında bir sakınca yoktur |
rendel_get_context | Rendel'in hâlihazırda tuttukları: bağlantılar ve açıklama, uygulamanın web sitesinden okunanlar, mevcut görünüm, deneyim, bilgi birikimi, aksiyonlar ve ekranlar (her biri kendi external_key değeri ve kaynağıyla birlikte), en son derlemenin manifesti ve olgular |
rendel_report_progress({events, detected?}) | Sunucunun göremediği adımlardaki ilerleme (discover, install, identity, verify) veya atlanan ya da başarısız olan bir adım; çağrı başına 50 adede kadar olay |
rendel_set_appearance | Uygulamanın temasından alınan görünüm, her bir değerin nereden okunduğu bilgisiyle birlikte taslağa aktarılır. Varsa kontrast uyarıları ve bunların düzeltmeleriyle yanıt verir |
rendel_upload_logo({filename, content_base64}) | Depodaki logo: PNG, JPEG, WebP veya SVG, 2 MB'a kadar, base64 olarak taslağa aktarılır |
rendel_set_experience | İsim, ton, talimatlar, güvenlik sınırları, reddedilecek konular, diller, karşılama başlığı ve metni, dörde kadar öneri taslağa aktarılır |
rendel_upsert_knowledge({items}) | Herkese açık URL'ler (Rendel bunları çeker) veya uygulamanın kodundan ve metinlerinden yazılan içerikler, external_key değerine göre; çağrı başına 25 ögeye ve 2 MB'a kadar. {op: "archive", external_key} bir ögeyi arşivler |
rendel_declare_screens({screens, archive}) | Kodun registerRoute ile kaydettiği ekranlar, dosya ve derin bağlantıyla birlikte; bir derleme bunları doğrulayana kadar planlanmış olarak gösterilir |
rendel_upsert_actions({items}) | Uygulamanın REST uç noktaları HTTP aksiyonları olarak, external_key değerine göre, çağrı başına 50 adede kadar. auth: "user" giriş yapmış kişinin belirtecini gönderir (yalnızca https); paylaşılan bir anahtara ihtiyaç duyanlar ise devre dışı bırakılarak kaydedilir |
rendel_status({wait_for?}) | Sunucunun şu anda bildikleri: uygulamanın çağrıda bulunup bulunmadığı, bilgilerin dizine eklenip eklenmediği, hâlâ eksik olan ekranlar, Go live denetimleri. wait_for (app_ready veya knowledge_ready) bu işaret için yaklaşık 50 saniyeye kadar bekler |
rendel_run_smoke({latest?}) | Yapılandırmadan üç ila beş soru, her birinin temellendirilmiş veya bir aksiyonla desteklenmiş olduğu değerlendirilir; 2,5 dakikaya kadar sürer. latest: true son çalıştırmayı döndürür |
rendel_complete({summary, files_changed, human_todos}) | Bir özet, değiştirilen dosyalar ve yapılacak işler ile işlemi sonlandırır. İlk kurulum ayrıca taslakları yayınlar ve dört denetimi geçtiğinde canlıya alınır. Oturumu sonlandırır |
rendel_fail({reason, step?}) | Overview'da gösterilen neden ve adımla birlikte durdurur. Oturumu sonlandırır |
Canlıdaki bir uygulamada (senkronizasyon), her yazma işlemi bir değişiklik yerine Sync review içinde bir öneri hâline gelir.
Retler
Bir ret, isError: true ve sabit bir mesaj içeren bir araç sonucu olarak döner; böylece yapay zekâ kodlama aracı bunu okur ve devam eder veya durur. Yalnızca eksik veya süresi dolmuş bir oturum açma HTTP 401 hatasıdır. Bir sonucun içindeki hiçbir şey Rendel'in başka bir yerden okuduğu metin değildir: rendel_get_context kimlikleri, başlıkları, adresleri ve external_key değerlerini verir, taranmış bir sayfayı asla vermez.
| Durum | Sonuçta belirtilen |
|---|---|
| Yazma işlemi kimlik bilgisine benzeyen bir şey taşıdığında | Hangi alan olduğu ve anahtarların yönetim panelinde girildiği |
| Bir değer şemasına uymadığında | Alan ve ne beklediği |
| Oturum sona erdiğinde veya durdurulduğunda | Oturumun kapalı olduğu; Overview üzerinden tekrar başlayın |
| Uygulama canlıda olduğunda ve bu bir kurulum olduğunda | Sync with code kullanılması gerektiği |
Erişim
Yapay zekâ kodlama aracı OAuth 2.1 ile oturum açar: bunu tek bir uygulama için tarayıcınızda onaylarsınız ve izin, bu kurulum sona erene kadar geçerli kalır; erişim belirteçleri bir saat sürer ve yalnızca oturum açıkken yenilenir. Oturumu durdurursanız (Overview üzerinde veya Settings → AI setup sessions bölümünden), yapay zekâ kodlama aracının erişimi bir sonraki çağrısında sona erer. Deponuzda veya isteminizde hiçbir şey saklanmaz. İstemciler sunucu ayrıntılarını şu adreste bulur:
https://rendel.ai/.well-known/oauth-protected-resource/api/mcphttps://rendel.ai/.well-known/oauth-authorization-server(yalnızca S256 ile PKCE; dinamik istemci kaydı ve istemci kimliği meta veri belgeleri)
Setup API
Kurulum ve senkronizasyon dosyalarının çağırdığı her uç nokta: kimlik doğrulama, gövdeler, yanıtlar, adım kimlikleri, sınırlar ve hatalar. Kendi yapay zeka kodlama aracınızı yazmak veya kurulumu CI üzerinden çalıştırmak için.
REST API
SDK'nın alabileceği her uç nokta, her başlık ve her durum kodu.