Edisi Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Cara menghubungkan agen belanja ke Shop MCP Shopify

> Shop MCP baru dari Shopify menghubungkan pencarian katalog, keranjang merchant, dan checkout. Panduan berbasis dokumentasi ini menjelaskan penyiapan, langkah persetujuan pembeli, dan batas verifikasi pesanan.

By BIG CHANGE Editorial

Published: 2026-10-14T12:58:17.853Z
Updated: 2026-10-14T12:58:17.853Z
Canonical: https://bigchange.ai/blog/connect-shopping-agent-shopify-shop-mcp

![Conceptual charcoal illustration of a product shelf, a shopping basket holding one cup, and a blank checkout terminal; a shopper's hand pauses short of the terminal.](https://bigchange.ai/api/media/file/shop-mcp-catalog-to-checkout-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE; no actual Shop MCP interface, agent test or purchase is depicted.

Shopify [meluncurkan Shop MCP pada 13 Oktober](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp), 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](https://shop.dev/docs/connect) 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](https://shop.dev/docs/search) 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](https://shop.dev/docs/connect) 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](https://shop.dev/docs/quickstart) 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](https://shop.dev/docs/search).
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](https://shop.dev/docs/checkout) 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](https://shop.dev/docs/checkout) menyebut `complete_checkout` dikirim satu kali setelah persetujuan lalu status yang dikembalikan diperiksa. [alur persetujuan terpisah untuk toko di luar Shopify](https://shop.dev/docs/approvals) 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](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp) 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](https://shop.dev/docs/errors) 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](https://shop.dev/docs/authentication) 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](https://bigchange.ai/blog/shopify-webmcp-browser-agent-checkout) 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

- [Changelog pengembang Shopify, “Tambahkan belanja dan checkout Shop Pay ke agen apa pun dengan Shop MCP,” 13 Oktober 2026](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp). Cakupan rilis, endpoint terkelola, 17 alat, akses pencarian, jalur checkout, dan status webhook saat peluncuran.
- [Ikhtisar Shop MCP dan panduan koneksi](https://shop.dev/docs/). Protokol saat ini, persyaratan klien, dan proses masuk.
- [Shopify, Temukan produk](https://shop.dev/docs/search). Kolom pencarian, pemilihan varian, satuan harga, dan peringatan filter.
- [Shopify, Keranjang dan checkout](https://shop.dev/docs/checkout). Cakupan merchant, arti status, penyelesaian checkout, dan penanganan hasil yang tidak pasti.
- [Shopify, Kesalahan dan percobaan ulang](https://shop.dev/docs/errors). Aturan pemulihan baca dan tulis.
- [Shopify, Autentikasi](https://shop.dev/docs/authentication). Akses akun Shop dan penanganan token.

## Sources

- [Changelog pengembang Shopify, Tambahkan belanja dan checkout Shop Pay ke agen apa pun dengan Shop MCP](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp) — Tanggal peluncuran, endpoint aktif, 17 alat, pencarian katalog tanpa kunci, jalur checkout Shop dan non-Shopify, tanpa webhook saat peluncuran, serta kunci Dev Dashboard untuk batas laju lebih tinggi. Ini klaim Shopify, bukan hasil independen.
- [Ikhtisar Shop MCP](https://shop.dev/docs/) — Endpoint terkelola, versi MCP 2026-07-28, versi dokumen UCP 2026-08-25, satu merchant per checkout, dan konfirmasi pesanan selesai.
- [Shop MCP, Hubungkan agen](https://shop.dev/docs/connect) — URL akar dan persyaratan protokol, jalur klien, pemuatan skill, dan pemeriksaan koneksi hanya-baca.
- [Shop MCP, Panduan cepat](https://shop.dev/docs/quickstart) — Permintaan pencarian JSON-RPC terdokumentasi, header, bentuk respons, satuan harga, dan kesalahan.
- [Shop MCP, Temukan produk](https://shop.dev/docs/search) — Kueri, filter, konteks, varian unggulan, dan peringatan.
- [Shop MCP, Keranjang dan checkout](https://shop.dev/docs/checkout) — Perilaku alat keranjang dan checkout, cakupan merchant, kolom dan status checkout, persetujuan pembayaran oleh manusia, ID sensitif, dan penanganan penyelesaian yang tidak pasti.
- [Shop MCP, Kesalahan dan percobaan ulang](https://shop.dev/docs/errors) — Pemulihan baca, kunci idempotensi untuk penulisan non-pembayaran, dan larangan mengulang complete_checkout yang hasilnya tidak pasti.
- [Shop MCP, Autentikasi](https://shop.dev/docs/authentication) — Cakupan token Shop, alur OAuth perangkat, dan perlindungan kredensial privat.
- [Shop MCP, Setujui pembelian di luar Shopify](https://shop.dev/docs/approvals) — Jalur persetujuan pembeli dan kartu terpisah untuk checkout merchant non-Shopify.