Markdown издање

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

# Kako povezati agenta za kupovinu sa Shopify Shop MCP-om

> Novi Shopify Shop MCP povezuje pretragu kataloga, korpe trgovaca i naplatu. Ovaj vodič zasnovan na dokumentaciji objašnjava podešavanje, odobrenje kupca i granice provere porudžbine.

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 [pokrenuo je Shop MCP 13. oktobra](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp), dajući programerima jednu hostovanu vezu za pretragu proizvoda, korpe i naplatu. Usluga je na adresi `https://mcp.shop.com/`. Njegovih 17 alata može da pronađe proizvode u Shopify Catalog-u i otvori naplatu kod trgovca koji prodaje artikal. Za pretragu kataloga nije potreban API ključ. Kupac i dalje mora da odobri stvarnu kupovinu.

Ovaj vodič je namenjen programerima koji podešavaju asistenta kompatibilnog sa MCP-om. Koraci prate Shopify dokumentaciju, proverenu 14. oktobra. BIG CHANGE nije povezao agenta, napravio korpu niti obavio kupovinu. Vodič zato opisuje očekivane rezultate, a ne zabeležene performanse.

## Šta se menja

- **Šta je novo:** Shopify sada nudi hostovanu MCP vezu koja pokriva put od pretrage kataloga do korpe i naplate kod trgovca. Takođe dokumentuje završetak kupovine putem Shop Pay-a za prijavljenog kupca, nakon njegove izričite potvrde.
- **Ko može da ga koristi:** Programeri sa MCP klijentom koji podržava verziju protokola `2026-07-28`, ili kodom koji obavlja dokumentovane HTTP pozive. Stariji klijent koji koristi samo rukovanje `initialize` ne može direktno da se poveže.
- **Šta proveriti:** Naplata je transakcija kod jednog trgovca. `completed` zajedno sa `order` potvrđuje kupovinu; korpa, veza za naplatu ili plaćanje u toku to ne potvrđuju.

## Pre povezivanja

Potreban vam je MCP klijent koji podržava udaljene HTTP servere i [Shopify dokumentovani metod povezivanja](https://shop.dev/docs/connect)ili aplikacija koja poziva server preko HTTP-a. Koristite korenski URL `https://mcp.shop.com/`; dodavanje `/mcp` vraća 404. Alati za pretragu i korpu rade bez Shop naloga. Prijava omogućava asistentu da koristi sačuvane postavke i adrese, pronađe porudžbine i ponudi Shop Pay kada ga trgovac podržava. Za asistenta sa sopstvenim HTTP kodom, Shopify dokumentuje OAuth tok za uređaj koji kupac odobrava na Shop sajtu.

Pre pretrage izaberite upit za proizvod, odredišnu zemlju i valutu. Odvojite zahteve koje je kupac naveo od konteksta pretrage: zemlja ili valuta pomažu lokalizaciji rezultata; ograničenje cene, veličina ili odredište isporuke predstavljaju filter. API izražava cene u manjim jedinicama valute. Aplikacija treba da pročita odgovor `messages` pre nego što tvrdi da rezultat ispunjava filter, jer usluga može da prijavi da filter nije primenjen kako je traženo. [Shopify vodič za pretragu](https://shop.dev/docs/search) objašnjava razliku i ograničenje od 1 do 50 rezultata po stranici.

## Dokumentovani put od pretrage do porudžbine

1. **Povežite i proverite pretragu.** Podesite klijent pomoću `https://mcp.shop.com/` i učitajte Shopify [Shop skill](https://shop.dev/docs/connect) ako klijent može da je koristi. Shopify predlaže da vezu proverite zahtevom za tri stone lampe bez pravljenja korpe. Ispravna pretraga vraća proizvode sa prodavcem, cenom u navedenoj valuti i vezom ka trgovcu. Programeri koji koriste HTTP mogu da prate Shopify [JSON-RPC brzi vodič](https://shop.dev/docs/quickstart) koji sadrži obavezna zaglavlja protokola i zahtev `search_catalog`. Ovo je provera samo za čitanje i ne zahteva prijavu.
2. **Izaberite tačan artikal.** Pokrenite `search_catalog` sa upitom i zahtevima kupca. Pretraga vraća istaknutu varijantu; koristite `get_product` ako kupac želi drugu veličinu ili boju. Uporedite `product.selected` i vraćeni `variant.options` sa svakom veličinom, bojom i drugim izborom koji je kupac naveo pre prikaza ili kupovine. Shopify kaže da se izbor može ublažiti bez upozorenja. Kada kupac izabere proizvod ili promeni opciju, ponovo pozovite `get_product` da proverite trenutnu dostupnost i cenu. Sačuvajte tačan ID te varijante i domen prodavca. Ne pretpostavljajte da će trgovac prihvatiti ranije prikazanu cenu. Prikažite upozorenje uz proizvod na koji se odnosi. Ove provere su dokumentovane u odeljku [Pronađite proizvode](https://shop.dev/docs/search).
3. **Napravite korpu kada kupac to zatraži.** Na osnovu uputstva kupca da prikupite artikle, pozovite `create_cart` za izabranog trgovca i varijantu. Korpa čuva artikle, ali ne pravi porudžbinu. Artikle različitih prodavaca držite u zasebnim korpama: Shopify navodi da svaka korpa i naplata pripadaju jednom trgovcu. Rezultat treba da sadrži ID korpe i njene stavke. Ako kupac samo razgleda, stanite nakon pretrage; Shopify [uputstvo za korpe](https://shop.dev/docs/checkout) kaže da samo interesovanje za proizvod nije dozvola za pravljenje korpe.
4. **Otvorite i pregledajte naplatu.** Kada kupac zatraži ukupnu cenu ili bude spreman za kupovinu, pozovite `create_checkout` koristeći ID korpe ili tačan ID varijante i domen prodavca iz rezultata pretrage. Dokument naplate treba da vrati ID, status, stavke, valutu, ukupne iznose, načine plaćanja, `messages`, pravila trgovca `links` i `continue_url` za stranicu trgovca. Pre nastavka kupcu prikažite trenutne iznose sa oznakama, uključujući dostavu i porez, svako upozorenje i svaku vezu ka pravilima. Objašnjenja držite uz artikal ili polje na koje se odnose. Kupcu dajte neizmenjeni `continue_url`, sa parametrima upita, uz artikle koje obuhvata čak i kada agent može da završi naplatu. Naplata može biti u statusu `incomplete` ako je potrebna adresa ili `requires_escalation` ako kupac mora da završi na stranici trgovca. Shopify kaže da naplata podrazumevano ističe nakon šest sati.
5. **Plaćanje prepustite kupcu.** Ako se kupac prijavi, naplata može da ponudi sačuvane adrese i Shop Pay. Pre poziva `complete_checkout` pročitajte najnoviju naplatu, potvrdite da je u stanju `ready_for_complete`, prikažite trgovca, artikle, količine, ukupan iznos i dostupne načine, pa prepustite kupcu izbor načina plaćanja. Ne birajte umesto njega. Neizmenjeni `continue_url` trgovca ostavite dostupnim kupcu čak i kada agent može da završi naplatu; ako instrument plaćanja nije dostupan, kupac mora da koristi tu vezu. Shopify [uputstvo za naplatu](https://shop.dev/docs/checkout) kaže da se nakon odobrenja `complete_checkout` pošalje jednom, a zatim proveri vraćeni status. Poseban [tok odobrenja za prodavnice van Shopify-ja](https://shop.dev/docs/approvals) traži da kupac odobri plaćanje u Shop-u i obezbedi karticu za naplatu te prodavnice; to nije tok naplate kod Shopify trgovca iz koraka 3 i 4.
6. **Proverite ishod.** Samo `status: completed` sa `order` potvrđuje da je trgovac napravio porudžbinu. Ako se plaćanje još obrađuje, koristite `get_checkout` da ponovo pročitate status. Shopify navodi da pri pokretanju nema veb-kukova, pa integracija mora da proverava `get_checkout` radi ažuriranja. Ako poziv za završetak istekne ili je odgovor nejasan, nemojte ga ponavljati niti otvarati zamensku naplatu. Pročitajte postojeću naplatu; ako ne prikazuje oba stanja, `completed` i `order`, recite kupcu da kupovina nije potvrđena i dajte mu `continue_url`.

## Ograničenja i oporavak

Shopify navodi da pretraga radi bez akreditiva. Njegova [objava o pokretanju](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp) upućuje programere kojima su potrebna veća ograničenja broja zahteva na API ključ u Shopify Dev Dashboard-u, ali ne objavljuje cenu ni javnu tabelu ograničenja za taj ključ. Cene artikala trgovca, isporuka i porez dolaze iz trenutne naplate; kupac treba da ih pregleda pre plaćanja. Agent može imati i sopstvene troškove hostovanja ili modela ako ih programer koristi. Objava ne kvantifikuje te troškove.

Neuspešno čitanje može da se ponovi nakon navedenog `retry_after` čekanja. Za kreiranje ili izmenu korpe i naplate, Shopify [vodič za greške](https://shop.dev/docs/errors) preporučuje idempotency ključ i čitanje postojećeg resursa pre ponavljanja neizvesnog upisa. Ako se kreiranje pošalje bez ključa i ne uspe pre nego što vrati ID, ishod je nepoznat; nemojte nagađati i praviti drugi. `complete_checkout` je stroži: nikada ga ne ponavljajte nakon neizvesnog odgovora. Stranica trgovca ostaje put kupca kada `requires_escalation` ili nedostatak podataka za plaćanje spreči agenta da završi.

ID-jeve naplate, veze za naplatu, pristupne tokene i instrumente plaćanja tretirajte kao osetljive podatke. Shopify navodi da ID naplate i `continue_url` sadrže pristupne ključeve, zato ih ne stavljajte u evidenciju ni analitiku i vezu delite samo sa kupcem. [referenca za autentifikaciju](https://shop.dev/docs/authentication) kaže da se Shop token šalje samo u zaglavlju za autorizaciju ka `https://mcp.shop.com/`. Instrument plaćanja može sadržati akreditiv; nemojte ga ispisivati ni beležiti.

BIG CHANGE je ranije obrađivao Shopify [alate za naplatu agenata u pregledaču](https://bigchange.ai/blog/shopify-webmcp-browser-agent-checkout). Ovo hostovano MCP izdanje opisuje poseban tok koji počinje otkrivanjem kataloga. Shopify objava i priručnici navode šta programeri mogu da pozovu i koje odgovore treba pregledati; ne dokazuju rast konverzije, pouzdanost pod opterećenjem niti kupovinu koju je obavio BIG CHANGE.

## Izvori i dodatno čitanje

- [Shopify evidencija izmena za programere, „Dodajte kupovinu i Shop Pay naplatu bilo kom agentu uz Shop MCP“, 13. oktobar 2026.](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp). Opseg izdanja, hostovani endpoint, 17 alata, pristup pretrazi, tokovi naplate i stanje veb-kukova pri pokretanju.
- [Pregled Shop MCP-a i vodič za povezivanje](https://shop.dev/docs/). Aktuelni protokol, zahtevi klijenta i prijava.
- [Shopify, Pronađite proizvode](https://shop.dev/docs/search). Polja pretrage, izbor varijante, jedinice cene i upozorenja filtera.
- [Shopify, Korpe i naplata](https://shop.dev/docs/checkout). Opseg trgovca, značenja statusa, završetak naplate i postupanje pri neizvesnom ishodu.
- [Shopify, Greške i ponovni pokušaji](https://shop.dev/docs/errors). Pravila oporavka čitanja i upisa.
- [Shopify, Autentifikacija](https://shop.dev/docs/authentication). Pristup Shop nalogu i rukovanje tokenima.

## Sources

- [Shopify evidencija izmena za programere, Dodajte kupovinu i Shop Pay naplatu bilo kom agentu uz Shop MCP](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp) — Datum pokretanja, aktivni endpoint, 17 alata, pretraga kataloga bez ključa, Shop i ne-Shopify tokovi naplate, bez veb-kukova pri pokretanju i Dev Dashboard ključ za viša ograničenja. To su tvrdnje Shopify-ja, ne nezavisni rezultati.
- [Pregled Shop MCP-a](https://shop.dev/docs/) — Hostovani endpoint, MCP verzija 2026-07-28, verzija UCP dokumenta 2026-08-25, jedan trgovac po naplati i potvrda kroz završenu porudžbinu.
- [Shop MCP, Povežite agenta](https://shop.dev/docs/connect) — Korenski URL i zahtev protokola, načini povezivanja klijenta, učitavanje veštine i provera veze samo za čitanje.
- [Shop MCP, Brzi vodič](https://shop.dev/docs/quickstart) — Dokumentovani JSON-RPC zahtev za pretragu, zaglavlja, oblik odgovora, jedinice cene i greške.
- [Shop MCP, Pronađite proizvode](https://shop.dev/docs/search) — Upit, filteri, kontekst, istaknuta varijanta i upozorenja.
- [Shop MCP, Korpe i naplata](https://shop.dev/docs/checkout) — Ponašanje alata korpe i naplate, opseg trgovca, polja i status naplate, ljudsko odobrenje plaćanja, osetljivi ID-jevi i postupanje pri neizvesnom završetku.
- [Shop MCP, Greške i ponovni pokušaji](https://shop.dev/docs/errors) — Oporavak čitanja, idempotency ključ za upise koji nisu plaćanje i zabrana ponavljanja complete_checkout nakon neizvesnog ishoda.
- [Shop MCP, Autentifikacija](https://shop.dev/docs/authentication) — Opseg Shop tokena, OAuth tok za uređaj i zaštita privatnih akreditiva.
- [Shop MCP, Odobrite kupovinu van Shopify-ja](https://shop.dev/docs/approvals) — Zaseban put odobrenja kupca i kartice za naplatu kod trgovca koji nije na Shopify-ju.