Ürün Yapılandırıcı MCP: Claude, Cursor ve VS Code'u Simplio3D'a bağlayın

Bugün bir yapay zekâ asistanına ürün yapılandırıcınız hakkında soru sorun; sohbete yapıştırdığınız her şeye göre yanıt verir: ekran görüntüsü, seçenek listesi, yazdığınız bir fiyat. MCP bağlantıları bu adımı ortadan kaldırır. Bir bağlantı, asistana Simplio3D hesabınıza doğrudan ve izinli bir erişim sağlar; böylece gerçek projeyi (seçenek blokları, koşullu kurallar, fiyatlandırma formülü, 3D modeldeki parça adları) okur ve yanıtlarını buna göre verir.

Bu kılavuz, MCP bağlantısının ne olduğunu, bağlı bir aracının Simplio3D içinde neleri yapıp yapamayacağını, riskli değişikliklerin nasıl sizin kontrolünüzde kaldığını ve Claude, Cursor veya VS Code'un nasıl bağlanacağını açıklar.

MCP bağlantıları nedir?

Model Context Protocol (MCP), yapay zekâ asistanlarını harici araçlara ve verilere bağlamak için açık bir standarttır. İki tarafı vardır. MCP istemcisi, Claude, Cursor veya VS Code gibi hâlihazırda kullandığınız yapay zekâ aracıdır. MCP sunucusu ise asistanın bağlandığı sistemdir: Asistanın ihtiyaç duyduğu bir soruda çağırabileceği, her biri açıklama ve şemaya sahip araçların listesini yayınlar.

Bağlantı, ikisi arasındaki köprüdür: sunucunun adresi ve kimin bağlandığını, nelerle etkileşim kurabileceğini belirten bir kimlik bilgisi. Claude buna özel bağlantı der; diğer istemciler ise MCP sunucusu girişi olarak adlandırır. Simplio3D için her zaman aynı iki unsur bulunur:

• Uç nokta: https://app.simplio3d.ai/mcp
• Kimlik bilgisi: Simplio3D onay ekranında onayladığınız bir OAuth oturum açma işlemi veya Dashboard → Integrations → AI Connections altında oluşturduğunuz bağlantı belirteci.

Bağlandıktan sonra asistan, Simplio3D araçlarını kendi araçlarının yanında görür ve isteğinize göre bunları ne zaman çağıracağına karar verir.

Bağlı bir ajan Simplio3D içinde neler yapabilir?

Simplio3D MCP sunucusu 123 araç sunar: 52’si okuma yapar, 68’i kontrollü yazma modeli kapsamında yazma yapar ve 3’ü ajan iş akışlarını çalıştırır. Bu araçlar birlikte projeleri, 3D model incelemeyi, malzemeleri, seçenek bloklarını, koşullu mantığı, fiyatlandırmayı, formları, teklif taleplerini ve mağaza bağlantılarını kapsar. Uygulamada bağlı bir ajan şunları yapabilir:

• Gerçek bir projeyi okuyabilir: modellerini, seçenek bloklarını ve varyantlarını, malzemelerini, koşullu kurallarını, fiyatlandırma bloklarını ve formülünü, ayrıca form alanlarını inceleyebilir.
• 3D modelin içini inceleyebilir: parça adlarını ve hiyerarşiyi görüntüleyerek her seçeneğin hâlâ mevcut bir mesh’i hedeflediğini kontrol edebilir.
• Bir yapılandırıcıyı denetleyebilir: eksik parça hedeflerini, silinmiş malzemeleri, asla tetiklenemeyecek kuralları ve fiyatı olmayan varyantları tespit edebilir.
• Mantığı açıklayabilir ve bir yapılandırmayı fiyatlandırabilir: hangi kuralın bir seçeneği gizlediğini ve belirli bir seçim kümesinin sunucuda hesaplanan maliyetini belirleyebilir.
• Oluşturabilir ve düzenleyebilir: projeler, seçenek blokları, varyantlar, malzemeler, koşullu kurallar ve form alanları oluşturabilir; mevcut içerikleri düzenleyebilir.
• Ajan iş akışlarını çalıştırabilir: proje denetimi veya güvenli onarım gibi çok adımlı bir işi başlatabilir, sorularını yanıtlayabilir ve ilerlemesini takip edebilir. İş akışları onayınızı beklemek üzere duraklar ve asla yayımlama yapmaz.
• Potansiyel müşterileri özetleyebilir: aldığınız teklif taleplerini ve her müşterinin ne yapılandırdığını okuyabilir.
• Dokümantasyondan ürün sorularını yanıtlayabilir: hafızasına dayanarak yanıt vermek yerine resmî Simplio3D dokümanlarında arama yapabilir ve ilgili sayfaya atıf verebilir.

Her aracın ihtiyaç duyduğu kapsam ve okuma mı yazma mı yaptığı, MCP araç referansında listelenmiştir.

Yapamayacağı şeyler

Verdiğiniz kapsamlar ne olursa olsun bazı işlemler erişilemez kalır. Bağlı bir ajan projeyi yayımlayamaz, paylaşım bağlantısı oluşturamaz veya gömme ayarlarını değiştiremez. Dosya yükleyemez ya da proje silemez. Bir Shopify veya WooCommerce mağazasını bağlayamaz ya da bağlantısını kesemez ve mağazanın kimlik bilgilerini okuyamaz. Ayrıca hiçbir zaman veritabanı erişimi, API anahtarları, webhook gizli anahtarları veya paylaşım görünümü parolaları almaz: araçlar ham kayıtlar yerine özenle hazırlanmış özetler döndürür.

Kapsamlar: her bağlantıya yalnızca ihtiyacı olan izinleri verin

Bir bağlantı yalnızca kapsamlarının karşıladığı araçları görebilir ve çağırabilir. Salt okunur erişimle başlayın ve iş gerektirdikçe her seferinde bir yazma kapsamı ekleyin.

Her şeyi yapabilen tek bir bağlantı yerine birkaç küçük bağlantı daha güvenlidir. Fiyatlandırmayı inceleyen asistana okuma kapsamları ve fiyatlandırma yazma izni içeren ayrı bir bağlantı, proje oluşturan asistana ise başka bir bağlantı verin. Böylece birini iptal etmek diğerini asla kesintiye uğratmaz.

Değişiklikler nasıl kontrolünüzde kalır?

Bir yapay zekânın canlı bir yapılandırıcıyı düzenlemesine izin vermek, yalnızca hatalı bir düzenlemenin müşterilerinize ulaşamaması hâlinde işe yarar. Simplio3D, her yazma işlemini üç adımda yönetir: öner, onayla, anlık görüntü al.

• Düşük riskli düzenlemeler siz beklenmeden uygulanır; örneğin bir bloğu yeniden adlandırmak veya varyant eklemek.
• Yüksek riskli değişiklikler yalnızca öneri oluşturur: fiyatlandırma, SKU'lar, silmeler, toplu düzenlemeler, paylaşılan malzemeler ve mağaza ürün bağlantıları. Öneri, AI Connections sayfasındaki Pending AI changes altında bekler ve yapacağı her değişikliği listeler. Apply düğmesine basarak uygular veya reddedersiniz. Hiçbir aracı kendi önerisini onaylayamaz ve bu kural devre dışı bırakılamaz.
• Uygulanan her değişikliğin anlık görüntüsü alınır; böylece geri alınabilir, ardından yeniden doğrulanır ve denetim günlüğüne kaydedilir.

Öneriler kısa ömürlüdür. Aracının bir şey önermesinden sonra proje değiştiyse, eski öneri daha yeni düzenlemelerinizin üzerine yazılmak yerine reddedilir; aracından yeniden isteyin.

Buna ek olarak, bir araç çağrısı yalnızca dört kontrolün tamamı geçtiğinde başarılı olur: hesabın e-posta adresi doğrulanmış olmalı, çalışma alanı sahibinin planı etkin olmalı, koltuğun rolü işleme izin vermeli ve bağlantı gerekli kapsamı taşımalıdır. En dar kısıtlama geçerlidir. Örneğin Viewer koltuğu, bağlantısında hangi kapsamlar olursa olsun, asla değişiklik yapamaz veya onaylayamaz.

Claude’u token olmadan bağlama. Simplio3D, Claude’un bağlayıcı dizininde listelenir. Claude’da Customize → Connectors bölümünü açın, Simplio3D için arama yapıp Connect’e tıklayın veya Add custom connector seçeneğini belirleyip https://app.simplio3d.ai/mcp adresini yapıştırın. Her iki yöntemde de Claude, Simplio3D’ün oturum açma sayfasını ve çalışma alanını ile kapsamları seçtiğiniz, salt okunur erişimin sizin için işaretlendiği bir onay ekranını açar. Ardından bağlantı, aynı AI Connections listesinde OAuth app olarak işaretlenmiş şekilde görünür; diğer bağlantılarda olduğu gibi anahtarını yenileyebilir veya buradan iptal edebilirsiniz.

Önce denemeniz için istemler

Projenin adını belirtin ve kanıt isteyin: “hangi kural bunu gizliyor?” sorusu, “neden gizli?” sorusundan daha net bir yanıt sağlar.

Güvenmeden önce bilmeniz gereken sınırlar

• Aracılar kaydedilmiş verileri okur. Düzenleyici her değişiklikten birkaç saniye sonra otomatik kaydeder; bu nedenle az önce yapılan bir düzenleme henüz görünmeyebilir. Kaydedin, ardından tekrar sorun.
• Sunucu tarafı fiyatlar ve mantık bazı sınırlamalara tabidir. Fiyat hesaplaması ve kural değerlendirmesi, birim başına Sayı Girişi fiyatlandırması gibi yayımlanmış yapılandırıcının her davranışını değil, yaygın durumları kapsar. Her sonuç, değerlendirmediği unsurları listeler; Önizleme ve yayımlanan paylaşım görünümü nihai referans olmaya devam eder.
• Hız sınırları. Her bağlantı, her beş dakikada 300 istek gönderebilir. Bir çalışma alanı, bağlı tüm aracılar ve yerleşik asistan arasında paylaşılan şekilde her on dakikada 30 uygulanmış AI değişikliğini kabul eder.
• Büyük yanıtlar kısaltılır ve bu belirtilir. Yaklaşık 60 KB'ı aşan bir sonuç özetlenir ve kesildi olarak işaretlenir; böylece aracı, bir listenin bir bölümünü tamamı sanmaz.
• Aracının okuduğu içerik AI sağlayıcınıza gönderilir. Teklif talepleri müşteri adlarını ve iletişim bilgilerini içerir; bu nedenle Teklifler kapsamını bilinçli şekilde verin.
• Token'ların süresi 90 gün sonra dolar. Bir token bir sohbete, destek talebine veya ekran paylaşımına yapıştırıldıysa hemen yenileyin. Yenileme, eski token'ı anında devre dışı bırakır.

Her AI arayüzünün arkasındaki tek araç katmanı

MCP sunucusu sonradan eklenmiş ayrı bir ürün değildir. Simplio3D’in yerleşik AI asistanı, kendi otomasyonlarınız için kimliği doğrulanmış REST araç uç noktası ve harici MCP istemcileri; aynı kimlik doğrulama, izinler ve denetim günlüğü arkasındaki aynı araç kayıt defterini çağırır. Bir yetenek, nereden çağırırsanız çağırın aynı şekilde çalışır; bir kapsam veya rol onu bir yerde engelliyorsa her yerde engeller.

Bu aynı zamanda MCP'nin REST API ve SDK'den nasıl ayrıldığını da açıklar. SDK, kendi kodunuz için yazılmış, API anahtarıyla kimliği doğrulanan tür tanımlı bir istemcidir ve bu anahtar MCP uç noktasında asla kabul edilmez. MCP, araç başına kapsam belirlediğiniz bir bağlantıyla kimliği doğrulanan AI aracılar içindir.