Shopify MCP 2026: Tüm Resmi Sunucular, Kurulum ve Kendi Sunucunuzu Ne Zaman Kurmalısınız

Kısa cevap. "Shopify MCP" tek bir ürün değil. Kasım 2026 itibarıyla Shopify birkaç Model Context Protocol sunucusu çalıştırıyor: her mağazada /api/ucp/mcp adresinde alıcı tarafı sunucular (katalog, sepet, mağaza soruları), kimlik doğrulama isteyen Checkout ve Order sunucuları, Shopify Catalog genelinde arama ve satın alma için Shop MCP, bir Customer Accounts sunucusu, geliştiriciler için Dev MCP sunucusu ve alışverişçinin tarayıcısında çalışan WebMCP araçları. /api/mcp adresindeki eski Storefront MCP katalog ve sepet araçları kaldırıldı. Bunların hiçbiri sizin yerinize mağazanızın arka ofisini yönetmez: bunun için Shopify'ın AI Toolkit'ini kullanırsınız ya da kendi Admin API sunucunuzu kurarsınız; biz bir müşterimiz için kurduk.

2026'da ne değişti

2026'ya kadar "Shopify MCP" rehberlerinin çoğu tek bir adresi anlatıyordu: her mağaza https://{shop}/api/mcp adresinde katalogda arama ve sepet yönetimi araçlarıyla cevap veriyordu. Shopify o günden bu yana alıcı tarafındaki agent'ları, Google ile birlikte geliştirdiği açık bir standart olan Universal Commerce Protocol'e (UCP) taşıdı. Kullanımdan kaldırma duyurusu eski sepet araçlarını 31 Ağustos 2026'ya kadar korudu; geçiş sayfası artık /api/mcp üzerindeki katalog ve sepet araçlarının kaldırıldığını söylüyor.

Shopify'a göre kodda üç şey değişiyor: /api/ucp/mcp'ye giden her istek bir agent profile taşıyor; update_cart artık sepetin tamamını değiştiriyor, yani her seferinde bütün satırları gönderiyorsunuz; ve her Checkout MCP isteği kimliği doğrulanmış ya da imzalı olmak zorunda. Customer Accounts MCP sunucusu değişmedi.

Tüm resmi Shopify MCP sunucuları tek tabloda

İki ayrıntı tablonun gösterdiğinden daha önemli. Shopify'ın en katı olduğu yer ödeme: Shop MCP'de agent satın almayı yalnızca "alışverişçi toplam tutarı ve ödeme yöntemini onayladıktan sonra" tamamlıyor; ilk aşamada webhook olmadığı için agent checkout durumunu sorgulayarak takip ediyor. Ask MCP ise bilerek salt okunur: "sepetleri değiştirmez, sipariş vermez ve iade başlatmaz".

Hangi Shopify MCP'ye ihtiyacınız var?

"Shopify MCP" aramalarının çoğu beş hedeften birinden geliyor. Her birinin cevabı farklı ve ikisi hiç MCP işi gerektirmiyor.

İlk hedef için yapılacak iş kod değil, ürün verisi: bir asistanın okuyup karşılaştırabileceği başlıklar, varyantlar, özellikler ve kurallar. Bunu agentic commerce yazımızda anlatıyoruz. MCP sunucusunun ne olduğu ve neyin açılması gerektiğinin sade bir açıklaması için MCP nedir yazımıza bakın.

Agentic Storefronts ve Shopify Catalog: satıcı neyi kontrol eder

Agentic storefronts, Shopify yönetim panelindeki bir satış kanalı ve "uygun mağazalarda varsayılan olarak açık". Ürünlerinizi Shopify Catalog üzerinden ChatGPT, Google AI Mode ve Gemini, Microsoft Copilot ve Meta'ya taşıyor (Google ayrıca Google & YouTube kanalını ya da Merchant Center'ı okuyor). Ödeme kanala göre değişiyor: ChatGPT alıcıyı uygulama içi tarayıcıda kendi mağazanızın checkout'una gönderiyor; AI Mode, Gemini, Copilot ve Meta ise açarsanız Shopify altyapılı doğrudan checkout kullanabiliyor. Siparişler panelinize hangi kanaldan geldiği bilgisiyle düşüyor.

Entegrasyon sizin yerinize yapıldığı için, bir asistanın ürününüzü önerip önermeyeceğine okuduğu veri karar veriyor. Teknik bir şeye girişmeden önce şunlara bakın:

• Ürünün ne olduğunu söyleyen başlıklar, sadece marka adı ya da kampanya cümlesi değil.
• Gerçek varyantlar: kendi fiyatı, stoku ve seçenek adları olan (beden, renk, malzeme).
• Özellikler alanlarda, örneğin malzeme, ölçü, uyumluluk veya sertifikalar için metafield'lar; sadece görsellerde ya da uzun açıklamalarda değil.
• Kurallar ve bilgi tabanı dolu: iade, kargo süreleri, garanti.
• Yalnızca B2B satılan ürünler işaretli, böylece tüketici kanallarının dışında kalırlar.

Asistanların ürünleri nasıl seçtiği dahil büyük resim agentic commerce yazımızda.

Claude veya ChatGPT'yi kendi mağaza verinize bağlamanın 5 yolu

"Shopify MCP" aramalarının çoğu aslında başka bir şey istiyor: "AI asistanım satışlarımı okusun ve ürünlerimi düzenlesin". Shopify'ın alıcı tarafı sunucuları bunu yapamaz. Şu beş yol yapabilir, ama riskleri çok farklı:

Shopify'ın kendi pratik kuralı: iş mağaza verinizi ya da panel içinde bir işlemi içeriyorsa Sidekick'i, yazma, araştırma ve planlama için genel bir asistanı kullanın. App Store uygulamalarından bazıları bir mağazanın ihtiyaç duyduğu kontrolleri ekliyor: örneğin ShopMCP, her bağlantı için okuma, değiştirme ve silme yetkilerini ayrı ayrı belirliyor ve engellenenler dahil her isteğin denetim kaydını (audit log) tutuyor.

shopify-mcp gibi bir topluluk sunucusunu denerseniz, onun için ayrı bir uygulama oluşturun ve salt okuma yetkileriyle başlayın (read_products, read_orders). write_products'ı yalnızca gerektiren iş için ekleyin; write_customers ve write_orders'ı denemelerden uzak tutun. O projenin README'sine göre, 1 Ocak 2026'dan beri Dev Dashboard'da oluşturulan uygulamalar sabit bir shpat_ access token yerine OAuth client credentials kullanıyor (token'lar yaklaşık 24 saat geçerli); mevcut custom app'ler kendi token'larını kullanmaya devam edebiliyor.

Geliştiriciler için: Dev MCP, Claude Desktop ve ilk UCP isteği

Dev MCP sunucusu kendi bilgisayarınızda çalışır, kimlik doğrulama istemez ve kodlama asistanınıza Shopify'ın güncel dokümanlarını ve API şemalarını verir; böylece asistan GraphQL alanı uydurmayı bırakır. Claude Code'da tek komut yeter (Shopify'ın talimatları Cursor, Codex ve VS Code'u da anlatıyor):

claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest

Claude Desktop veya Cursor'da aynı sunucu MCP yapılandırma dosyasına eklenir (macOS'ta Claude Desktop için: ~/Library/Application Support/Claude/claude_desktop_config.json), ardından uygulamayı yeniden başlatırsınız:

{
  "mcpServers": {
    "shopify-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@shopify/dev-mcp@latest"]
    }
  }
}

Bir alışveriş agent'ı geliştirmek farklıdır: bir mağazanın UCP uç noktasını JSON-RPC ile çağırırsınız ve her istek agent profile'ınızı belirtir. Shopify'ın örneğine göre ilk katalog araması şöyle görünür (https://{shop}/api/ucp/mcp adresine POST):

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "search_catalog",
    "arguments": {
      "meta": { "ucp-agent": { "profile": "https://your-agent.example/ucp-profile.json" } },
      "catalog": {
        "query": "organic coffee beans",
        "context": { "address_country": "US" }
      }
    }
  }
}

Shopify AI Toolkit'in geneli GraphQL, Liquid ve eklentiler için kod doğrulaması ve Shopify CLI üzerinden mağaza yönetimi ekliyor; "ne zaman çalıştırılacağını sizin seçtiğiniz" şekilde.

Kendi Shopify MCP sunucunuzu ne zaman kurmalısınız

Shopify'ın sunucuları alıcılar adına çalışıyor, AI Toolkit ise geliştiricilere göre tasarlanmış. Bir satıcı tekrar eden mağaza işlerini sadece isteyerek yaptırmak istediğinde (bir kataloğu içe aktarmak, bir ürün grubunu yeniden etiketlemek, incelenenleri yayına almak), GraphQL Admin API üzerinde küçük bir MCP sunucusu eksik parçadır. Biz Horeca Papatya için, WooCommerce'ten Shopify'a geçişi sırasında böyle bir sunucu kurduk. Tasarım iki katmanlı:

• Bilgi: Shopify AI Toolkit; asistan hafızasından değil, Shopify'ın gerçek şeması ve dokümanlarından çalışır.
• Eylem: sabit bir araç listesi olan kendi MCP sunucumuz: ürün arama, okuma, oluşturma, güncelleme ve silme, stok ayarlama, yayına alma, arama sorgusuyla toplu güncelleme, düşük stok listesi ve toplu işlemlerle CSV içe aktarma.

Araçlar işin kolay kısmı. Canlı bir mağazada kullanmayı güvenli kılan, etraflarındaki kurallar:

• Yeni ürünler taslaktır. create_product varsayılan olarak DRAFT oluşturur; yayına almak incelemeden sonra ayrı bir adımdır.
• Toplu değişiklikler önce prova edilir. bulk_update_products varsayılan olarak dry run çalışır ve kaç ürünün değişeceğini söyler; gerçek değişiklik için açıkça ikinci bir çağrı gerekir.
• Silme için "evet" gerekir. delete_product confirm: true olmadan çalışmaz ve asistana önce sorması söylenmiştir.
• İçe aktarmalar toplu işlemlerle yapılır, tek tek oluşturma döngüsüyle değil; böylece Shopify'ın istek sınırlarının içinde kalınır.
• Yalnızca GraphQL Admin API, sabitlenmiş bir API sürümüyle; böylece sürüm yükseltmek sürpriz değil, bir karar olur.
• Minimum yetki; token sohbette asla görünmez.

1. İstek
   Günlük dille

   "Bu tedarikçinin bütün ürünlerini coffee-machine olarak etiketle."

2. Prova
   Dry run

   bulk_update_products dryRun açıkken çalışır: eşleşen ürün sayısı gelir, hiçbir şey değişmez.

3. Onay
   Bir insan

   Satıcı sayıyı kontrol eder ve onaylar.

4. Çalıştırma
   Gerçek güncelleme

   Aynı çağrı dryRun kapalıyken; sonuç neyin değiştiğini listeler.

Ders: agent'ın hızı araçlardan, güvenliği varsayılanlardan gelir. Temkinli seçeneği (taslak, prova, onay) prompt'un hatırlamasına güvenmek yerine aracın kendisine koyun. AI agent örnekleri yazımızda anlattığımız kalıp da bu.

Bir agent'ı Shopify'a bağlamadan önce güvenlik kontrol listesi

• Her agent'a kendi kimlik bilgilerini ve ihtiyacı olan en dar yetkileri verin; önce salt okuma.
• Para ve geri alınamayan işlemleri bir insanın onayında tutun: ödemenin tamamlanması, geri ödemeler, silmeler, fiyat değişiklikleri.
• Prova (dry run) yapan ve varsayılan olarak taslak oluşturan araçları tercih edin.
• API sürümünü sabitleyin ve yenisine geçmeden önce test edin.
• Ürün verisini ve müşteri mesajlarını güvenilmeyen girdi olarak görün (prompt injection): agent içlerinde okuduğu talimatlara uymamalı.
• Her araç çağrısının denetim kaydını (audit log) tutun; agent'ın ne yaptığını görüp geri alabilesiniz.

Sorun giderme

• /api/mcp çağrıları başarısız oluyor ya da katalog aracı dönmüyor: o araçlar kaldırıldı. https://{shop}/api/ucp/mcp adresine geçin.
• tools/list beklenenden az araç gösteriyor: araçlar agent profile'ınızın bildirdiği yeteneklere bağlıdır. Ask MCP, dev.ucp.common.ask yeteneğini bildiren bir UCP taslak (draft) profili ister.
• Güncellemeden sonra sepetten ürünler kayboluyor: update_cart sepetin tamamını değiştirir. Her seferinde bütün satırları gönderin.
• Checkout istekleri reddediliyor: Checkout MCP, Dev Dashboard'un Catalog bölümünden alınan client credentials ile kimlik doğrulama ya da imzalı istek ister.
• Shop MCP'den durum güncellemesi gelmiyor: ilk aşamada webhook yok. get_checkout ile sorgulayın.
• Ürünler ChatGPT'de veya Copilot'ta görünmüyor: Sales channels > Agentic ayarını, kanalın Shopify Catalog erişimini, ürün durumunu ve ürünün yalnızca B2B olup olmadığını kontrol edin.

Sık sorulan sorular

• Shopify MCP nedir?+−

  AI agent'ların Shopify ile çalışmasını sağlayan bir Model Context Protocol sunucuları ailesi: katalog, sepet, sorular, ödeme ve siparişler için alıcı tarafı sunucular (UCP üzerine kurulu), Shopify Catalog genelinde Shop MCP, Customer Accounts MCP, geliştiriciler için Dev MCP sunucusu ve tarayıcıda WebMCP araçları.

• Shopify Storefront MCP kullanımdan kaldırıldı mı?+−

  Evet. https://{shop}/api/mcp üzerindeki katalog ve sepet araçları, https://{shop}/api/ucp/mcp adresindeki UCP sunucuları lehine kaldırıldı. Sepet araçları 31 Ağustos 2026'ya kadar korundu. Customer Accounts MCP sunucusu değişmedi.

• Her Shopify mağazasının bir MCP sunucusu var mı?+−

  Shopify, mağazalar için https://{shop}/api/ucp/mcp adresinde UCP uç noktasını sunuyor ve her istekte bir agent profile bulunmak zorunda. Agent'ın hangi araçları göreceği o profildeki yeteneklere bağlı.

• Claude'u veya Cursor'ı Shopify'a nasıl bağlarım?+−

  Geliştirme için Shopify'ın Dev MCP sunucusunu (npx -y @shopify/dev-mcp@latest) ekleyin ya da Shopify AI Toolkit eklentisini kurun. Bir mağazanın canlı verisi için Admin API erişimi olan bir uygulama gerekir: AI Toolkit'in mağaza yönetimi ya da kendi MCP sunucunuz.

• ChatGPT'de satış yapmak için MCP sunucusu gerekir mi?+−

  Hayır. Shopify satıcıları ChatGPT, Google AI Mode, Gemini ve Microsoft Copilot gibi AI kanallarına bağlıyor ve bunları Shopify panelinden yönetiyor. Sizin payınız eksiksiz ve doğru ürün verisi.

• Ürünlerimin ChatGPT'de görünmesini durdurabilir miyim?+−

  Evet, kanal bazında: Sales channels > Agentic altında Allow Shopify to manage for me ayarını kapatın, sonra ChatGPT için Shopify Catalog erişimini kapatın. Tek bir ürünü tüm AI kanallarından gizlemek için durumunu Unlisted yapın. Shopify Catalog'un kendisinden çıkamazsınız ve ürünler sıradan web taramasıyla yine bulunabilir.

• Bir Shopify MCP sunucusunun hangi yetkileri olmalı?+−

  İşi gören en az yetki: önce read_products ve read_orders gibi salt okuma yetkileri, write_products yalnızca gerektiren iş için ve her araç için ayrı bir uygulama; böylece birini diğerlerine dokunmadan iptal edebilirsiniz.

• Bir Shopify MCP sunucusu mağazamı değiştirebilir mi?+−

  Alıcı tarafı sunucular panelinize dokunamaz. Bunu yalnızca Admin API erişimi olan bir sunucu yapabilir: AI Toolkit'in mağaza yönetimi ya da özel bir sunucu. Ona varsayılan olarak taslak, prova ve onay verin.

Kaynaklar

• Shopify: Migrate from Storefront MCP
• Shopify changelog: Storefront MCP cart tools are being deprecated in favour of UCP Cart MCP
• Shopify: Build commerce agents with UCP
• Shopify: Storefront Catalog MCP
• Shopify: Cart MCP
• Shopify: Checkout MCP
• Shopify: Ask MCP
• Shopify: Order MCP
• Shopify changelog: Add shopping and Shop Pay checkout to any agent with Shop MCP
• Shopify: Customer Accounts MCP server
• Shopify: AI Toolkit
• Shopify: WebMCP tools
• Shopify: The agentic commerce platform
• Shopify Help Center: Shopify agentic storefronts
• Shopify Help Center: Managing agentic storefronts
• Shopify Help Center: Shopify Catalog
• Shopify Help Center: Shopify Catalog and product discovery for agentic storefronts
• Shopify: AI ChatGPT guide for Shopify merchants (Sidekick vs ChatGPT)
• GitHub: shopify-mcp (community server)
• Shopify App Store: ShopMCP
• Google: New tech and tools for retailers to succeed in an agentic shopping era

• Shopify
• MCP

Ahmet Molon

Kurucu