Shopify pokrenuo je Shop MCP 13. oktobra, 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 povezivanjaili 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 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 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č 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.
  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 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 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 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 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 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 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. 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