Ce este un server Shopify MCP?

Este un server care folosește Model Context Protocol ca să ofere aplicațiilor AI instrumente pentru un magazin Shopify. Serverul ROASaurus MCP oferă unui client AI instrumente doar pentru citire pentru profitul, atribuirea, reclamele, valoarea clienților, inventarul, obiectivele, reperele și alertele unui singur magazin.

Poate AI-ul să-mi schimbe campaniile sau magazinul?

Nu de unul singur. Instrumentele de analiză din Ask AI și din serverul MCP doar citesc. Ask AI și un client MCP a cărui cheie are permisiunea actions:write pot propune o modificare a unei campanii în inboxul Actions, iar nimic nu se schimbă până când un proprietar sau un administrator nu o aprobă. Niciunul nu poate modifica magazinul, costurile sau setările tale.

Ce aplicații AI se pot conecta la serverul ROASaurus MCP?

Claude, ChatGPT și alți clienți MCP care suportă OAuth se autentifică cu contul tău ROASaurus. Clienții în care poți seta un header Authorization, precum Claude Code, pot folosi în schimb o cheie API.

Sunt trimise datele clienților către AI?

Instrumentele întorc metrici agregate, nu detalii de contact ale clienților. Ask AI trimite întrebarea ta și aceste metrici către Anthropic; prin MCP, rezultatele ajung la clientul AI pe care îl conectezi.

De ce nu pot întreba despre un interval de date personalizat?

Instrumentele acceptă doar perioade fixe: azi, ieri sau ultimele 7, 14, 30 ori 90 de zile, în fusul orar al magazinului. Întrebările despre valoarea clienților și despre cohorte nu iau o perioadă și folosesc în schimb istoricul tău de comenzi.

Se numără întrebările MCP în limita de 40 de întrebări?

Nu. Limita zilnică se aplică pentru Ask AI din dashboard. Prin MCP se aplică limitele de utilizare ale propriei tale aplicații AI.

Shopify MCP: întreabă datele magazinului tău în Claude și în alte aplicații AI

Ideile principale

MCP (Model Context Protocol) este un standard deschis care le permite aplicațiilor AI să apeleze instrumente de la alte servicii, astfel încât un asistent să poată răspunde pe baza datelor tale reale din magazin.
ROASaurus Ask AI și serverul ROASaurus MCP folosesc în comun 24 de instrumente doar pentru citire, de la profit, atribuire și valoarea clienților la costuri, lead-uri, abonamente, marketing mix model și anomalii.
O aplicație AI se conectează prin autentificare în ROASaurus cu OAuth sau cu o cheie API într-un header Authorization.
O cheie denumită doar cu permisiunea mcp poate doar să citească; cheia Orders API poate trimite și comenzi, așa că păstrează orice cheie secretă și revoc-o dacă s-a scurs.
Perioadele sunt fixe (azi, ieri sau ultimele 7, 14, 30 ori 90 de zile), iar Ask AI permite implicit 40 de întrebări pe utilizator pe zi.

Un server Shopify MCP conectează datele magazinului tău la un asistent AI prin Model Context Protocol (MCP). Pui o întrebare în limbaj obișnuit, precum „Care campanie a adus cel mai mare profit luna trecută?”, iar asistentul răspunde pe baza cifrelor reale ale magazinului tău, nu din memorie. ROASaurus rulează un server MCP cu 24 de instrumente de analiză doar pentru citire, iar aceleași instrumente stau la baza Ask AI din dashboard.

Acest ghid explică ce este MCP, de ce ajută să pui întrebări de analiză în acest mod, cum funcționează Ask AI și serverul MCP, cum conectezi un client, ce întrebări funcționează bine și ce trebuie să știi despre confidențialitate, securitate și limite.

Ce este MCP?

MCP este un standard open-source pentru conectarea aplicațiilor AI la sisteme externe. O aplicație AI precum Claude este clientul. Un serviciu care oferă date sau acțiuni este serverul. Serverul își descrie instrumentele: fiecare instrument are un nume, o descriere și o schemă pentru intrările lui.

Când pui o întrebare, clientul întreabă serverul ce instrumente există (tools/list). Modelul alege instrumentul potrivit, iar clientul îl apelează (tools/call). Rezultatul se întoarce la model, care scrie răspunsul. Nu trebuie să cunoști numele instrumentelor. Trebuie doar să pui întrebarea.

Shopify rulează și el servere MCP. Acestea se concentrează pe agenți de cumpărături și pe dezvoltatori: căutarea produselor, coșuri, checkout, conturi de client și documentația pentru dezvoltatori. Un server MCP de analiză răspunde unui alt fel de întrebări: profitul după reclame, atribuirea și valoarea clienților, calculate din comenzile tale, din costurile tale și din cheltuielile din conturile tale de reclame.

De ce să-ți întrebi datele magazinului într-un asistent AI?

Majoritatea întrebărilor despre magazin au nevoie de cifre din mai multe rapoarte. „A făcut Meta bani luna trecută?” are nevoie de venituri, costuri de produs, transport, comisioane și cheltuieli cu reclamele într-un singur loc. Într-un dashboard deschizi raportul potrivit, setezi datele și faci calculele. Într-un asistent AI conectat la datele tale, pui întrebarea și primești răspunsul împreună cu cifrele din spatele lui.

Limbaj obișnuit. Fără filtre, generatoare de rapoarte sau formule de foi de calcul.
Întrebări de continuare. Întreabă „și pentru TikTok?” sau „care campanie a cauzat asta?” fără să o iei de la capăt.
Mai multe rapoarte într-un singur răspuns. Profitul, atribuirea și valoarea clienților pot fi combinate într-un singur răspuns.
Limba ta. Ask AI răspunde în limba în care scrii.
Lângă restul muncii tale. Prin MCP, cifrele magazinului sunt disponibile în aplicația AI în care scrii deja rapoarte sau planuri.

Răspunsul este la fel de complet ca datele din spatele lui. Conectează mai întâi tracking-ul server-side, conturile tale de reclame și costurile tale de produs, ca instrumentele să aibă comenzi, cheltuieli și marje cu care să lucreze.

Cum funcționează Ask AI și serverul ROASaurus MCP?

Ask AI este o pagină de chat din dashboardul ROASaurus. Rulează pe Claude, modelul Anthropic. Serverul MCP oferă aceleași 24 de instrumente unui client AI pe care îl alegi tu. În ambele cazuri, instrumentele citesc rapoartele tale ROASaurus și întorc cifrele ca JSON. Modelul scrie răspunsul pe baza acestor rezultate.

Pui o întrebareÎn Ask AI sau în propriul tău client MCP

Modelul alege un instrumentDe exemplu campaign_profit pentru ultimele 30 de zile

ROASaurus rulează instrumentulDoar pentru citire, pe datele unui singur magazin

Modelul scrie răspunsulDoar pe baza cifrelor returnate

Modelul nu citește niciodată direct baza ta de date. Vede doar ce întoarce un instrument.

Fiecare instrument de analiză doar citește. Niciun instrument nu poate schimba magazinul, campaniile, costurile sau setările tale. Serverul MCP marchează fiecare dintre ele ca doar pentru citire și îi spune clientului să răspundă doar pe baza rezultatelor instrumentelor. O cheie cu permisiunea actions:write primește și propose_action, care adaugă o modificare propusă a unei reclame în inboxul Actions; nimic nu se schimbă până când un proprietar sau un administrator nu o aprobă. Ask AI din dashboard îl are și el.

În Ask AI, o întrebare poate folosi până la 8 runde de apeluri de instrumente. Dacă o întrebare are nevoie de mai multe, asistentul îți cere să fii mai specific. Ask AI păstrează conversația ta pentru fiecare utilizator și magazin și folosește ultimele 12 mesaje drept context pentru o întrebare de continuare. Poți șterge conversația oricând.

24instrumente doar pentru citire, aceleași în Ask AI și în MCP

6perioade fixe: azi, ieri, 7, 14, 30 și 90 de zile

40întrebări Ask AI pe utilizator pe zi, implicit

1magazin pentru fiecare cheie API și fiecare conexiune

Ce întrebări poți pune?

Întrebările bune numesc o metrică și una dintre perioadele acceptate. Tabelul arată exemple de întrebări, instrumentul care răspunde la fiecare și pe ce se bazează răspunsul.

Întrebare	Instrument	Ce arată răspunsul
Cum au stat ultimele 7 zile față de cele 7 zile dinainte?	`profit_summary`	Venituri, comenzi, cheltuieli cu reclamele, MER, POAS și profit, față de perioada anterioară de aceeași lungime
Care campanie a avut cel mai bun POAS în ultimele 30 de zile?	`campaign_profit`	Pe campanie: venituri atribuite, profit brut, cheltuieli cu reclamele, profit după reclame, ROAS, POAS și CAC
Ce reclame au un CPM mare și puține achiziții?	`ads_table`	Cheltuieli, afișări, click-uri, CTR și CPM alături de achizițiile urmărite, ROAS și CPA
Câte luni îi ia unei cohorte să-și recupereze CAC-ul?	`ltv_insights`	Cohorte lunare, luna de recuperare a CAC și LTV estimat
Ce produse aduc înapoi cei mai mulți clienți recurenți?	`products`	Cele mai bune produse și ponderea cumpărătorilor la prima achiziție care au comandat din nou
Suntem pe drumul cel bun pentru obiectivul de venituri din luna aceasta?	`goals_forecast`	Obiective, cifrele reale de până acum și prognoza de la sfârșitul lunii
Ce ar trebui să reaprovizionez săptămâna aceasta?	`inventory`	Stocul disponibil, viteza vânzărilor, zilele de stoc rămase și starea reaprovizionării

Modelul alege instrumentul. Tu trebuie doar să pui întrebarea.

Iată un exemplu calculat. Întrebi: „A făcut Meta bani în ultimele 30 de zile?” Modelul apelează campaign_profit cu perioada setată pe 30 de zile și cu modelul implicit pe ultimul click. Pentru un magazin exemplu, rândul Meta din rezultat arată astfel:

Linie	Meta, ultimele 30 de zile	Cum se calculează
Venituri atribuite	$24,000	Veniturile comenzilor atribuite click-urilor Meta
Profit brut (în rezultat apare ca contribution)	$13,440	Venituri minus costul produsului, transportul, comisioanele de plată și manipularea (56%)
Cheltuieli cu reclamele	$8,000	Sincronizat din contul de reclame Meta
Profit după reclame	$5,440	$13,440 − $8,000
ROAS	3.00	$24,000 ÷ $8,000
POAS	1.68	$13,440 ÷ $8,000

Magazin exemplu. Un POAS peste 1.0 înseamnă că reclamele au adus înapoi mai mult profit brut decât au costat.

În Ask AI, răspunsul începe cu „Da”, apoi dă profitul după reclame și POAS și sugerează cel mult trei pași următori. Dacă vrei o altă perspectivă, pune o întrebare de continuare, precum „și cu modelul Total Impact?”. Ghidurile noastre despre POAS și modelele de atribuire explică aceste cifre în detaliu.

Cum conectezi serverul ROASaurus MCP?

Serverul folosește transportul Streamable HTTP al MCP și returnează răspunsuri JSON, fără server-sent events. Aplicațiile AI precum Claude și ChatGPT se autentifică prin OAuth: te autentifici în ROASaurus, alegi un magazin și permiți conexiunea. Clienții în care poți seta un header de cerere, precum Claude Code, pot folosi în schimb o cheie API, ca în pașii de mai jos.

Creează o cheie API
Deschide Store settings › API & data în ROASaurus și creează o cheie denumită cu permisiunea mcp. Copiaz-o: este afișată o singură dată. Doar proprietarii și administratorii pot crea chei.
Sau refolosește cheia Orders API
Poți folosi și cheia de pe cardul Orders API, de exemplu cea pe care o folosește pluginul WooCommerce. Această cheie poate trimite și comenzi. Regenerate API key o înlocuiește și deconectează tot ce o folosea pe cea veche.
Notează cheia magazinului
O cheie denumită se pune singură în header. Cu cheia Orders API, adaugă și cheia magazinului: valoarea X-Roasaurus-Key de pe același card, a cărui secțiune MCP arată headerul complet.
Adaugă serverul în clientul tău MCP
Introdu endpoint-ul și headerul Authorization afișate mai jos. Clientul trebuie să accepte Streamable HTTP și headere de cerere personalizate.
Pune o întrebare de test
Întreabă „Care au fost veniturile mele de ieri?” și verifică cifra în dashboardul tău.

Endpoint și un exemplu pentru Claude Code

# 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>"

Poți trimite cheia magazinului și într-un header X-Roasaurus-Key și doar cheia API ca token bearer. În Claude Code, păstrează scopul local implicit. Un server cu scop de proiect este salvat într-un fișier .mcp.json care este partajat prin controlul versiunilor, iar asta ți-ar partaja cheia.

Ca să te autentifici în schimb, adaugă https://app.roasaurus.com/mcp ca connector personalizat în Claude sau ChatGPT și autentifică-te când aplicația îți cere. Doar proprietarii și administratorii pot permite o conexiune. Store settings › API & data afișează fiecare aplicație conectată, de unde o poți deconecta, iar o conexiune se încheie și când acea persoană părăsește workspace-ul.

initialize · 2025-06-18Clientul și serverul convin asupra versiunii protocolului

tools/list · 24 tools · readOnlyHint: trueClientul află ce instrumente există

tools/call · campaign_profit · period 30Modelul cere profitul campaniilor pe 30 de zile

result · isError: falseJSON cu un rând pentru fiecare canal și campanie

401 · Invalid store key or API key.Ce întoarce o cheie greșită sau regenerată

Cum arată o întrebare între client și serverul ROASaurus MCP.

Este sigur? Confidențialitate și securitate

Pentru că instrumentele de analiză doar citesc, o aplicație AI nu poate pune pe pauză o campanie, edita un cost sau schimba o setare prin ROASaurus; cu actions:write poate doar să propună o modificare a unei reclame, spre aprobare de către un proprietar sau un administrator. Instrumentele acceptă și doar intrări fixe, precum o perioadă sau un model de atribuire dintr-o listă. Totuși, câteva puncte cer atenție.

Unde ajung datele. Ask AI trimite întrebarea ta și metricile agregate ale magazinului către Anthropic, care rulează Claude. Nu trimite datele de contact ale clienților tăi. Prin MCP, rezultatele instrumentelor ajung la clientul AI pe care îl conectezi, conform termenilor acelui client. Verifică setările lui de păstrare a datelor și de antrenare.
Ce întorc instrumentele. Totaluri pe perioadă, canal, campanie, reclamă, produs, cohortă și segment. Nu întorc nume de clienți, adrese de email sau numere de telefon.
Cine poate întreba. Oricine are acces la aplicația AI în care adaugi conexiunea poate interoga magazinul. Adaug-o în propriul tău cont, nu într-unul partajat.
Alți conectori. Specificația MCP spune că ar trebui să existe mereu un om în buclă (human in the loop) care poate refuza apelurile de instrumente și că clienții trebuie să trateze adnotările instrumentelor ca nesigure, cu excepția cazului în care serverul este de încredere. Dacă aplicația ta AI are și instrumente care trimit emailuri sau postează mesaje, păstrează activate cererile de confirmare pentru acele instrumente.

Care sunt limitele?

Perioade fixe. Azi, ieri sau ultimele 7, 14, 30 ori 90 de zile, în fusul orar al magazinului. Un interval personalizat, precum o săptămână din martie, nu este acceptat. Instrumentele pentru valoarea clienților și pentru cohorte nu iau o perioadă: lucrează pe istoricul comenzilor tale, cu până la 12 cohorte lunare.
O fereastră de 7 zile pentru tabelul de reclame. Instrumentul de reclame folosește o fereastră lookback de 7 zile, indiferent de fereastra pe care o setezi în Store settings. Instrumentele de atribuire și de profit al campaniilor, ca rapoartele de atribuire din dashboard, folosesc setarea ta sau o fereastră lookback pe care o ceri.
Liste scurtate. Listele de campanii întorc cel mult 25 de campanii, tabelul de reclame cele 30 de rânduri cu cele mai mari cheltuieli, iar lista de produse primele 25 de produse.
Un magazin pentru fiecare conexiune. Pentru mai multe magazine, creează o cheie și o conexiune pentru fiecare.
Limita de întrebări Ask AI. Fiecare utilizator poate pune implicit 40 de întrebări pe zi, numărate în ultimele 24 de ore. Prin MCP se aplică în schimb limitele proprii de utilizare ale clientului tău AI.
Răspunsurile pot fi greșite. Modelul poate interpreta greșit un rezultat. Verifică cifrele importante în rapoarte înainte să acționezi pe baza lor, de exemplu în analiza profitului.

Surse

În ROASaurus

Continuă lectura

Creative, email și AIOboseala creativă în reclamele Facebook: când să înlocuiești o reclamăOboseala creativă în reclamele Facebook se vede prin frecvență în creștere și CTR în scădere. Învață s-o măsori pe fiecare reclamă, să citești hook rate și hold rate și să planifici o rutină de înnoire.Creative, email și AIFluxurile Klaviyo pentru coșuri abandonate: recunoaște mai mulți cumpărătoriFluxurile Klaviyo pentru coșuri abandonate și pentru navigare ajung doar la cumpărătorii pe care Klaviyo îi poate identifica. Află cum îi identifică și cum recunoști mai mulți în checkout.TrackingBlocantele de reclame și tracking-ul: ce pierde magazinul tăuBlocantele de reclame opresc pixelii de tracking, așa că platformele de publicitate pierd achiziții. Vezi ce evenimente se pierd, de ce evenimentele server-side nu se pierd și cum îți măsori diferența.