Cara paling umum untuk melakukan kesalahan ini adalah diam. Anda mengikuti panduan pengaturan, menempelkan blok JSON ke dalam konfigurasi klien Anda, memulai ulang, dan itu berfungsi: daftar alat muncul, koneksi berwarna hijau. Kemudian Anda bertanya seperti apa pesanan kemarin dan tidak mendapatkan apa pun yang berguna, dan tidak jelas mengapa.
Alasannya adalah Shopify mengirimkan dua server MCP yang berbeda, dan yang mudah tidak dapat melihat toko Anda.
Dua pelayan
Shopify membuka sumber AI Toolkit-nya pada bulan April 2026, mengemas tumpukan server MCP resminya, keterampilan agen, dan plugin Claude Code ke dalam satu ruang nama. Di dalam ruang nama itu terdapat dua hal yang secara rutin digabungkan oleh orang-orang.
Pengembang MCP Berjalan secara lokal, tidak memerlukan login, dan memberikan dokumentasi pengembang asisten Shopify dan skema API. Itu dibuat untuk orang-orang yang menulis aplikasi Shopify, dan itu benar-benar bagus dalam pekerjaan itu. Itu tidak akan membaca pesanan kemarin atau mengedit produk, karena secara desain itu tidak pernah menyentuh toko langsung.
Admin MCP Adalah salah satu yang bekerja melawan data toko nyata, dan membutuhkan token API Admin. Token itu adalah seluruh perbedaan, dan itu juga seluruh biaya pengaturan.
Jika Anda membangun di Shopify, instal Dev MCP dan berhenti membaca. Ini gratis, resmi, dan artikel ini tidak mencoba untuk menggantikannya. Jika Anda menjalankan toko dan ingin mengajukan pertanyaan tentang hal itu, Anda memerlukan yang lain.
Apa yang sebenarnya diminta oleh rute Admin dari Anda
Anda membuat aplikasi khusus di dalam admin toko Anda sendiri, memberikan cakupan akses API Admin yang dibutuhkannya, dan memegang token yang dihasilkan. Itu adalah tiga keputusan yang cenderung dibuat orang dengan buruk.
Yang pertama adalah luasnya ruang lingkup. Berikan terlalu sedikit dan kegagalan datang kemudian, pada waktu panggilan, sebagai kesalahan otorisasi di dalam respons obrolan yang sulit dibaca. Berikan semuanya dan Anda telah membuat token yang dapat menulis ulang katalog Anda, duduk di file konfigurasi di laptop.
Yang kedua adalah di mana token hidup. Token teks biasa dalam konfigurasi JSON adalah standar yang ditunjukkan oleh sebagian besar panduan, karena ini adalah instruksi terpendek untuk ditulis. Itu bukan yang akan Anda pilih untuk kredensial yang dapat menerbitkan produk.
Yang ketiga adalah rotasi. Token hidup lebih lama dari alasan Anda membuatnya. Tidak ada dalam pengaturan yang mengingatkan Anda.
Membaca dan menulis bukanlah risiko yang sama
Menanyakan SKU mana yang terjual habis minggu lalu adalah bacaan. Itu murah, dapat dibalik, dan jika jawabannya salah Anda perhatikan dan lanjutkan.
Mengubah harga, mengedit deskripsi produk, menerbitkan ke saluran penjualan. Semua ini berjalan melawan etalase langsung tempat pelanggan berbelanja saat ini. Protokol tidak memiliki pendapat tentang perbedaan itu. MCP menjelaskan sebuah alat dan argumennya; itu tidak membawa gagasan "yang ini tidak dapat diubah."
Yang berarti gerbang harus tinggal di klien. Jika klien Anda menjalankan panggilan alat segera setelah model mengeluarkannya, maka satu-satunya hal yang berdiri di antara instruksi yang salah dibaca dan katalog yang diberi harga ulang adalah model memiliki hari yang baik. Itu bukan profil risiko yang dipilih siapa pun dengan sengaja; itu adalah salah satu yang diwarisi orang dari panduan pengaturan.
Bentuk yang sama, di setiap platform lainnya
eBay, Etsy, dan WooCommerce semuanya memiliki server MCP komunitas sekarang, dan ceritanya berulang hampir persis: token atau pasangan kunci yang Anda hasilkan sendiri, keputusan ruang lingkup, proses lokal untuk terus berjalan, dan klien yang harus dipercaya dengan tulisan. Seorang penjual di empat platform yang mengambil rute ini akhirnya mengoperasikan empat layanan kecil dan memegang empat kredensial, yang merupakan pekerjaan nyata yang tidak ada yang dimasukkan ke dalam peta jalan.
Di mana Orkas duduk di sini
Orkas adalah klien MCP, jadi setiap server yang dijelaskan di atas bekerja dengan cara yang sama dengan klien lain. Ini juga mengirimkan konektor Admin Shopify sendiri, yang dibangun di atas aplikasi Dasbor Dev milik pedagang, dan dua detail adalah intinya.
Cakupan divalidasi saat Anda terhubung, bukan saat panggilan gagal. Orkas memeriksa setiap cakupan yang diperlukan: produk, pesanan, pelanggan, inventaris, lokasi, draf pesanan, pengembalian, diskon, publikasi, dan cakupan pesanan pemenuhan yang berlaku. Ini memberi tahu Anda mana yang hilang sebelum Anda menghabiskan percakapan untuk mencari tahu. Kredensial dienkripsi di perangkat Anda sendiri daripada duduk di file konfigurasi.
Dan gerbang tulis ada di klien, bukan di prompt. Apa pun yang menulis, menghapus, menghabiskan, atau menyentuh toko langsung melewati permintaan izin, dengan tindakan ireversibel yang terpisah dari tindakan rutin. Katalog yang sama Mencakup eBay, Etsy, Walmart Marketplace, WooCommerce dan Amazon Seller Central, ditambah platform Cina, sehingga masalah empat layanan tidak muncul kembali sekali per etalase.
Apa yang tidak tercakup dalam hal ini
Semua ini tidak membuat Orkas menjadi sistem manajemen toko. Itu tidak menyimpan inventaris, rute pesanan atau harga ulang untuk Anda; jika itu yang Anda butuhkan, simpan ERP. Yang digantikannya adalah tumpukan integrasi kecil yang akan Anda kumpulkan untuk mengajukan pertanyaan tentang toko Anda sendiri dan bertindak berdasarkan jawabannya. Untuk bagian akting, itu juga menggantikan asumsi bahwa model yang memiliki hari yang baik adalah perlindungan yang memadai.