Inilunsad ng Shopify ang Shop MCP noong Oktubre 13, 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 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 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 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 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 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 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 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, 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 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 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 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 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