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

# Paano ikonekta ang shopping agent sa Shop MCP ng Shopify

> Pinag-uugnay ng bagong Shop MCP ng Shopify ang paghahanap sa katalogo, mga cart ng merchant, at checkout. Ipinapaliwanag ng gabay na ito batay sa dokumentasyon ang setup, pag-apruba ng mamimili, at mga hangganan ng pag-verify ng order.

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.

Inilunsad ng Shopify ang [Shop MCP noong Oktubre 13](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp), na nagbibigay sa mga developer ng iisang hosted na koneksyon para sa paghahanap ng produkto, mga cart, at checkout. Nasa `https://mcp.shop.com/` ang serbisyo. Kayang maghanap ng mga produkto sa Shopify Catalog ang 17 tool nito at magbukas ng checkout sa merchant na nagbebenta ng item. Hindi kailangan ng API key sa paghahanap sa katalogo. Kailangan pa ring aprubahan ng mamimili ang tunay na pagbili.

Para ito sa mga developer na nagse-set up ng MCP-compatible na assistant. Sinusunod ng mga hakbang ang dokumentasyon ng Shopify na sinuri noong Oktubre 14. Hindi nagkonekta ng agent, gumawa ng cart, o bumili ang BIG CHANGE. Inilalarawan ng gabay ang mga inaasahang resulta, hindi ang nasukat na performance.

## Ang malaking pagbabago

- **Ano ang nagbago:** Nag-aalok na ngayon ang Shopify ng hosted na MCP connection mula paghahanap sa katalogo hanggang cart at checkout ng merchant. Idinodokumento rin nito ang pagkumpleto sa Shop Pay ng naka-sign-in na mamimili matapos ang tahasang kumpirmasyon.
- **Sino ang makakagamit:** Mga developer na may MCP client na sumusuporta sa protocol version `2026-07-28`, o code na gumagawa ng dokumentadong HTTP calls. Hindi direktang makakakonekta ang lumang client na `initialize` handshake lang ang gamit.
- **Ano ang dapat tingnan:** Transaksyon ito sa iisang merchant. `completed` kasama ng `order` ang nagpapatunay ng pagbili; hindi sapat ang cart, checkout link, o bayad na pinoproseso pa.

## Bago kumonekta

Kailangan mo ng MCP client na sumusuporta sa mga remote HTTP server at sa [paraan ng pagkonekta na idinokumento ng Shopify](https://shop.dev/docs/connect) o app na tumatawag sa server sa HTTP. Gamitin ang root URL na `https://mcp.shop.com/`; nagbabalik ng 404 ang pagdagdag ng `/mcp`. Gumagana ang mga search at cart tool kahit walang Shop account. Kapag naka-sign in, magagamit ng assistant ang mga naka-save na preference at address, makakahanap ng order, at makakapag-alok ng Shop Pay kung sinusuportahan ng merchant. Para sa assistant na may sariling HTTP code, idinodokumento ng Shopify ang OAuth device flow na inaaprubahan ng mamimili sa site ng Shop.

Pumili muna ng product query, bansang padadalhan, at currency. Ihiwalay ang mga kahilingang sinabi ng mamimili sa konteksto ng paghahanap: tumutulong ang bansa o currency na i-localize ang mga resulta; filter ang limitasyon sa presyo, laki, o destinasyon ng pagpapadala. Ginagamit ng API ang maliliit na unit ng currency para sa presyo. Dapat basahin ng app mo ang `messages` ng tugon bago sabihing pasok sa filter ang resulta, dahil maaaring sabihin ng serbisyo na hindi nailapat ang filter ayon sa kahilingan. Ipinaliliwanag ng [gabay sa paghahanap ng Shopify](https://shop.dev/docs/search) ang pagkakaiba at limitasyong 1–50 resulta bawat pahina.

## Dokumentadong daan mula paghahanap hanggang order

1. **Kumonekta at subukan ang paghahanap.** I-configure ang client gamit ang `https://mcp.shop.com/` at i-load ang [Shop skill](https://shop.dev/docs/connect) ng Shopify kung kaya ito ng client. Iminumungkahi ng Shopify na subukan ang koneksyon sa paghahanap ng tatlong desk lamp nang hindi gumagawa ng cart. Nagbabalik ang maayos na paghahanap ng mga produkto na may seller, presyong may tinukoy na currency, at link ng merchant. Maaaring sundan ng mga developer na gumagamit ng HTTP ang [JSON-RPC quickstart](https://shop.dev/docs/quickstart) ng Shopify na may kinakailangang protocol headers at `search_catalog` request. Read-only ang pagsusuring ito at hindi kailangan ng sign-in.
2. **Piliin ang eksaktong item.** Patakbuhin ang `search_catalog` gamit ang query at mga kahilingan ng mamimili. Nagbabalik ang paghahanap ng featured variant; gamitin ang `get_product` kung ibang laki o kulay ang gusto ng mamimili. Ihambing ang `product.selected` at ang ibinalik na `variant.options` sa bawat laki, kulay, at iba pang pinili ng mamimili bago ipakita o bilhin ito. Ayon sa Shopify, maaaring lumuwag ang pagpili nang walang babala. Kapag pumili ng produkto o nagpalit ng opsyon ang mamimili, tawagan muli ang `get_product` para tingnan ang kasalukuyang availability at presyo. Panatilihing eksakto ang ID ng variant at domain ng seller. Huwag ipagpalagay na pananatilihin ng merchant ang dating ipinakitang presyo. Ipakita ang babala sa tabi ng kaugnay na produkto. Nasa [Maghanap ng mga produkto](https://shop.dev/docs/search) ang mga pagsusuring ito.
3. **Gumawa ng cart kapag hiniling.** Kapag inutusan kang pagsama-samahin ang mga item, tawagan ang `create_cart` para sa napiling merchant at variant. Nag-iimbak lang ng mga item ang cart; hindi ito naglalagay ng order. Ihiwalay ang mga item mula sa magkakaibang seller: ayon sa Shopify, iisang merchant lang ang saklaw ng bawat cart at checkout. Dapat kasama sa resulta ang cart ID at mga linya nito. Kung magba-browse lang ang mamimili, huminto pagkatapos maghanap; sinasabi ng [gabay ng Shopify sa cart](https://shop.dev/docs/checkout) na hindi pahintulot gumawa ng cart ang interes lang sa produkto.
4. **Buksan at suriin ang checkout.** Kapag nagtanong ang mamimili ng kabuuang presyo o handa na siyang bumili, tawagan ang `create_checkout` gamit ang cart ID o eksaktong variant ID at domain ng seller mula sa paghahanap. Dapat magbalik ang checkout document ng ID, status, line item, currency, mga total, paraan ng pagbabayad, `messages`, patakaran ng merchant `links` at `continue_url` para sa page ng merchant. Bago magpatuloy, ipakita sa mamimili ang kasalukuyang total kasama ang mga label, delivery at buwis, lahat ng babala, at link ng patakaran. Ilagay ang paliwanag sa tabi ng kaugnay na item o field. Ibigay sa mamimili ang hindi binagong `continue_url` kasama ang query parameter nito at mga item na saklaw nito kahit kaya ng agent tapusin ang checkout. Maaaring `incomplete` ang checkout kung kailangan ng address o `requires_escalation` kung sa page ng merchant ito dapat tapusin ng mamimili. Sinasabi ng Shopify na nag-e-expire ang checkout pagkalipas ng anim na oras bilang default.
5. **Mamimili ang dapat magpasya sa bayad.** Kung naka-sign in ang mamimili, maaaring mag-alok ang checkout ng mga naka-save na address at Shop Pay. Bago tawagan ang `complete_checkout`, basahin ang pinakabagong checkout, tiyaking `ready_for_complete` ang status, ipakita ang merchant, mga item, dami, total at mga paraang magagamit, at hayaang mamili ng paraan ng pagbabayad ang mamimili. Huwag ikaw ang pumili para sa kanya. Panatilihing available sa mamimili ang hindi binagong `continue_url` ng merchant kahit kaya ng agent tapusin ang checkout; kung walang payment instrument, kailangang gamitin ng mamimili ang link. Sinasabi ng [mga tagubilin sa checkout ng Shopify](https://shop.dev/docs/checkout) na isang beses lang ipadala ang `complete_checkout` pagkatapos ng pag-apruba at saka tingnan ang ibinalik na status. Sa hiwalay na [approval flow para sa mga tindahang wala sa Shopify](https://shop.dev/docs/approvals), inaaprubahan ng mamimili ang bayad sa Shop at nagbibigay ng card para sa sariling checkout ng tindahan; iba ito sa checkout ng Shopify merchant sa hakbang 3 at 4.
6. **Beripikahin ang kinalabasan.**Tanging `status: completed` lang na may `order` ang nagpapatunay na gumawa ng order ang merchant. Kung pinoproseso pa ang bayad, gamitin ang `get_checkout` para basahin muli ang status. Ayon sa Shopify, walang webhook sa paglulunsad kaya kailangang i-poll ng integration ang `get_checkout` para sa mga update. Kung mag-time out ang completion call o malabo ang tugon, huwag itong ipadala muli o magbukas ng pamalit na checkout. Basahin ang umiiral na checkout; kung hindi nito ipinapakita ang parehong `completed` at `order`, sabihin sa mamimili na hindi kumpirmado ang pagbili at ibigay ang `continue_url`.

## Mga limitasyon at pag-recover

Ayon sa Shopify, gumagana ang paghahanap nang walang credential. Itinuturo ng [launch note](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp) nito ang mga developer na nangangailangan ng mas mataas na rate limit sa API key sa Shopify Dev Dashboard, pero walang pampublikong presyo o talaan ng limitasyon para rito. Galing sa kasalukuyang checkout ang presyo ng item, pagpapadala, at buwis; dapat suriin ito ng mamimili bago magbayad. Maaari ring may sariling gastos sa hosting o model ang agent kung gumagamit nito ang developer. Hindi tinatantiya ng anunsyo ang mga gastos na iyon.

Maaaring ulitin ang bigong read pagkatapos ng nakasaad na `retry_after` delay. Para sa paggawa o pag-update ng cart at checkout, sinasabi ng [gabay ng Shopify sa error](https://shop.dev/docs/errors) na gumamit ng idempotency key at basahin ang umiiral na resource bago ulitin ang write na hindi tiyak ang resulta. Kung mabigo ang create na walang key bago magbalik ng ID, hindi alam ang kinalabasan; huwag manghula at gumawa ulit. Mas mahigpit ang `complete_checkout`: huwag itong ulitin pagkatapos ng hindi tiyak na tugon. Mananatiling daan ng mamimili ang page ng merchant kapag `requires_escalation` o kakulangan ng detalye sa bayad ang pumigil sa agent na matapos.

Ituring na sensitibo ang checkout ID, checkout link, access token, at payment instrument. Sinasabi ng Shopify na may access key ang checkout ID at `continue_url`; huwag ilagay ang mga ito sa log o analytics at sa mamimili lang ibahagi ang link. Sinasabi ng [authentication reference](https://shop.dev/docs/authentication) na Shop token lang ang ipadala sa authorization header papunta sa `https://mcp.shop.com/`. Maaaring may credential ang payment instrument; huwag itong i-print o i-log.

Nauna nang sinaklaw ng BIG CHANGE ang mga [browser-agent checkout tool](https://bigchange.ai/blog/shopify-webmcp-browser-agent-checkout) ng Shopify. Inilalarawan ng hosted MCP release na ito ang hiwalay na workflow na nagsisimula sa pagtuklas sa katalogo. Itinatakda ng release note at mga manual ng Shopify kung ano ang puwedeng tawagin at aling tugon ang susuriin ng developer; hindi nito pinatutunayan ang pagtaas ng conversion, pagiging maaasahan sa ilalim ng load, o matagumpay na pagbili ng BIG CHANGE.

## Mga source at karagdagang babasahin

- [Shopify developer changelog, “Magdagdag ng shopping at Shop Pay checkout sa anumang agent gamit ang Shop MCP,” Oktubre 13, 2026](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp). Saklaw ng release, hosted endpoint, 17 tool, access sa paghahanap, mga paraan ng checkout, at kalagayan ng webhook sa paglulunsad.
- [Pangkalahatang-ideya ng Shop MCP at gabay sa koneksyon](https://shop.dev/docs/). Kasalukuyang protocol, kinakailangan ng client at sign-in.
- [Shopify, Maghanap ng mga produkto](https://shop.dev/docs/search). Mga field sa paghahanap, pagpili ng variant, unit ng presyo at babala ng filter.
- [Shopify, Mga cart at checkout](https://shop.dev/docs/checkout). Saklaw ng merchant, kahulugan ng status, pagkumpleto ng checkout at paghawak sa hindi tiyak na resulta.
- [Shopify, Mga error at retry](https://shop.dev/docs/errors). Mga tuntunin sa pag-recover ng read at write.
- [Shopify, Authentication](https://shop.dev/docs/authentication). Access sa Shop account at paghawak ng token.

## Sources

- [Shopify developer changelog, Magdagdag ng shopping at Shop Pay checkout sa anumang agent gamit ang Shop MCP](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp) — Petsa ng paglulunsad, live endpoint, 17 tool, paghahanap sa katalogo nang walang key, Shop at non-Shopify checkout, walang webhook sa paglulunsad, at Dev Dashboard key para sa mas mataas na rate limit. Pahayag ito ng Shopify, hindi hiwalay na resulta.
- [Pangkalahatang-ideya ng Shop MCP](https://shop.dev/docs/) — Hosted endpoint, MCP version 2026-07-28, UCP document version 2026-08-25, iisang merchant bawat checkout at kumpirmasyon ng kumpletong order.
- [Shop MCP, Ikonekta ang agent](https://shop.dev/docs/connect) — Root URL at kinakailangan ng protocol, mga paraan ng client, pag-load ng skill, at read-only na pagsusuri ng koneksyon.
- [Shop MCP, Quickstart](https://shop.dev/docs/quickstart) — Dokumentadong JSON-RPC search request, headers, hugis ng tugon, unit ng presyo at error.
- [Shop MCP, Maghanap ng mga produkto](https://shop.dev/docs/search) — Query, filter, konteksto, featured variant at babala.
- [Shop MCP, Mga cart at checkout](https://shop.dev/docs/checkout) — Gawi ng cart at checkout tool, saklaw ng merchant, mga field at status ng checkout, pag-apruba ng tao sa bayad, sensitibong ID at paghawak sa hindi tiyak na pagkumpleto.
- [Shop MCP, Mga error at retry](https://shop.dev/docs/errors) — Pag-recover ng read, idempotency key para sa write na hindi bayad, at pagbabawal ulitin ang complete_checkout kapag hindi tiyak ang resulta.
- [Shop MCP, Authentication](https://shop.dev/docs/authentication) — Saklaw ng Shop token, OAuth device flow at proteksiyon ng pribadong credential.
- [Shop MCP, Aprubahan ang pagbili sa labas ng Shopify](https://shop.dev/docs/approvals) — Hiwalay na daan ng approval ng mamimili at card para sa checkout ng merchant na wala sa Shopify.