Shopify MCP: mağaza verilerinize Claude ve diğer yapay zeka uygulamalarından sorun

Bir Shopify MCP sunucusu, mağaza verilerinizi Model Context Protocol (MCP) üzerinden bir yapay zeka asistanına bağlar. “Geçen ay en çok kârı hangi kampanya getirdi?” gibi bir soruyu sade bir dille sorarsınız ve asistan, hafızasından değil mağazanızın gerçek sayılarından yanıt verir. ROASaurus, 24 salt okunur analitik aracı olan bir MCP sunucusu çalıştırır ve aynı araçlar panelin içindeki Ask AI'ı da besler.

Bu rehber MCP'nin ne olduğunu, analitik sorularını bu şekilde sormanın neden işe yaradığını, Ask AI ve MCP sunucusunun nasıl çalıştığını, bir istemcinin nasıl bağlanacağını, hangi soruların iyi çalıştığını ve bilmeniz gereken gizlilik, güvenlik ve sınırları açıklar.

MCP nedir?

MCP, yapay zeka uygulamalarını harici sistemlere bağlamak için açık kaynaklı bir standarttır. Claude gibi bir yapay zeka uygulaması istemcidir. Veri ya da eylem sunan bir hizmet sunucudur. Sunucu araçlarını tanımlar: her aracın bir adı, bir açıklaması ve girdileri için bir şeması vardır.

Bir soru sorduğunuzda istemci, sunucuya hangi araçların olduğunu sorar (tools/list). Model uygun aracı seçer ve istemci onu çağırır (tools/call). Sonuç, yanıtı yazan modele geri döner. Araç adlarını bilmeniz gerekmez. Yalnızca soruyu sorarsınız.

Shopify de MCP sunucuları çalıştırır. Bunlar alışveriş ajanlarına ve geliştiricilere odaklanır: ürün arama, sepetler, ödeme, müşteri hesapları ve geliştirici belgeleri. Bir analitik MCP sunucusu farklı türde bir soruyu yanıtlar: siparişlerinizden, maliyetlerinizden ve reklam hesaplarınızdaki harcamadan hesaplanan reklam sonrası kâr, atıf ve müşteri değeri.

Mağaza verinizi neden bir yapay zeka asistanına sormalısınız?

Mağaza sorularının çoğu birkaç rapordan sayılar gerektirir. "Meta geçen ay para kazandırdı mı?" sorusu ciroyu, ürün maliyetlerini, kargoyu, komisyonları ve reklam harcamasını tek bir yerde ister. Bir panelde doğru raporu açar, tarihleri ayarlar ve hesabı kendiniz yaparsınız. Verilerinize bağlı bir yapay zeka asistanında soruyu sorarsınız ve yanıtı arkasındaki sayılarla alırsınız.

• Sade dil. Filtre, rapor oluşturucu ya da elektronik tablo formülü yok.
• Takip soruları. Baştan başlamadan "Peki TikTok için?" veya "bunu hangi kampanya yarattı?" diye sorun.
• Tek yanıtta birkaç rapor. Kâr, atıf ve müşteri değeri tek bir yanıtta birleştirilebilir.
• Kendi diliniz. Ask AI, yazdığınız dilde yanıt verir.
• Diğer işlerinizin yanında. MCP sayesinde mağaza sayıları, zaten güncellemelerinizi veya planlarınızı yazdığınız yapay zeka uygulamasında hazırdır.

Yanıt, arkasındaki veri kadar eksiksizdir. Araçların üzerinde çalışacağı siparişler, harcama ve marjlar olsun diye önce sunucu tarafı takibi, reklam hesaplarınızı ve ürün maliyetlerinizi bağlayın.

Ask AI ve ROASaurus MCP sunucusu nasıl çalışır?

Ask AI, ROASaurus panelindeki bir sohbet sayfasıdır. Anthropic'in modeli Claude üzerinde çalışır. MCP sunucusu aynı 24 aracı seçtiğiniz bir yapay zeka istemcisine sunar. Her iki durumda da araçlar ROASaurus raporlarınızı okur ve sayıları JSON olarak döndürür. Model yanıtı bu sonuçlardan yazar.

Her analitik aracı yalnızca okur. Hiçbir araç mağazanızı, kampanyalarınızı, maliyetlerinizi veya ayarlarınızı değiştiremez. MCP sunucusu her birini salt okunur olarak işaretler ve istemciye yalnızca araç sonuçlarından yanıt vermesini söyler. actions:write yetkisine sahip bir anahtar ayrıca Actions gelen kutusuna önerilen bir reklam değişikliği ekleyen propose_action aracını da alır; bir sahip ya da yönetici onaylayana kadar hiçbir şey değişmez. Paneldeki Ask AI'da da bu araç vardır.

Ask AI'da bir soru en fazla 8 tur araç çağrısı kullanabilir. Bir soru daha fazlasını gerektiriyorsa asistan sizden daha net olmanızı ister. Ask AI konuşmanızı kullanıcı ve mağaza başına tutar ve bir takip sorusu için son 12 mesajı bağlam olarak kullanır. Konuşmayı istediğiniz zaman temizleyebilirsiniz.

Hangi soruları sorabilirsiniz?

İyi sorular bir metriği ve desteklenen dönemlerden birini belirtir. Tablo örnek soruları, her birini yanıtlayan aracı ve yanıtın neye dayandığını gösterir.

İşte çözümlü bir örnek. Şunu sorarsınız: "Meta son 30 günde para kazandırdı mı?" Model, dönemi 30 gün ve varsayılan son tıklama modeline ayarlayarak campaign_profit aracını çağırır. Örnek bir mağaza için sonucun Meta satırı şöyle görünür:

Ask AI'da yanıt "Evet" ile başlar, sonra reklam sonrası kârı ve POAS'ı verir ve en fazla üç sonraki adım önerir. Başka bir bakış isterseniz "Peki Total Impact modeliyle?" gibi bir takip sorusu sorun. POAS ve atıf modelleri rehberlerimiz bu sayıları daha ayrıntılı açıklar.

ROASaurus MCP sunucusu nasıl bağlanır?

Sunucu, MCP’nin Streamable HTTP aktarımını kullanır ve server-sent events olmadan JSON yanıtları döndürür. Claude ve ChatGPT gibi yapay zekâ uygulamaları OAuth ile oturum açar: ROASaurus’a giriş yapar, bir mağaza seçer ve bağlantıya izin verirsiniz. İstek başlığı ayarlayabildiğiniz istemciler, örneğin Claude Code, bunun yerine aşağıdaki adımlardaki gibi bir API anahtarı kullanabilir.

1. Bir API anahtarı oluşturun

   ROASaurus'ta Store settings › API & data sayfasını açın ve mcp yetkisine sahip adlandırılmış bir anahtar oluşturun. Kopyalayın: yalnızca bir kez gösterilir. Anahtarları yalnızca sahipler ve yöneticiler oluşturabilir.

2. Ya da Orders API anahtarını yeniden kullanın

   Orders API kartındaki anahtarı da kullanabilirsiniz; örneğin WooCommerce eklentisinin kullandığı anahtarı. Bu anahtar sipariş de gönderebilir. Regenerate API key onu değiştirir ve eski anahtarı kullanan her şeyin bağlantısını keser.

3. Mağaza anahtarını not edin

   Adlandırılmış bir anahtar başlığa tek başına girer. Orders API anahtarıyla birlikte mağaza anahtarını da ekleyin: aynı karttaki X-Roasaurus-Key değeri; kartın MCP bölümü tam başlığı gösterir.

4. Sunucuyu MCP istemcinize ekleyin

   Aşağıda gösterilen uç noktayı ve Authorization başlığını girin. İstemci Streamable HTTP'yi ve özel istek başlıklarını desteklemelidir.

5. Bir test sorusu sorun

   "Dünkü cirom neydi?" diye sorun ve sayıyı panelinizle karşılaştırın.

# Endpoint
POST https://app.roasaurus.com/mcp
Authorization: Bearer <named key with the mcp scope>
# or, with the Orders API key
Authorization: Bearer <store key>:<API key>

# Claude Code
claude mcp add --transport http roasaurus https://app.roasaurus.com/mcp \
  --header "Authorization: Bearer <named key with the mcp scope>"

Mağaza anahtarını bir X-Roasaurus-Key başlığında ve yalnızca API anahtarını bearer token olarak da gönderebilirsiniz. Claude Code'da varsayılan yerel kapsamı koruyun. Proje kapsamlı bir sunucu, sürüm kontrolü üzerinden paylaşılan bir .mcp.json dosyasına kaydedilir ve bu, anahtarınızı paylaşır.

Bunun yerine oturum açmak için https://app.roasaurus.com/mcp adresini Claude’da veya ChatGPT’de özel bağlayıcı olarak ekleyin ve uygulama istediğinde giriş yapın. Bir bağlantıya yalnızca sahipler ve yöneticiler izin verebilir. Store settings › API & data bağlı her uygulamayı listeler ve bağlantıyı oradan kesebilirsiniz; o kişi çalışma alanından ayrıldığında da bağlantı sona erer.

Güvenli mi? Gizlilik ve güvenlik

Analitik araçları yalnızca okuduğu için bir yapay zeka uygulaması ROASaurus üzerinden bir kampanyayı duraklatamaz, bir maliyeti düzenleyemez veya bir ayarı değiştiremez; actions:write ile yalnızca bir sahip ya da yöneticinin onaylaması için bir reklam değişikliği önerebilir. Araçlar ayrıca yalnızca bir dönem ya da listeden bir atıf modeli gibi sabit girdileri kabul eder. Yine de birkaç noktaya dikkat etmek gerekir.

• Verinin gittiği yer. Ask AI, sorunuzu ve toplulaştırılmış mağaza metriklerini Claude'u çalıştıran Anthropic'e gönderir. Müşterilerinizin iletişim bilgilerini göndermez. MCP üzerinden araç sonuçları, bağladığınız yapay zeka istemcisine, o istemcinin koşulları altında gider. Onun veri saklama ve eğitim ayarlarını kontrol edin.
• Araçların döndürdüğü. Dönem, kanal, kampanya, reklam, ürün, kohort ve segment başına toplamlar. Müşteri adı, e-posta adresi veya telefon numarası döndürmezler.
• Kimler sorabilir. Bağlantıyı eklediğiniz yapay zeka uygulamasına erişimi olan herkes mağazayı sorgulayabilir. Onu paylaşılan bir hesaba değil, kendi hesabınıza ekleyin.
• Diğer bağlayıcılar. MCP spesifikasyonu, araç çağrılarını reddedebilecek bir insanın her zaman döngüde olması gerektiğini ve sunucuya güvenilmedikçe istemcilerin araç açıklamalarını güvenilmez saymaları gerektiğini söyler. Yapay zeka uygulamanızın e-posta gönderen veya mesaj paylaşan araçları da varsa, bu araçlar için onay istemlerini açık tutun.

Sınırlar nelerdir?

• Sabit dönemler. Bugün, dün veya mağazanın saat diliminde son 7, 14, 30 ya da 90 gün. Mart'ta bir hafta gibi özel bir aralık desteklenmez. Müşteri değeri ve kohort araçları dönem almaz: sipariş geçmişinizden çalışır ve en fazla 12 aylık kohort kullanır.
• Reklamlar tablosu için 7 günlük pencere. Reklam aracı, Store settings içinde hangi pencereyi ayarlarsanız ayarlayın 7 günlük bir geriye dönük bakış penceresi kullanır. Atıf ve kampanya kârı araçları, paneldeki atıf raporları gibi, kendi ayarınızı ya da istediğiniz bir geriye dönük bakış penceresini kullanır.
• Kısaltılmış listeler. Kampanya listeleri en fazla 25 kampanya, reklam tablosu en çok harcama yapan 30 satır, ürün listesi ise en iyi 25 ürünü döndürür.
• Bağlantı başına bir mağaza. Birden fazla mağaza için her biri için bir anahtar ve bir bağlantı oluşturun.
• Ask AI soru sınırı. Her kullanıcı varsayılan olarak günde 40 soru sorabilir; sayım son 24 saat üzerinden yapılır. MCP üzerinden bunun yerine yapay zeka istemcinizin kendi kullanım sınırları geçerlidir.
• Yanıtlar yanlış olabilir. Model bir sonucu yanlış okuyabilir. Harekete geçmeden önce önemli sayıları raporlarda, örneğin kâr analitiğinde kontrol edin.

Kaynaklar

1. Model Context Protocol: What is the Model Context Protocol (MCP)?
2. Model Context Protocol specification (2025-06-18): Tools
3. Claude Code Docs: Connect Claude Code to tools via MCP
4. Claude Docs: Authentication for connectors
5. OpenAI: Building MCP servers for plugins and API integrations

ROASaurus'ta

• Ask AI ve MCP
• Kâr analitiği
• POAS hesaplayıcı

Okumaya devam edin