ikas MCP Server nasıl kurulur?

ikas MCP Server, yönetim panelinden bir MCP istemci tokenı oluşturup sunucu adresini uyumlu istemciye ekleyerek kurulur. Ardından araç listesi okunur ve düşük riskli bir sorguyla bağlantı doğrulanır.

Kurulumda mağaza şifresi kullanılmaz. Gerekli bilgiler, ikas panelinde gösterilen MCP Server adresi ile bu bağlantı için üretilen istemci tokenıdır.

Menü adları hesap türüne ve panel sürümüne göre değişebilir. Bu nedenle sunucu adresini veya yetkilendirme biçimini tahmin etmeyin; hesabınızda gösterilen güncel değerleri kopyalayın.

ikas MCP Server kurulumu için neler gerekir?

Kurulum için MCP erişimi açık bir ikas mağazası, yetkili panel hesabı, istemci tokenı ve uzak MCP sunucularını destekleyen bir uygulama gerekir.

Önce ikas hesabınızda Public API veya MCP bölümünün göründüğünü kontrol edin. Bölüm görünmüyorsa paket, mağaza durumu veya kullanıcı yetkisi bakımından hesabınızı inceleyin.

Kullanacağınız AI aracı, yalnız yerel stdio sunucularını değil uzak MCP bağlantılarını da desteklemelidir. İstemcide sunucu URL’si, kimlik doğrulama ve araç listeleme seçenekleri aranmalıdır.

• Aktif ve erişilebilir bir ikas mağazası
• Entegrasyon ayarlarını yönetebilen panel kullanıcısı
• Panelden alınmış güncel MCP Server adresi
• Yalnız MCP bağlantısı için üretilmiş istemci tokenı
• Uzak MCP sunucularını destekleyen istemci
• Bağlantı günlüklerini görüntüleme imkânı

Public API anahtarı ile MCP istemci tokenını otomatik olarak aynı kabul etmeyin. Panel iki ayrı değer üretiyorsa her değeri yalnız tanımlandığı bağlantı türünde kullanın.

İstemcinin yalnız komut ve argüman alanı sunması, doğrudan uzak URL kabul etmediğini gösterebilir. Böyle bir istemcide desteklenen uzak bağlantı yöntemi veya güvenilir bir köprü gerekir.

Kurulum, hesabınızda MCP özelliği bulunmuyorsa işe yaramaz. Ayrıca istemci kullandığınız aktarım yöntemini desteklemiyorsa doğru token girilse bile bağlantı kurulamaz.

ikas MCP istemci tokenı nasıl oluşturulur?

MCP istemci tokenı, ikas panelindeki Public API veya MCP erişim alanından yeni bir istemci tanımlanarak oluşturulur.

İşleme başlamadan önce tokenın hangi ortamda kullanılacağını belirleyin. Geliştirme, test ve canlı ortamların aynı kimlik bilgisini paylaşması hata incelemesini ve erişim iptalini zorlaştırır.

1. Yetkili kullanıcı hesabıyla ikas yönetim paneline giriş yapın.
2. Public API, geliştirici veya MCP erişim bölümünü açın.
3. Yeni MCP istemcisi ya da token oluşturma seçeneğini bulun.
4. İstemciye ortamı belirten açıklayıcı bir ad verin.
5. Sunulan yetkiler varsa yalnız gerekli kapsamları seçin.
6. Tokenı oluşturun ve güvenli bir parola kasasına kaydedin.
7. Panelde gösterilen MCP Server adresini ayrıca kopyalayın.

Örnek ad olarak ikas-canli-siparis-okuma kullanılabilir. Bu ad, tokenın mağazasını, ortamını ve kullanım amacını günlük kayıtlarında ayırt etmeyi kolaylaştırır.

Bazı sistemler token değerini yalnız oluşturulduğu anda tam gösterir. Değeri açık bir metin dosyasına, proje deposuna, destek kaydına veya ekran görüntüsüne eklemeyin.

Yanlış: Tek tokenı geliştiriciler, canlı otomasyon ve test uygulamaları arasında paylaşmak. Doğru: Her ortam ve entegrasyon için ayrı token oluşturmak, kullanılmayanı iptal etmek.

Token oluşturma ekranında kapsam seçimi yoksa yetkileri araç düzeyinde denetleyin. İstemcinin gördüğü araç listesini kaydedin ve beklenmeyen yazma işlemlerini canlıya geçmeden belirleyin.

MCP Server adresi istemciye nasıl eklenir?

MCP Server adresi, istemcinin yeni uzak sunucu ekranına URL ve token bilgileri birlikte girilerek eklenir.

Her MCP istemcisinin alan adları farklı olabilir. Bir uygulama token için ayrı kutu sunarken diğeri özel HTTP başlığı isteyebilir. İkas panelindeki bağlantı talimatını esas alın.

Aşağıdaki yapı yalnız kavramsal bir örnektir. Anahtar adları kullandığınız istemciye göre değişir; doğrudan kopyalanacak resmi bir ikas yapılandırması değildir.

{
  "name": "ikas-canli",
  "type": "remote",
  "url": "IKAS_PANELINDEN_KOPYALANAN_URL",
  "token": "GUVENLI_DEPOLANAN_MCP_TOKENI"
}

İstemci özel başlık istiyorsa tokenı, yalnız ikas’ın belirttiği başlık ve önek biçimiyle gönderin. Authorization veya Bearer kullanımını dokümanda görmeden varsaymayın.

Ayarları kaydettikten sonra istemciyi yeniden başlatmak gerekebilir. Ancak bazı uygulamalar sunucu listesini anında yeniler. Yenileme davranışını istemcinin bağlantı günlüğünden kontrol edin.

Tokenı URL sorgu parametresine eklemek, istemci özellikle istemiyorsa tercih edilmemelidir. URL’ler tarayıcı geçmişine, ters proxy günlüklerine ve hata raporlarına daha kolay yazılabilir.

Bağlantının çalıştığı nasıl test edilir?

Bağlantı, önce oturum durumu ve araç listesi kontrol edilerek, sonra salt okunur bir mağaza sorgusu çalıştırılarak test edilir.

İlk denemeyi ürün güncelleme, sipariş değiştirme veya iade başlatma gibi yazma işlemleriyle yapmayın. Önce veri döndüren fakat mağaza durumunu değiştirmeyen bir araç seçin.

1. İstemcide eklenen ikas sunucusunu etkinleştirin.
2. Bağlantı durumunun başarılı göründüğünü doğrulayın.
3. Sunucunun sunduğu araç veya yetenek listesini açın.
4. Parametresiz ya da basit filtreli okuma aracı seçin.
5. Tek bir kayıt veya küçük bir sonuç kümesi isteyin.
6. Dönen alanları ikas panelindeki kayıtla karşılaştırın.
7. İstemci ve sunucu günlüklerinde hata bulunmadığını kontrol edin.

Araç adlarını tahmin etmek yerine istemcinin keşfettiği güncel listeyi kullanın. MCP Server tarafından sunulmayan bir işlemi doğal dil komutuyla zorlamak, yeni bir API yetkisi oluşturmaz.

Testte ürün adı, sipariş durumu veya stok bilgisi gibi doğrulanabilir bir alan seçin. Sonucun aynı mağazaya ait olduğunu mağaza kimliği veya bilinen kayıt üzerinden doğrulayın.

Bağlantının açılması tek başına yeterli değildir. Token geçerli olabilir fakat gerekli araç yetkisi bulunmayabilir. Bu durumda oturum kurulur, ilgili çağrı ise yetki hatası verir.

Yazma testi gerekiyorsa önce test mağazası kullanın. Bu mümkün değilse geri alınabilir tek bir kayıt seçin, işlem öncesi değeri kaydedin ve değişikliği panelden doğrulayın.

Satın alma verisini MCP çıktısıyla analiz edecekseniz kaynak ölçümünü ayrıca denetleyin. ikas’ta GA4 satın alma ölçümü kurulumu, tarayıcı ve analiz tarafındaki kontrol adımlarını açıklar.

Token ve mağaza verileri nasıl güvenli tutulur?

Token ve mağaza verileri, en az yetki, ayrı ortamlar, merkezi secret yönetimi ve düzenli erişim denetimiyle korunur.

MCP bağlantısı ürün, sipariş veya müşteri verilerine ulaşabiliyorsa token bir parola gibi değerlendirilmelidir. Kod deposunda görünmemesi, sohbet geçmişine yapıştırılmaması ve istemci günlüklerinde maskelenmesi gerekir.

• Canlı ve test ortamları için ayrı token kullanın.
• Tokenı ortam değişkeninde veya secret kasasında saklayın.
• Yalnız gereken araçlara ve verilere erişim verin.
• Yazma işlemlerinde insan onayı uygulayın.
• Günlüklerde token ve kişisel verileri maskeleyin.
• Ekipten ayrılan kullanıcının erişimini aynı gün kaldırın.
• Şüpheli kullanımda tokenı iptal edip yenisini üretin.

Sabit bir yenileme süresi uydurmak yerine kurum politikasını uygulayın. Personel değişikliği, sızıntı şüphesi, yanlış paylaşım veya istemci kaybı yaşandığında tokenı beklemeden döndürün.

AI ajanına serbest yazma yetkisi vermek operasyonel risk oluşturur. Fiyat, stok, sipariş durumu ve iade kararlarında izin verilen alanları ve değer aralıklarını önceden tanımlayın.

Müşteri adı, telefon numarası ve adresi gibi kişisel verileri gereksiz yere modele göndermeyin. Görev yalnız sipariş sayımıysa kayıtların tüm ayrıntılarını aktarmak gerekli değildir.

İade otomasyonu tasarlanıyorsa iş kuralları teknik yetkiden önce yazılmalıdır. ikas’ta iade talebi yönetimi içindeki durum ve kontrol noktaları bu akışın sınırlarını belirlemeye yardımcı olur.

Proxy veya ara sunucu kullanılıyorsa iki erişim katmanı oluşur. Hem ikas tokenını hem ara sunucu kimliğini ayrı yönetin; ikisini aynı günlük kaydında açık biçimde göstermeyin.

ikas MCP Server hangi otomasyonlarda kullanılabilir?

ikas MCP Server, sunucunun sunduğu araçlar kapsamında mağaza verisini AI ajanlarına ve otomasyon akışlarına kontrollü biçimde bağlamak için kullanılabilir.

Örnek kullanım, belirli koşullardaki siparişleri özetlemektir. Ajan araç listesinden uygun okuma işlemini seçer, sonucu filtreler ve operatöre işlem gerektiren kayıtları sunar.

Ürün tarafında eksik açıklama, stok riski veya kategori tutarsızlığı incelenebilir. Ancak araç listesinde güncelleme yetkisi bulunmuyorsa sistem yalnız analiz üretir; mağaza kaydını değiştiremez.

Müşteri hizmetleri akışında sipariş durumu bulunup temsilciye özet verilebilir. Kişisel veri içeren çıktılar yalnız görev için gerekli alanlarla sınırlandırılmalı ve genel sohbet kanallarına taşınmamalıdır.

MCP, her entegrasyon için en iyi yöntem değildir. Kesin zamanlamalı, yüksek hacimli ve tamamen deterministik veri aktarımında doğrudan Public API veya webhook tabanlı mimari daha uygun olabilir.

AI ajanının yorumlama ve araç seçme avantajı, değişken kullanıcı taleplerinde belirginleşir. Sabit bir stok senkronizasyonu ise doğal dil kararına ihtiyaç duymaz ve klasik entegrasyonla daha öngörülebilir çalışır.

Mağaza verisini yapay zekâ tabanlı alışveriş yüzeylerine hazırlıyorsanız Google UCP ile AI Mode’da satış sürecini ayrıca inceleyin. MCP bağlantısı, ürün verisi uygunluk şartlarının yerine geçmez.

Sunucu tarafı veri aktarımı planlayan ekipler, kimlik bilgisi ve olay akışı yaklaşımını Meta CAPI Gateway kurulumu ile karşılaştırabilir. İki sistemin amacı farklıdır, fakat erişim güvenliği ilkeleri benzerdir.

ikas MCP bağlantı hataları nasıl çözülür?

Bağlantı hataları, HTTP durumu, istemci günlüğü, sunucu adresi, token geçerliliği ve araç yetkisi sırayla kontrol edilerek çözülür.

401 ile 403 aynı sorun değildir. 401 genellikle kimliğin doğrulanamadığını, 403 ise tanınan istemcinin istenen işleme yetkili olmadığını gösterir.

URL’yi elle yazmayın. Fazladan boşluk, eksik yol veya eski bir adres bağlantıyı bozabilir. Güncel değeri panelden kopyalayıp istemci alanına yeniden yapıştırın.

Araçlar görünüyor fakat çağrı başarısız oluyorsa giriş parametrelerini inceleyin. Zorunlu alan, veri türü veya kabul edilen durum değeri istemcinin araç şemasında gösterilmelidir.

İstek küçük sorgularda çalışıp büyük sorgularda zaman aşımına uğruyorsa sonucu filtreleyin veya sayfalayın. Sunucunun ilan ettiği sınırları kullanın; belgelenmemiş bir istek sayısı varsaymayın.

Hata kaydı paylaşırken tokenı ve müşteri verilerini silin. İnceleme için zaman damgası, istemci sürümü, araç adı, hata kodu ve kişisel veri içermeyen istek özeti yeterlidir.

Kurulum canlı ortamda nasıl devreye alınır?

Canlıya geçiş, test edilen yapılandırmanın ayrı bir üretim tokenıyla kurulması ve yazma işlemlerine onay sınırı eklenmesiyle yapılır.

Önce test sonuçlarını kaydedin. Bağlantı durumu, keşfedilen araçlar, başarılı örnek sorgu, hata davranışı ve geri alma yöntemi belgelenmeden üretim erişimi açmayın.

1. Canlı kullanım için ayrı MCP istemcisi oluşturun.
2. Gerekli en düşük yetkileri seçin.
3. Tokenı üretim secret kasasına kaydedin.
4. Salt okunur bağlantı testini tekrarlayın.
5. Yazma işlemlerine insan onayı ekleyin.
6. Hata ve erişim günlüklerini etkinleştirin.
7. Token iptal ve geri dönüş adımlarını belgeleyin.

İlk canlı çalıştırmayı sınırlı kapsamda yapın. Tek mağaza, tek işlem türü ve düşük sayıda kayıtla başlamak, yanlış araç seçiminin etkisini azaltır.

Otomasyon ürün veya sipariş güncelliyorsa işlem öncesi değeri kaydedin. API idempotency desteği sunuyorsa aynı isteğin tekrarında çift işlem oluşmasını önleyen anahtarı kullanın.

İzleme yalnız teknik hata sayısını kapsamamalıdır. İşlenen kayıt sayısı, başarısız çağrı türü, onay bekleyen işlem ve beklenmeyen veri değişikliği ayrı izlenmelidir.

Token iptal edildiğinde çalışacak geri dönüş planı hazırlayın. Kritik operasyonlar tamamen AI ajanına bağlıysa bağlantı kesintisinde panel üzerinden uygulanacak manuel süreç önceden tanımlanmalıdır.

MCP kurulumu ölçüm altyapısının yerine geçmez. Otomasyonun satışa etkisini değerlendirirken GA4, sipariş kayıtları ve reklam platformları arasındaki veri farklarını ayrı raporlayın.