ARCY MCP

ARCY MCP, kodlama ajanınızın bağlandığı sunucudur. Ajan, yazılım ürününüzü deponuzdan yola çıkarak yüzey yüzey kurar; yazdığı her şey sizin Kabul et demenizi bekler. Bağlantıyı Ayarlar > ARCY MCP sayfasında kurarsınız. Her yüzeyin sayfasındaki ARCY MCP ile ajanınıza devredin bağlantısı bu sayfayı o yüzeyin maddesinde açar.

Başlamadan önce

• Ajan token'ını yalnızca bir Yönetici oluşturur ve iptal eder; her kişinin yazılım ürünü başına tek bir etkin token'ı olur, yani ajanı çalıştıran her geliştirici kendi token'ını oluşturur. Üyeler token'ları ve adımları görür. Bakınız Ekip.
• Ajanı yazılım ürününüzün yerel ya da staging kopyasında çalıştırın, üretim ortamında asla: akış önizlemesi tıklar, doldurur ve API'nizi çağırır. Akışlar için Playwright gerekir.
• Token okur ve önerir. Yayınlayamaz, silemez, kabul edemez.

Kurulum

Ajan token'ları. Token'a bir Ad verin, sonra Token oluştur düğmesine basın. Bu yazılım ürününde zaten etkin bir token'ınız varsa formun yerinde onu adıyla anan tek bir cümle durur; token'ı iptal edince form geri gelir. Oluşturulan token bir kez gösterilir; ARCY yalnızca özetini saklar. Tamam diyene kadar parçalar bu token'ı taşır, sonra yerinde <your Agent token> görünür.

Ajanınızı bağlayın. Ajanınızı seçin. Adımlar deponuzda açılan bir terminalle başlar ve yapılandırmayı ekler: https://api.arcyai.com/mcp adresi ve bearer başlığındaki token. Claude Code için bu bir kabuk satırı, diğer üçü için bir dosyadır. Cursor dosyası token'ınızı taşır; onu depoya sokmayın.

Ajanınız neler yapabilir. Dokuz madde vardır; her birinde ajanınızın çalıştırma satırı ve yapılandırmayla çalıştırma satırını tek parça kopyalayan, ajan başına bir düğme bulunur. ARCY'yi uçtan uca kurun maddesi Buradan başlayın rozetini taşır: nelerin bittiğini okur, hangi yüzeylerin çalıştırılacağını bir kez sorar ve sırayla çalıştırır. Diğer sekiz madde birer yüzey çalıştırır: arcy.js'i kurun, Öznitelikleri tanımlayın, Uç noktaları kataloglayın, Persona'yı yazın, Eğitim kaynakları ekleyin, Markaya uydurun, Listeden taslak akışlar yazdırın ve Limitleri önerin. Her maddenin yanında ajanın da okuduğu tek bir durum sözcüğü yazar: Başlanmadı, Önerildi (sizi bekliyor), Kabul edildi (yapılandırıldı, henüz ziyaretçiye ulaşmıyor) ya da Yayında.

Kartları yanıtlayın. Ajan, kodunuzun ve ARCY'nin zaten yanıtladığı her şeye kendisi karar verir; gerisini karar kartı olarak sorar: ne bulduğu, önerisi ve önerilen seçeneği kalın yazılmış seçenekler. Hiçbir şey iki kez sorulmaz. Depoda bir yüzeyin malzemesi yoksa tek bir kart sizi o malzemenin bulunduğu depoya yönlendirir; oradaki çalıştırma kaldığı yerden sürer.

Neyi değiştirir

Akış taslağı dışındaki her yazma bir öneridir. Bekleyen öneriler bölümü her birini Sayfayı aç bağlantısıyla listeler; ilgili sayfa (Öznitelikler, Endpoint'ler, Persona, Eğitim, Özelleştirme ya da yalnızca Yönetici için Limitler) öneriyi Ajanınızın önerisi kartında, önerilen değeri mevcut değerin yanında gösterir. Kabul et, öneriyi o sayfanın kendi denetimlerinden geçirerek uygular; At kaldırır. Aynı token'dan gelen ikinci öneri ilkinin yerini alır. İptal et, token'ın bekleyen önerilerini atar; kabul edilenler sayfada 30 gün adıyla kalır. Akışlar Akışlar sayfasına taslak olarak düşer; bir taslak önerilmiş bir özniteliği ya da endpoint'i bağlayabilir, Yayınla ise öneri kabul edilene kadar bekler.

arcy.js'i kurun maddesi ortam dosyalarınızdaki dört adın sahibidir: ARCY_TOKEN, ARCY_SECRET, ARCY_DEV_TOKEN, ARCY_DEV_SECRET. Ajan iki Token'ı ARCY'den okur, yazar ya da yeniden adlandırır. Secret hiçbir zaman aktarılmaz; eksik bir Secret için sizi Kimlik doğrulama sayfasına yönlendiren tek bir kart gelir.

MCP'nin kapsamadıkları: dosya yüklemeleri, üst logo, kimlik imzalama ve Bridge denetimi (ikisi de yapıştırılan görevini korur) ve Kabul et işleminin kendisi.

Sorun çıktığında

• Ajan 401 alıyor. Token iptal edilmiş ya da yanlış yazılmış; yeni bir token oluşturun.
• Token oluştur reddediliyor. Bu yazılım ürününde zaten etkin bir token'ınız var: önce onu iptal edin.
• Öneri kabul edilirken reddediliyor. Nedenini sayfanın kendi mesajı söyler, sözgelimi bu arada alınmış bir ad. Öneriyi atın ve yüzeyi yeniden çalıştırın.

Ayrıca bakın

• Akışlar
• Kurulum
• Referans