Shopify Dev MCP nedir? Kurulum, mağazana erişip erişmediği ve telemetri
Shopify için kod yazarken asistanına bir API'yi ya da Liquid etiketini sorarsın; Shopify Dev MCP geliştirici belgelerini ve API şemalarını aratır, GraphQL, Liquid, tema ve arayüz eklentisi kodunu şema karşısında doğrular. Shopify'ın resmî MCP sunucusu; mağaza verini okuyup yazan bir araç değildir, hesaba bağlanmaz ve kimlik doğrulama istemez, bilgisayarında yerel çalışır (Node.js 18+). Paket ücretsiz (ISC lisansı). Dikkat: yayımlanan sürümler varsayılan olarak kullanım olaylarını shopify.dev adresine gönderir; bu olaylar araç girdilerini ve sonuçlarını içerebilir ve kapatılabilir.
- Ne yapar
- Asistana Shopify belgelerini aratır, kodu şemaya göre doğrulatır
- Tür
- MCP sunucusu (yerel, stdio)
- Yapımcı
- Shopify
- Mağaza erişimi
- Yok, hesaba bağlanmaz
- Telemetri
- Varsayılan açık, kapatılabilir
- Kaynak kod
- Herkese açık depo yok
- Ücret
- Ücretsiz, ISC
Shopify Dev MCP ne işe yarar?
MCP, yapay zekâ programlarının dış araçlara bağlanma standardıdır. Shopify Dev MCP kod yazan asistanı Shopify konusunda doğru bilgiyle besler: geliştirici belgelerini ve API şemalarını arar, asistanın yazdığı GraphQL, Liquid ya da arayüz kodunu şemaya karşı doğrular, tema doğrulamada senin verdiğin yerel tema klasöründeki dosyaları okur.
Mağazana bağlanmaz; kullanım olayları varsayılan olarak shopify.dev'e gider, kapatılabilir.
!Bu araç mağazanı yönetmez. Shopify, mağaza yönetimini (CLI'nin store execute özelliği) ayrı bir "AI Toolkit eklentisi" olarak sunuyor; Dev MCP paketinde mağaza aracı yok. İkisini karıştırma: bu sayfa yalnız Dev MCP paketini anlatıyor.
Resmî araç listesi yayımlanmamış; paket kodundan beş araç çıkarıldı: learn_shopify_api, search_docs_chunks, validate, validate_theme ve feedback. Bu, resmî belge değil kod gözlemidir.
Kime yarar: Shopify uygulaması, tema ya da eklentisi geliştiren ve asistanın eskimiş ya da uydurma API bilgisi vermesinden şikâyet eden geliştiricilere.
Shopify Dev MCP nasıl kurulur?
Gereken: Node.js 18 veya üstü. Hesap ya da mağaza gerekmez. Komutlar Shopify'ın AI Toolkit belgesinden aynen alındı; hepsi @latest kullanıyor.
› claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latestSonra Claude Code'u yeniden başlat.
~/.codex/config.toml dosyasına ekle: [mcp_servers.shopify-dev-mcp], altına command = "npx" ve args = ["-y", "@shopify/dev-mcp@latest"]. Codex'i yeniden başlat.
Cursor Settings sonra Tools and MCP › New MCP server ile {"mcpServers":{"shopify-dev-mcp":{"command":"npx","args":["-y","@shopify/dev-mcp@latest"]}}} ekle.
Windows'ta bağlantı hatası olursa komutu cmd ve argümanları ["/k","npx","-y","@shopify/dev-mcp@latest"] olarak yaz (Shopify belgesi).
VS Code'da Komut Paleti › MCP: Open User Configuration ile kullanıcı mcp.json dosyasına servers altında aynı komutu ekle. Antigravity CLI için ~/.gemini/config/mcp_config.json dosyasına mcpServers girdisi eklenir.
Shopify çoğu istemci için MCP yerine AI Toolkit eklentisini öneriyor; Dev MCP "MCP tercih edersen" seçeneği olarak geçiyor. Sürüm sabitlemek için komutta @1.16.1 yazabilirsin; Shopify bunu önermiyor.
Shopify Dev MCP nasıl kullanılır?
Kurulumdan sonra isteği normal yazarsın; asistan Shopify sorusu görünce belge aramasını kullanır.
Shopify Dev MCP nerede çalışır?
| Claude CodeVar | Tek komut. |
|---|---|
| Codex CLIVar | config.toml. |
| Antigravity CLIVar | Resmî belgede var. |
| Cursor, VS CodeVar | Yapılandırma dosyasıyla. |
| Claude.ai web, ChatGPTYok | Sunucu yerel (stdio) çalışır; belgede uzak bağlayıcı yok. |
Shopify Dev MCP neye erişir, hangi veriyi gönderir?
Shopify geliştirici belgeleri ve API şemaları; asistanın doğrulamak için verdiği kod; tema doğrulamada verdiğin yerel tema klasöründeki dosyalar.
Mağazana hiçbir şey yazmaz, mağazaya bağlanmaz. Dışarıya yalnız kullanım olayı gönderir (aşağıdaki Veri).
Silme aracı yok.
Resmî README: yayımlanan sürümler kullanım olaylarını shopify.dev/mcp/usage adresine gönderir; olaylar araç girdilerini ve sonuçlarını, API ve paket sürümünü, rastgele bir konuşma kimliğini ve istemcinin verdiği istemci/model tanımlayıcılarını içerebilir. Kaynaktan çalıştırılan sürümler göndermez.
!Telemetriyi kapatmak için ortamda OPT_OUT_INSTRUMENTATION=true ya da DO_NOT_TRACK=1 ayarla. Bazı istemciler ortam değişkenini alt süreçlere aktarmaz; Shopify bu durumda boş bir opt-out dosyası oluşturmanı öneriyor (macOS/Linux: ~/.config/shopify-ai-toolkit/opt-out, Windows: %APPDATA%\shopify-ai-toolkit\opt-out) ve dosya yönteminin her yerde çalıştığını yazıyor.
Paket kodundan gözlem (resmî README'de yazmıyor): aracın açıklaması modelden kullanıcının son mesajını (en çok 2000 karakter) kullanım olayına eklemesini istiyor, belge araması sorgu metni shopify.dev'e gidiyor ve feedback aracı tur sonunda bir değerlendirme olayı gönderiyor. Verinin saklanma süresi, amacı ve model eğitimi için yazılı açıklama görünmüyor.
Kaynak kod herkese açık bir depoda değil (Shopify/dev-mcp depo adresi 404; npm kaydında repository alanı yok). Paketin yayımlanmış dosyaları incelendi. GitHub Güvenlik Danışmanlıkları boş; kayıtlı uyarı görünmüyor. Bu "güvenli" demek değildir.
Shopify Dev MCP ücretsiz mi?
Paket ücretsiz (ISC lisansı); çalıştırmak için Shopify hesabı, mağaza ya da anahtar gerekmiyor. Shopify geliştiricisi olmak için Partners hesabı gibi ihtiyaçlar bu aracın dışında. Kullandığın ajan aracının kendi planı ayrı. TL fiyatı yok.
Sık sorunlar ve çözümleri
| Ne oluyor | Ne yapmalı |
|---|---|
| Cursor Windows'ta bağlantı hatası veriyor | cmd /k ile alternatif yapılandırmayı kullan (Shopify belgesi). |
| Telemetri ayarı etki etmiyor | Ortam değişkeni MCP sürecine ulaşmıyor olabilir; boş opt-out dosyasını oluştur. |
| Her açılışta sürüm değişiyor | Belgedeki komut @latest kullanıyor; sabitlemek için @1.16.1 gibi bir sürüm yaz. |
Shopify Dev MCP nasıl kaldırılır?
- İstemcide: MCP yapılandırmasından shopify-dev-mcp girdisini sil ve istemciyi yeniden başlat.
- Claude Code:
claude mcp remove shopify-dev-mcp(Claude Code'un genel komutu; Shopify belgesinde yazmıyor). - Telemetri: Telemetriyi kapatmak yazılımı kaldırmak değildir; opt-out ayrıca yapılır.
Hesaba bağlı olmadığı için iptal edilecek bir yetki yok.
Sık sorulan sorular
Shopify Dev MCP mağaza verime erişir mi?
Hayır. Hesaba bağlanmaz ve mağaza verini okuyup yazmaz; Shopify belgelerini ve API şemalarını arar, kodu doğrular. Mağaza yönetimi Shopify'ın ayrı AI Toolkit eklentisinin yeteneğidir.
Kimlik doğrulama gerekir mi?
Hayır. Yerelde stdio ile çalışır ve Node.js 18 veya üstü gerekir; hesap, mağaza ya da anahtar istemez.
Telemetri var mı, nasıl kapatılır?
Evet: yayımlanan sürümler varsayılan olarak kullanım olaylarını shopify.dev adresine gönderir ve olaylar araç girdilerini ve sonuçlarını içerebilir. OPT_OUT_INSTRUMENTATION=true, DO_NOT_TRACK=1 ya da boş bir opt-out dosyasıyla kapatılır.
Ücretsiz mi, lisansı ne?
Paket ücretsiz ve ISC lisanslı. Kaynak kodu herkese açık bir depoda değil.
Hangi araçları var?
Resmî liste yok; paket kodundan beş araç çıkarıldı: learn_shopify_api, search_docs_chunks, validate, validate_theme ve feedback. Bu bir kod gözlemidir.
Atlas kartındaki sürümle fark var mı?
Katalog 1.16.0 diyor, npm latest etiketi 1.16.1 (14 Ekim 2026). Belgedeki komut @latest kullandığı için her çalıştırmada en son sürüm gelir.
İlgili rehberler
Kaynaklar
Resmî kaynaklarda net olmayanlar: Resmî araç listesi (yok) · telemetrinin saklama süresi, amacı ve model eğitimi için kullanılıp kullanılmadığı · doğrulamanın tamamen yerelde yapıldığına dair açık cümle · kaynak koda erişim (depo herkese açık değil) · Türkçe ve TL bilgisi. Her biri ilgili bölümde yazılı.