Shopify MCP: pitajte podatke svoje trgovine u Claudeu i drugim AI aplikacijama

Shopify MCP poslužitelj povezuje podatke vaše trgovine s AI asistentom putem protokola Model Context Protocol (MCP). Postavite pitanje običnim jezikom, na primjer „Koja je kampanja prošlog mjeseca donijela najviše dobiti?”, a asistent odgovara iz stvarnih brojki vaše trgovine umjesto iz memorije. ROASaurus pokreće MCP poslužitelj s 24 alata za analitiku samo za čitanje, a isti alati pokreću i Ask AI na nadzornoj ploči.

Ovaj vodič objašnjava što je MCP, zašto je korisno analitička pitanja postavljati na ovaj način, kako rade Ask AI i MCP poslužitelj, kako povezati klijenta, koja pitanja dobro funkcioniraju te što trebate znati o privatnosti, sigurnosti i ograničenjima.

Što je MCP?

MCP je standard otvorenog koda za povezivanje AI aplikacija s vanjskim sustavima. AI aplikacija poput Claudea je klijent. Usluga koja nudi podatke ili radnje je poslužitelj. Poslužitelj opisuje svoje alate: svaki alat ima naziv, opis i shemu ulaznih podataka.

Kada postavite pitanje, klijent pita poslužitelj koji alati postoje (tools/list). Model bira alat koji odgovara, a klijent ga poziva (tools/call). Rezultat se vraća modelu, koji piše odgovor. Ne morate znati nazive alata. Samo postavite pitanje.

Shopify također vodi MCP poslužitelje. Usmjereni su na agente za kupovinu i razvojne programere: pretraživanje proizvoda, košarice, naplatu, korisničke račune i razvojnu dokumentaciju. Analitički MCP poslužitelj odgovara na drukčiju vrstu pitanja: dobit nakon oglasa, atribuciju i vrijednost kupca, izračunate iz vaših narudžbi, vaših troškova i potrošnje na vašim oglasnim računima.

Zašto o podacima svoje trgovine pitati AI asistenta?

Većina pitanja o trgovini traži brojeve iz nekoliko izvješća. „Je li Meta prošli mjesec zaradila?“ traži prihod, troškove proizvoda, dostavu, naknade i potrošnju na oglase na jednom mjestu. Na nadzornoj ploči otvarate pravo izvješće, postavljate datume i računate. U AI asistentu povezanom s vašim podacima postavite pitanje i dobijete odgovor s brojevima iza njega.

• Običan jezik. Bez filtara, alata za izradu izvješća ili formula iz proračunskih tablica.
• Potpitanja. Pitajte „a za TikTok?“ ili „koja je kampanja to uzrokovala?“ bez ponovnog početka.
• Više izvješća u jednom odgovoru. Dobit, atribucija i vrijednost kupca mogu se spojiti u jednom odgovoru.
• Vaš jezik. Ask AI odgovara na jeziku na kojem pišete.
• Uz ostali vaš posao. Putem MCP-a brojevi trgovine dostupni su u AI aplikaciji u kojoj već pišete izvještaje ili planove.

Odgovor je potpun tek koliko i podaci iza njega. Prvo povežite praćenje na strani poslužitelja, svoje oglasne račune i troškove proizvoda, kako bi alati imali narudžbe, potrošnju i marže s kojima mogu raditi.

Kako rade Ask AI i ROASaurus MCP poslužitelj?

Ask AI je stranica za razgovor na nadzornoj ploči ROASaurusa. Radi na Claudeu, Anthropicovu modelu. MCP poslužitelj nudi ista 24 alata AI klijentu po vašem izboru. U oba slučaja alati čitaju vaša ROASaurus izvješća i vraćaju brojke kao JSON. Model iz tih rezultata piše odgovor.

Svaki alat za analitiku samo čita. Nijedan alat ne može promijeniti vašu trgovinu, kampanje, troškove ili postavke. MCP poslužitelj svaki od njih označava kao alat samo za čitanje i klijentu nalaže da odgovara isključivo iz rezultata alata. Ključ s opsegom actions:write dobiva i propose_action, koji dodaje predloženu promjenu oglasa u pretinac Actions; ništa se ne mijenja dok to ne odobri vlasnik ili administrator. Ima ga i Ask AI na nadzornoj ploči.

U Ask AI jedno pitanje može iskoristiti do 8 krugova poziva alata. Ako pitanje treba više, asistent traži da budete precizniji. Ask AI čuva vaš razgovor po korisniku i trgovini te za potpitanje koristi zadnjih 12 poruka kao kontekst. Razgovor možete obrisati u svakom trenutku.

Koja pitanja možete postaviti?

Dobra pitanja navode metriku i jedno od podržanih razdoblja. Tablica prikazuje primjere pitanja, alat koji odgovara na svako od njih i na čemu se odgovor temelji.

Evo razrađenog primjera. Pitate: „Je li Meta u zadnjih 30 dana zaradila?“ Model poziva campaign_profit s razdobljem postavljenim na 30 dana i zadanim modelom posljednjeg klika. Za primjer trgovine redak za Metu u rezultatu izgleda ovako:

U Ask AI odgovor počinje s „Da“, zatim navodi dobit nakon oglasa i POAS te predlaže najviše tri sljedeća koraka. Ako želite drugi pogled, postavite potpitanje poput „a s modelom Total Impact?“. Naši vodiči o POAS-u i modelima atribucije podrobnije objašnjavaju te brojeve.

Kako povezati ROASaurus MCP poslužitelj?

Poslužitelj koristi MCP-ov Streamable HTTP prijenos i vraća JSON odgovore, bez server-sent eventsa. AI aplikacije poput Claudea i ChatGPT-a prijavljuju se putem OAuth-a: prijavite se u ROASaurus, odaberete trgovinu i dopustite vezu. Klijenti u kojima možete postaviti zaglavlje zahtjeva, poput Claude Codea, mogu umjesto toga koristiti API ključ, kao u koracima ispod.

1. Izradite API ključ

   U ROASaurusu otvorite Store settings › API & data i izradite imenovani ključ s opsegom mcp. Kopirajte ga: prikazuje se samo jednom. Ključeve mogu izrađivati samo vlasnici i administratori.

2. Ili ponovno upotrijebite ključ za Orders API

   Možete koristiti i ključ s kartice Orders API, na primjer onaj koji koristi WooCommerce dodatak. Taj ključ može slati i narudžbe. Regenerate API key ga zamjenjuje i prekida vezu sa svime što koristi stari ključ.

3. Zabilježite ključ trgovine

   Imenovani ključ ide u zaglavlje sam. Uz ključ za Orders API dodajte ključ trgovine: vrijednost X-Roasaurus-Key s iste kartice, čiji odjeljak MCP prikazuje cijelo zaglavlje.

4. Dodajte poslužitelj u svoj MCP klijent

   Unesite endpoint i zaglavlje Authorization prikazane u nastavku. Klijent mora podržavati Streamable HTTP i prilagođena zaglavlja zahtjeva.

5. Postavite testno pitanje

   Pitajte "Koliki je bio moj prihod jučer?" i usporedite broj sa svojom nadzornom pločom.

# Endpoint
POST https://app.roasaurus.com/mcp
Authorization: Bearer <named key with the mcp scope>
# or, with the Orders API key
Authorization: Bearer <store key>:<API key>

# Claude Code
claude mcp add --transport http roasaurus https://app.roasaurus.com/mcp \
  --header "Authorization: Bearer <named key with the mcp scope>"

Ključ trgovine možete poslati i u zaglavlju X-Roasaurus-Key, a samo API ključ kao bearer token. U Claude Codeu zadržite zadani lokalni opseg. Poslužitelj ograničen na projekt sprema se u datoteku .mcp.json koja se dijeli putem kontrole verzija, što bi podijelilo vaš ključ.

Za prijavu umjesto ključa dodajte https://app.roasaurus.com/mcp kao prilagođeni konektor u Claudeu ili ChatGPT-u i prijavite se kad aplikacija to zatraži. Vezu mogu dopustiti samo vlasnici i administratori. Store settings › API & data prikazuje svaku povezanu aplikaciju, gdje je možete odspojiti, a veza prestaje i kad ta osoba napusti radni prostor.

Je li sigurno? Privatnost i sigurnost

Budući da alati za analitiku samo čitaju, AI aplikacija putem ROASaurusa ne može pauzirati kampanju, urediti trošak ni promijeniti postavku; s actions:write može samo predložiti promjenu oglasa koju odobrava vlasnik ili administrator. Alati prihvaćaju i samo fiksne ulazne podatke, poput razdoblja ili modela atribucije s popisa. Ipak, na nekoliko stvari treba paziti.

• Kamo idu podaci. Ask AI šalje vaše pitanje i agregirane metrike trgovine Anthropicu, koji vodi Claudea. Ne šalje kontaktne podatke vaših kupaca. Putem MCP-a rezultati alata idu AI klijentu koji povežete, prema uvjetima tog klijenta. Provjerite njegove postavke zadržavanja podataka i treniranja.
• Što alati vraćaju. Zbrojeve po razdoblju, kanalu, kampanji, oglasu, proizvodu, kohorti i segmentu. Ne vraćaju imena kupaca, e-adrese ni telefonske brojeve.
• Tko može pitati. Svatko s pristupom AI aplikaciji u kojoj dodate vezu može postavljati upite o trgovini. Dodajte je u vlastiti račun, a ne u zajednički.
• Ostali konektori. MCP specifikacija kaže da uvijek treba postojati čovjek u petlji koji može odbiti pozive alata te da klijenti moraju anotacije alata tretirati kao nepouzdane osim ako je poslužitelj pouzdan. Ako vaša AI aplikacija ima i alate koji šalju e-poštu ili objavljuju poruke, za te alate ostavite uključene upite za potvrdu.

Koja su ograničenja?

• Fiksna razdoblja. Danas, jučer ili zadnjih 7, 14, 30 ili 90 dana, u vremenskoj zoni trgovine. Prilagođeni raspon, poput jednog tjedna u ožujku, nije podržan. Alati za vrijednost kupca i kohorte ne uzimaju razdoblje: rade iz vaše povijesti narudžbi, s do 12 mjesečnih kohorti.
• Prozor od 7 dana za tablicu oglasa. Alat za oglase koristi atribucijski prozor od 7 dana, bez obzira na prozor koji ste postavili u Store settings. Alati za atribuciju i dobit kampanja, kao i izvješća o atribuciji na nadzornoj ploči, koriste vašu postavku ili prozor koji zatražite.
• Skraćeni popisi. Popisi kampanja vraćaju najviše 25 kampanja, tablica oglasa 30 redaka s najvećom potrošnjom, a popis proizvoda 25 najboljih proizvoda.
• Jedna trgovina po vezi. Za više trgovina izradite ključ i vezu za svaku.
• Ograničenje pitanja u Ask AI. Svaki korisnik prema zadanim postavkama može postaviti 40 pitanja dnevno, računato u zadnja 24 sata. Putem MCP-a umjesto toga vrijede vlastita ograničenja korištenja vašeg AI klijenta.
• Odgovori mogu biti pogrešni. Model može pogrešno pročitati rezultat. Važne brojeve provjerite u izvješćima prije nego što djelujete, primjerice u analitici dobiti.

Izvori

1. Model Context Protocol: What is the Model Context Protocol (MCP)?
2. Model Context Protocol specification (2025-06-18): Tools
3. Claude Code Docs: Connect Claude Code to tools via MCP
4. Claude Docs: Authentication for connectors
5. OpenAI: Building MCP servers for plugins and API integrations

U ROASaurusu

• Ask AI i MCP
• Analitika dobiti
• POAS kalkulator

Nastavite čitati