Shopify artık AI ajanlarının alıcıyı checkout'tan geçirmesini sağlayan iki farklı mekanizmayı destekliyor: UCP /buy permalink'i (bir ajanın oluşturduğu veya tarayıcıya teslim ettiği durumsuz bir URL) ve Shop MCP'yi (bir ajanın bağlandığı ve araç olarak çağırdığı barındırılan sunucu). Her ikisi de Universal Commerce Protocol (UCP) üzerine kurulu, ancak farklı ajan mimarilerine hedef alıyor. İnşa etmeden önce ayrımı doğru almak çok geri dönüşü tasarrufu sağlar.
Temel çıkarımlar
- UCP /buy permalink, 28 Ekim 2026'de /cart yerine geçerek UCP 2026-08-25 sürümünün parçası olarak gönderildi.
- Shop MCP, 13 Ekim 2026'de
https://mcp.shop.com/adresinde başlatıldı ve arama, sepet, checkout ve sipariş takibi kapsamında 17 araç sunuyor. - WebMCP checkout araçları (
get_checkout,update_checkout,complete_checkout) 28 Eylül 2026'de gönderildi ve alıcının kendi sekmesinde çalışan tarayıcı tabanlı ajanları kapsıyor. - Eski /cart permalink formatı hala çalışıyor ancak artık eski, yeni yetenekler sadece /buy'a gönderilecek.
- Shop MCP'den katalog, sepet ve checkout belgeleri
ucp.versioniçinde UCP 2026-08-25 sürümünü bildiriyor.
UCP gerçekten ne (60 saniyelik versiyon)
Universal Commerce Protocol, Shopify ve Google tarafından ortaklaşa geliştirilen açık bir standarttır ve 11 Ocak 2026'de Google CEO'su Sundar Pichai tarafından NRF konuşmasında duyuruldu. Bu Shopify'ye özgü değildir: herhangi bir e-ticaret platformu bunu benimseyebilir. REST, MCP, Agent Payments Protocol (AP2) veya Agent2Agent (A2A) üzerinden çalışır.
Her Shopify vitrin artık UCP yeteneklerini /.well-known/ucp adresinde ilan ediyor. Bu keşif profili, uyumlu herhangi bir ajan için giriş noktasıdır. 4 Eylül 2026'de Shopify her vitrini UCP 2026-08-25'e taşıdı; mevcut entegrasyonlar herhangi bir değişiklik gerektirmedi çünkü ilan edilen yetenekler kümesi küçülmedi.
Eski Storefront MCP katalog ve sepet araçları (/api/mcp adresinde) 31 Ağustos 2026'den sonra emekli edildi. Aktif uç nokta şimdi /api/ucp/mcp.
UCP /buy permalink'leri: mekanik ve format
28 Ekim 2026 tarihli değişiklik günlüğü girdisi bir kere yer işareti koyacak. Yeni /buy rotasında dev.ucp.shopping.permalink yeteneğini tanıttı, UCP 2026-08-25 ile gönderildi.
Bir /buy permalink'i tek bir GET isteğinde üç şey yapar: sepet oluşturur, isteğe bağlı olarak alıcı verilerini önceden doldurur ve alıcıyı doğrudan checkout'a gönderir. Format şu şekildedir:
https://{shop}.example.com/buy/{variantToken}:{qty},{variantToken2}:{qty2}?buyer/email=...&discounts/codes/0=SUMMER
Sorgu parametresi adlandırma kuralına dikkat edin: eski /cart formatının kullandığı düz anahtarlar (checkout[email], discount) yerine UCP alan yollarını (buyer/email, discounts/codes/0) kullanır. Bu değişiklik kasten yapılmıştır ve kör bir şekilde geçiş yaptığınızda değişiklikleri bozan bir sorundur.
URL'yi doğru şekilde oluşturma
/buy yolunu sabit kodlamayın. Doğru yaklaşım:
- Mağazanın UCP keşif profilini
/.well-known/ucpadresinden alın. dev.ucp.shopping.permalinkyeteneği girişini bulun.config.endpoint'i o girişten okuyun. Bu değer temel URL'nizdir.- Her satır öğesi için
/{token}:{qty}çiftlerini ekleyin. - Alıcı ayrıntıları, ülke, dil ve indirim kodları için UCP alan yolu sorgu parametreleri ekleyin.
GET https://store.example.com/.well-known/ucp
// Response excerpt:
"dev.ucp.shopping.permalink": [{
"spec": "https://ucp.dev/2026-08-25/specification/permalink/",
"endpoint": "https://store.example.com/buy"
}]
// Built URL:
https://store.example.com/buy/70881412:1?buyer/email=ada%40example.com&discounts/codes/0=LAUNCH10
Bağlantının gelecekteki UCP sürümü kütlemeleri arasında stabil kalmasını istiyorsanız (Shopify zamanla varsayılan sürümünü taşıyacak), açıkça sabitleyin:
?ucp/version=2026-08-25&buyer/email=ada%40example.com
/buy'ın henüz desteklemediği şeyler
Bu, eski /cart bağlantılarının özellik eşitliğine sahip değiştirmeler oluşturan insanları ısıran kısımdır:
- Satış planları (abonelikler)
- Satır öğesi özellikleri
- Sepet notları
- Sepet öznitelikleri
Akışınız bunlardan herhangi birine bağlıysa şimdilik /cart'ta kalın. Eski format destekleniyordur; Shopify bunu sadece yeni özelliklerle değil.
UTM parametreleri hakkında bir not
Shopify UCP alanları olmayan sorgu parametrelerini sessizce görmezden gelir. Buna utm_source, gclid ve benzer izleme parametreleri dahildir; UCP attribution/ önekini kullanmadığınız sürece. /buy bağlantılarında atıf izlemesi sorgu dizesini yeniden yapılandırmayı gerektirir. Canlıya almadan önce test etmeye değer.
Headless mağazalar (Hydrogen)
Bir Hydrogen vitrin çalıştırıyorsanız özel bir sorun var: /buy/{items} yolu varsayılan olarak Hydrogen'da teslim rotası olarak bağlı değildir, bu yüzden uygulamaya yapılan bağlantı SPA'nız tarafından uygulamanızın 404'üne yönlendirilir. Hydrogen takımı /buy/{items} için GET-sadece teslim edici'yi ekleyen PR #4048 adresinde bir düzeltme gönderdi, mevcut /cart/{items} işleyicisini yansıtıyor. /buy bağlantıları oluşturmaya başlamadan önce Hydrogen sürümünüzün bu değişikliği içerdiğinden emin olun.
Üç ajan mimarisi ve her birine hangi mekanizm uyuyor
| Ajan mimarisi | Önerilen mekanizm | Neden |
|---|---|---|
| Üçüncü taraf sunucuda ajan (sunucu-sunucu) | Shop MCP veya Checkout MCP | Tam araç erişimi; tarayıcı gerekmez |
| Alıcının tarayıcı sekmesinde çalışan ajan | WebMCP checkout araçları | Canlı checkout DOM'ı okur ve değiştirir, kazımadan |
| Tarayıcı URL'sine teslim eden ajan | UCP /buy permalink | Durumsuz; oturum gerekli değil; herhangi bir UCP mağazada çalışır |
| Eski satış kanalı veya e-posta bağlantısı | /cart permalink (eski) | Hala desteklenir; /buy özellikleri henüz gerekli olmadığı yerde kullanın |
Shop MCP: sunucu tarafı ajanları için barındırılan sunucu
Shop MCP 13 Ekim 2026'de https://mcp.shop.com/ adresinde başlatıldı. Herhangi bir MCP uyumlu ajan veya istemciye bu URL'ye işaret edin ve dört işlevsel gruba düzenlenmiş 17 araca erişim sağlar: arama ve ürün ayrıntıları, sepetler ve checkout, hesap ve siparişler ve Shopify'de olmayan mağazalarda ödeme yapmak için beş "harcama isteği" aracı.
Not: sunucu kök https://mcp.shop.com/ adresinde yaşıyor; /mcp yolu 404 döndürüyor. Bu, varsayılan olarak /mcp ekleyen insanları yakalar.
Shop MCP MCP protokol 2026-07-28 sürümünü kullanır. Katalog, sepet ve checkout belgeleri UCP 2026-08-25'i takip eder.
Anahtar araçlar ve anlamları
search_products- temel katalog araması için 1 milyardan fazla ürünün tamamında API anahtarı gerekmez.get_product- seçenekler ve fiyatlar da dahil olmak üzere varyant düzeyinde ayrıntı döndürür.create_cart- tek bir satıcıya kapsamlı bir sepet oluşturur.create_checkout/get_checkout- bir checkout oturumunu hazırlar ve okur.complete_checkout- alıcı açıkça onay verildikten sonra ödemeyi gönderir. Belgeler ajanları hiçbir zaman varsayılan bir ödeme yöntemi seçmemeye açıkça talimat verir.
Belirtmeye değer olan mimari bir kısıtlama: her checkout tek bir satıcıya aittir. Bir alıcının ajanı çok satıcılı bir sepet montajı yaparsa, bu birden çok ayrı checkout haline gelir. Shop MCP aracılığıyla birleşik çok satıcılı sepet yoktur.
Başlangıçta başka bir kısıtlama: webhook yok. Checkout tamamlandığında bilmek istiyorsanız get_checkout'u yoklarsınız. Bu, tamamlanmaya tepki vermesi gereken bir ajan oluşturuyorsanız önemlidir (örneğin, bir sadakat puanı ödülü tetiklemek veya özel bir yerine getirme eylemi için).
Checkout akışı oturum açma durumuna göre
Davranış, alıcının Shop'a oturum açıp açmadığına bağlı olarak farklılık gösterir:
- Oturumu kapalı: ajan sepet kurar, checkout oluşturur, ardından alıcıyı satıcının teslimat ve ödeme ayrıntılarını girmesi için checkout sayfasına yönlendirir.
- Shop ile oturum açtı: kaydedilen adresler teslimatı otomatik olarak doldurur; satıcı Shop Pay'i sunabilir. Ajan
complete_checkout'u sadece alıcı toplam tutarı onayladıktan ve bir ödeme aracı seçtikten sonra çağırır.
Claude ve ChatGPT gibi MCP istemcileri, cihaz akışını kullanarak Shop oturum açma akışını sizin için işletir. Kendi ajan arka ucunuzu oluşturuyorsanız, cihaz akışını kendiniz uygularsınız.
Ajanı bağlama
# Shop CLI'yi yükleyin
npm install -g @shopify/shop
# Herhangi bir kod yazmadan önce terminalde katalog aramasını test edin
shop search "waterproof trail running shoes size 10"
# Veya MCP sunucusunu ajan yapılandırmanıza ekleyin:
# Server URL: https://mcp.shop.com
# Skill description: https://mcp.shop.com/skill.md
/skill.md adresindeki beceri açıklaması, araç açıklamalarının tek başına bıraktıklarını doldurur: create_checkout ile karşı sadece create_cart'ı ne zaman çağıracağınız, belirsiz bir yazışlmadan sonra ne yapacağınız ve bir satıcı alıcı incelemesi gerektirdiğinde complete_checkout yükseltme akışını nasıl işleyeceğiniz.
WebMCP checkout: üçüncü yol
Shop MCP sunucu-sunucu. WebMCP tarayıcı içi karşılığıdır. 28 Eylül 2026'de Shopify'nin personel PM'si Gil Greenberg, zaten vitrinleri ve sepetleri kapsayan bir yeteneği genişleterek checkout için WebMCP desteğini duyurdu.
Üç yeni araç:
get_checkout- tarayıcı tabanlı bir ajanın HTML'yi okumadan veya kazımadan geçerli checkout durumunu incelemesini sağlar.update_checkout- ajanın teslimat adresi veya nakliye seçeneği gibi alanları değiştirmesini sağlar.complete_checkout- alıcı yetkilendirmesinden sonra siparişi gönderir.
Bu önemlidir çünkü checkout durumsaldır: adresi değiştirmek mevcut nakliye seçeneklerini değiştirir, bu da toplamı değiştirir. Ekran kazıması bu zinciri kırar. WebMCP araçları işlenen DOM değil, checkout'un yapılandırılmış durumunda çalışır.
Hiçbir satıcı yapılandırması gerekmez. Araçlar mevcut checkout'u kullanarak aynı durum ve doğrulama katmanını çalıştırır, bu nedenle Checkout UI uzantılarınız ve İşlevleriniz normal olarak çalışmaya devam eder.
Agentic Storefronts ile Shop MCP karşılaştırması: aynı şey değil
Bu ayrım birçok geliştiriciyi yanıltır ve UCP-08 geliştirici olmayan değişiklikler gönderi protokol düzeyi etkilerin bazılarını kapsar. Kanal düzeyinde:
| Özellik | Agentic Storefronts | Shop MCP |
|---|---|---|
| Erişim modeli | Adlandırılmış AI kanalı (ChatGPT, Copilot, Gemini, Meta Muse) | Herhangi bir MCP uyumlu ajan, iş ortaklığı yok |
| Satıcı kontrolü | Shopify yönetiminde kanal başına aç/kapat | Kasım 2026 itibariyle belgelenmiş satıcı başına opt-out yoktur |
| Checkout konumu | Kanala göre değişir; bazıları doğru, bazıları mağazaya teslim eder | Oturum açmış Shop kullanıcıları için alanda; aksi halde mağaza checkout'u |
| Gerekli kurulum | Satış kanalları altında kanalları aç/kapat > Agentic | Hiç; Shopify satıcıları için otomatik olarak çalışır |
Shop MCP için satıcı ücret ve opt-out ayrıntıları bu yazının yazımı sırasında yayınlanmamıştır.
Göndermeden önce doğrulanacak şeyler
- Keşif profilini kontrol edin:
curl https://your-store.myshopify.com/.well-known/ucp | jq '.'vedev.ucp.shopping.permalink'in göründüğünü veconfig.endpoint'in/buygösterildiğini doğrulayın. - /buy'ı gizli oturumdayla test edin geliştirme oturumlarınızdan sepet durumu kontaminasyonundan kaçınmak için.
- UTM izlemesi: atıf parametrelerinin yalnızca URL incelemesi değil, analitik aracınızın gerçek zamanlı görünümünü kullanarak yönlendirmeyi hayatta kalıp kalmadığını doğrulayın.
- Hydrogen teslimi: Hydrogen yönlendirici sürümünüzün
/buy/{items}teslim edici interceptorını içerdiğini doğrulayın veya manuel olarak ekleyin. - Shop MCP yoklaması: barındırılan MCP sunucusuna karşı oluşturuyorsanız, başından itibaren
get_checkoutiçin bir yoklama döngüsü oluşturun; başlangıçta geri dönülecek webhook yoktur. - Satış planı bağlantıları: ürünlerinizin herhangi birinde abonelik varyantları varsa, /buy henüz bunları kodlayamaz. Yeteneği iniş yapana kadar bu bağlantıları /cart'ta tutun.
Altyapı Eylül ve Ekim 2026 arasında hızla hareket etti. Keşif profili /well-known/ucp, herhangi bir mağazanın herhangi bir gün gerçekten desteklediğinin tek kaynağıdır. Derleme zamanında değil, çalışma zamanında okuyun.
Ekibinde Shopify geliştiricisi olmayan markalar bu işi Shopify mühendislik stüdyom Lintel'e getirebilir: Shopify için üretken arama motoru optimizasyonu (GEO).
Sıkça sorulan sorular
Shopify /buy permalink'i ile /cart permalink'i arasındaki fark nedir?
/buy permalink UCP dev.ucp.shopping.permalink yeteneğini uygular ve buyer/email ve discounts/codes/0 gibi UCP alan yolu sorgu parametrelerini kullanır. /cart permalink, checkout[email] ve discount gibi düz sorgu parametreleri kullanan eski formattır. Shopify hala /cart permalink'lerini destekler ancak onlara yeni yetenekler eklemez; tüm gelecek özellikler /buy'a gider.
Shop MCP bir API anahtarı gerektirir mi?
Hayır. Shop MCP aracılığıyla temel katalog araması herhangi bir kimlik bilgisi olmadan çalışır. Sepet oluşturma, checkout ve hesap araçları, ajan kaydedilmiş adres veya Shop Pay'e erişime ihtiyaç duyduğunda Shop oturum açmasını gerektirir, ancak sepet ve checkout oluşturma oturum açma olmadan da çalışır ve alıcı bu durumda satıcının checkout sayfasında öder.
WebMCP tarayıcı ajanı alıcı hiçbir şey yapmasın diye checkout'u otomatik olarak tamamlayabilir mi?
Hayır. complete_checkout WebMCP aracı, alıcı açıkça onay verdikten sonra siparişi gönderir. Ajan checkout'u inceleyebilir ve güncelleyebilir, ancak ödeme gönderimi alıcı onayı gerektirir. Bu hem WebMCP hem de Shop MCP complete_checkout aracına uygulanır.