Shopify meluncurkan Shop MCP pada 13 Oktober, memberi pengembang satu koneksi terkelola untuk pencarian produk, keranjang, dan checkout. Layanannya tersedia di https://mcp.shop.com/. Ke-17 alatnya dapat menemukan produk di Shopify Catalog dan membuka checkout dengan merchant yang menjual barang. Pencarian katalog tidak memerlukan kunci API. Pembeli tetap harus menyetujui pembelian nyata.

Panduan ini ditujukan bagi pengembang yang menyiapkan asisten kompatibel MCP. Langkah-langkah berikut mengikuti dokumentasi Shopify yang diperiksa pada 14 Oktober. BIG CHANGE tidak menghubungkan agen, membuat keranjang, atau melakukan pembelian. Karena itu, panduan ini menjelaskan hasil yang diharapkan, bukan kinerja yang diamati.

Perubahan utama

  • Apa yang berubah: Shopify kini menawarkan koneksi MCP terkelola yang mencakup pencarian katalog hingga keranjang merchant dan checkout. Shopify juga mendokumentasikan penyelesaian melalui Shop Pay bagi pembeli yang masuk setelah konfirmasi eksplisit.
  • Siapa yang dapat menggunakannya: Pengembang dengan klien MCP yang mendukung versi protokol 2026-07-28, atau kode yang menjalankan panggilan HTTP terdokumentasi. Klien lama yang hanya memakai handshake initialize tidak dapat terhubung langsung.
  • Yang perlu diperiksa: Checkout adalah transaksi dengan satu merchant. completed bersama sebuah order mengonfirmasi pembelian; keranjang, tautan checkout, atau pembayaran yang sedang diproses tidak cukup.

Sebelum menghubungkan

Anda memerlukan klien MCP yang mendukung server HTTP jarak jauh dan metode koneksi terdokumentasi dari Shopify atau aplikasi yang memanggil server melalui HTTP. Gunakan URL akar https://mcp.shop.com/; menambahkan /mcp menghasilkan 404. Alat pencarian dan keranjang berfungsi tanpa akun Shop. Dengan masuk, asisten dapat memakai preferensi dan alamat tersimpan, menemukan pesanan, serta menawarkan Shop Pay bila didukung merchant. Untuk asisten dengan kode HTTP sendiri, Shopify mendokumentasikan alur OAuth perangkat yang disetujui pembeli di situs Shop.

Tentukan kueri produk, negara tujuan, dan mata uang sebelum mencari. Pisahkan persyaratan yang disebut pembeli dari konteks pencarian: negara atau mata uang membantu melokalkan hasil; batas harga, ukuran, atau tujuan pengiriman adalah filter. API menyatakan harga dalam satuan minor mata uang. Aplikasi Anda sebaiknya membaca messages pada respons sebelum menyatakan hasil memenuhi filter, sebab layanan dapat melaporkan bahwa filter tidak diterapkan sesuai permintaan. Panduan pencarian Shopify menjelaskan perbedaan ini dan batas 1–50 hasil per halaman.

Alur terdokumentasi dari pencarian ke pesanan

  1. Hubungkan dan periksa pencarian. Konfigurasikan klien dengan https://mcp.shop.com/ dan muat Shop skill Shopify bila klien mendukungnya. Shopify menyarankan pengujian koneksi dengan permintaan mencari tiga lampu meja tanpa membuat keranjang. Pencarian yang berfungsi mengembalikan produk beserta penjual, harga dalam mata uang yang dinyatakan, dan tautan merchant. Pengembang yang memakai HTTP dapat mengikuti panduan cepat JSON-RPC Shopify, yang memuat header protokol wajib dan permintaan search_catalog. Ini pemeriksaan hanya-baca dan tidak memerlukan masuk.
  2. Pilih barang yang tepat. Jalankan search_catalog dengan kueri dan persyaratan pembeli. Pencarian mengembalikan varian unggulan; gunakan get_product bila pembeli menginginkan ukuran atau warna lain. Bandingkan product.selected dan variant.options yang dikembalikan dengan setiap ukuran, warna, dan pilihan lain yang disebut pembeli sebelum menampilkan atau membelinya. Shopify menyatakan bahwa pilihan dapat dilonggarkan tanpa peringatan. Saat pembeli memilih produk atau mengubah opsi, panggil get_product lagi untuk memeriksa ketersediaan dan harga saat ini. Pertahankan ID varian dan domain penjual persis seperti yang dikembalikan. Jangan menganggap merchant akan mempertahankan harga yang sebelumnya ditampilkan. Tampilkan peringatan di samping produk yang terkait. Pemeriksaan ini didokumentasikan dalam Temukan produk.
  3. Buat keranjang saat diminta. Dengan instruksi pembeli untuk mengumpulkan barang, panggil create_cart untuk merchant dan varian yang dipilih. Keranjang menyimpan barang dan tidak membuat pesanan. Pisahkan barang dari penjual berbeda ke keranjang terpisah: Shopify menyatakan setiap keranjang dan checkout hanya milik satu merchant. Hasilnya sebaiknya memuat ID keranjang dan baris barangnya. Jika pembeli hanya ingin melihat-lihat, berhenti setelah pencarian; panduan keranjang Shopify menyebut minat pada suatu produk saja bukan izin membuat keranjang.
  4. Buka dan tinjau checkout. Saat pembeli meminta harga total atau siap membeli, panggil create_checkout dengan ID keranjang atau ID varian dan domain penjual yang persis dari pencarian. Dokumen checkout seharusnya mengembalikan ID, status, item baris, mata uang, total, metode pembayaran, messages, kebijakan merchant links, dan continue_url untuk halaman merchant. Sebelum melanjutkan, tampilkan total terkini beserta labelnya, termasuk ongkir dan pajak, setiap peringatan, serta tautan kebijakan kepada pembeli. Tempatkan penjelasan di samping barang atau kolom terkait. Berikan continue_url yang tidak diubah, termasuk parameter kuerinya, kepada pembeli bersama barang yang dicakup meskipun agen dapat menyelesaikan checkout. Checkout dapat berstatus incomplete bila memerlukan alamat, atau requires_escalation bila pembeli harus menyelesaikannya di halaman merchant. Shopify menyatakan checkout kedaluwarsa setelah enam jam secara default.
  5. Biarkan pembeli menangani pembayaran. Jika pembeli masuk, checkout dapat menawarkan alamat tersimpan dan Shop Pay. Sebelum memanggil complete_checkout, baca checkout terbaru, pastikan statusnya ready_for_complete, tampilkan merchant, barang, jumlah, total, dan metode yang tersedia, lalu minta pembeli memilih metode pembayaran. Jangan memilih untuk mereka. Tetap sediakan continue_url merchant yang tidak diubah kepada pembeli meskipun agen dapat menyelesaikan checkout; jika instrumen pembayaran tidak tersedia, pembeli harus memakai tautan itu. petunjuk checkout Shopify menyebut complete_checkout dikirim satu kali setelah persetujuan lalu status yang dikembalikan diperiksa. alur persetujuan terpisah untuk toko di luar Shopify meminta pembeli menyetujui pembayaran di Shop dan memberikan kartu untuk checkout toko tersebut; alur ini berbeda dari checkout merchant Shopify pada langkah 3 dan 4.
  6. Verifikasi hasilnya. Hanya status: completed dengan order yang memastikan merchant membuat pesanan. Jika pembayaran masih diproses, gunakan get_checkout untuk membaca status kembali. Shopify menyatakan belum ada webhook saat peluncuran, sehingga integrasi harus melakukan polling get_checkout untuk pembaruan. Jika panggilan penyelesaian mengalami timeout atau responsnya tidak jelas, jangan kirim ulang dan jangan membuka checkout pengganti. Baca checkout yang ada; bila tidak menampilkan kedua status completed dan order, beri tahu pembeli bahwa pembelian belum terkonfirmasi dan berikan continue_url.

Batasan dan pemulihan

Shopify menyatakan pencarian berfungsi tanpa kredensial. catatan peluncurannya mengarahkan pengembang yang membutuhkan batas laju lebih tinggi ke kunci API di Shopify Dev Dashboard, tetapi tidak memberikan harga publik atau tabel batas untuk kunci tersebut. Harga barang merchant, pengiriman, dan pajak berasal dari checkout saat ini; pembeli sebaiknya meninjaunya sebelum membayar. Agen juga dapat memiliki biaya hosting atau model sendiri bila pengembang menggunakannya. Pengumuman itu tidak merinci biaya tersebut.

Pembacaan yang gagal dapat diulang setelah jeda retry_after yang disebutkan. Untuk pembuatan atau pembaruan keranjang dan checkout, panduan kesalahan Shopify menyarankan penggunaan kunci idempotensi dan membaca sumber daya yang ada sebelum mengulang penulisan yang hasilnya tidak pasti. Jika permintaan pembuatan tanpa kunci gagal sebelum mengembalikan ID, hasilnya tidak diketahui; jangan menebak dengan membuat lagi. complete_checkout memiliki aturan lebih ketat: jangan pernah mengulanginya setelah respons yang tidak pasti. Halaman merchant tetap menjadi jalur pembeli bila requires_escalation atau informasi pembayaran yang kurang menghalangi agen menyelesaikan proses.

Perlakukan ID checkout, tautan checkout, token akses, dan instrumen pembayaran sebagai data sensitif. Shopify menyatakan ID checkout dan continue_url berisi kunci akses, jadi jangan memasukkannya ke log atau analitik dan bagikan tautan hanya kepada pembeli. referensi autentikasi menyebut token Shop hanya boleh dikirim dalam header otorisasi ke https://mcp.shop.com/. Instrumen pembayaran dapat memuat kredensial; jangan mencetak atau mencatatnya.

BIG CHANGE sebelumnya membahas alat checkout agen browser Shopify. Rilis MCP terkelola ini menjelaskan alur terpisah yang dimulai dari penemuan katalog. Catatan rilis dan manual Shopify menjelaskan apa yang dapat dipanggil pengembang serta respons yang perlu diperiksa; keduanya tidak membuktikan kenaikan konversi, keandalan saat beban tinggi, atau pembelian yang berhasil dilakukan BIG CHANGE.

Sumber dan bacaan lanjutan