Shopify MCP în 2026: serverele oficiale, configurare și când construiești unul propriu

Pe scurt. „Shopify MCP” nu e un singur produs. În noiembrie 2026, Shopify rulează mai multe servere Model Context Protocol: servere pentru cumpărători în fiecare magazin, la /api/ucp/mcp (catalog, coș, întrebări despre magazin), servere Checkout și Order cu autentificare, Shop MCP pentru căutare și cumpărare în tot Shopify Catalog, un server Customer Accounts, un server Dev MCP pentru dezvoltatori și unelte WebMCP în browserul cumpărătorului. Uneltele vechi Storefront MCP pentru catalog și coș de pe /api/mcp au fost eliminate. Niciunul nu îți administrează back office-ul: pentru asta folosești AI Toolkit de la Shopify sau îți construiești propriul server Admin API, cum am făcut noi pentru un client.

Ce s-a schimbat în 2026

Până în 2026, majoritatea ghidurilor „Shopify MCP” descriau o singură adresă: fiecare magazin răspundea la https://{shop}/api/mcp cu unelte pentru căutare în catalog și gestionarea coșului. De atunci, Shopify a mutat agenții pentru cumpărători pe Universal Commerce Protocol (UCP), un standard deschis dezvoltat împreună cu Google. Anunțul de depreciere a păstrat vechile unelte de coș până la 31 august 2026; pagina de migrare spune acum că uneltele de catalog și coș de pe /api/mcp au fost eliminate.

Potrivit Shopify, în cod se schimbă trei lucruri: fiecare cerere către /api/ucp/mcp include un agent profile; update_cart înlocuiește acum tot coșul, deci trimiți de fiecare dată toate liniile; și fiecare cerere Checkout MCP e autentificată sau semnată. Serverul Customer Accounts MCP nu s-a schimbat.

Toate serverele Shopify MCP oficiale, într-un tabel

Două detalii contează mai mult decât arată tabelul. Checkout-ul e locul unde Shopify e cel mai strict: în Shop MCP, agentul finalizează o cumpărare doar „după ce cumpărătorul confirmă totalul și metoda de plată”, iar la lansare nu există webhooks, deci agentul interoghează periodic starea checkout-ului. Iar Ask MCP e doar de citire, intenționat: „nu modifică coșuri, nu plasează comenzi și nu pornește retururi”.

De ce Shopify MCP ai nevoie?

Majoritatea căutărilor „Shopify MCP” vin din unul dintre cinci obiective. Fiecare are alt răspuns, iar două dintre ele nu cer deloc muncă pe MCP.

Pentru primul obiectiv, munca e la datele de produs, nu la cod: titluri, variante, atribute și politici pe care un asistent le poate citi și compara. Le acoperim în agentic commerce. Pentru o explicație simplă despre ce e un server MCP și ce să expui, vezi ce este un server MCP.

Agentic Storefronts și Shopify Catalog: ce controlează comerciantul

Agentic storefronts e un canal de vânzare în adminul Shopify, „activ implicit pentru magazinele eligibile”. Îți pune produsele în ChatGPT, Google AI Mode și Gemini, Microsoft Copilot și Meta prin Shopify Catalog (Google citește și canalul Google & YouTube sau Merchant Center). Checkout-ul diferă pe canal: ChatGPT trimite cumpărătorul în checkout-ul magazinului tău, într-un browser din aplicație, iar AI Mode, Gemini, Copilot și Meta pot folosi un checkout direct oferit de Shopify, dacă îl activezi. Comenzile apar în admin cu canalul atribuit.

Pentru că integrarea e făcută pentru tine, ce decide dacă un asistent îți recomandă produsul sunt datele pe care le citește. Înainte de orice lucru tehnic, verifică:

• Titluri care spun ce e produsul, nu doar un nume de brand sau un slogan de campanie.
• Variante reale, cu preț, stoc și nume de opțiuni proprii (mărime, culoare, material).
• Atribute în câmpuri, de exemplu metafields pentru material, dimensiuni, compatibilitate sau certificări, nu doar în imagini sau descrieri lungi.
• Politicile și baza de cunoștințe completate: retururi, termene de livrare, garanție.
• Produsele doar B2B marcate ca atare, ca să rămână în afara canalelor pentru consumatori.

Imaginea de ansamblu, inclusiv felul în care asistenții aleg produsele, e în agentic commerce.

Conectează Claude sau ChatGPT la datele magazinului tău: 5 variante

Multe căutări „Shopify MCP” vor de fapt altceva: „asistentul meu AI să-mi citească vânzările și să-mi editeze produsele”. Serverele Shopify pentru cumpărători nu pot face asta. Aceste cinci variante pot, cu riscuri foarte diferite:

Regula practică a Shopify: folosește Sidekick când sarcina implică datele magazinului sau o acțiune în admin, iar un asistent general pentru scris, cercetare și planificare. Unele aplicații din App Store adaugă controalele de care are nevoie un magazin: ShopMCP, de exemplu, setează permisiuni de citire, modificare și ștergere pe fiecare conexiune și ține un jurnal de audit (audit log) pentru fiecare cerere, inclusiv cele blocate.

Dacă încerci un server al comunității precum shopify-mcp, creează-i o aplicație separată și începe cu scopes doar de citire (read_products, read_orders). Adaugă write_products doar pentru sarcina care îl cere și ține write_customers și write_orders departe de experimente. Potrivit README-ului proiectului, aplicațiile create în Dev Dashboard din 1 ianuarie 2026 folosesc OAuth client credentials (tokenuri valabile cam 24 de ore) în loc de un access token static shpat_; aplicațiile custom existente își pot folosi în continuare tokenul.

Pentru dezvoltatori: Dev MCP, Claude Desktop și prima cerere UCP

Serverul Dev MCP rulează pe calculatorul tău, nu cere autentificare și îi dă asistentului de cod documentația și schemele API actuale ale Shopify, ca să nu mai inventeze câmpuri GraphQL. În Claude Code e o singură comandă (instrucțiunile Shopify acoperă și Cursor, Codex și VS Code):

claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest

În Claude Desktop sau Cursor, același server intră în fișierul de configurare MCP (în Claude Desktop pe macOS: ~/Library/Application Support/Claude/claude_desktop_config.json), apoi repornești aplicația:

{
  "mcpServers": {
    "shopify-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@shopify/dev-mcp@latest"]
    }
  }
}

Un agent de cumpărături e altceva: apelezi endpointul UCP al unui magazin prin JSON-RPC, iar fiecare cerere îți numește agent profile-ul. O primă căutare în catalog, după exemplul Shopify, arată așa (POST la https://{shop}/api/ucp/mcp):

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "search_catalog",
    "arguments": {
      "meta": { "ucp-agent": { "profile": "https://your-agent.example/ucp-profile.json" } },
      "catalog": {
        "query": "organic coffee beans",
        "context": { "address_country": "US" }
      }
    }
  }
}

Shopify AI Toolkit adaugă validare de cod pentru GraphQL, Liquid și extensii, plus administrarea magazinului prin Shopify CLI, „cu tine alegând când să le rulezi”.

Când îți construiești propriul server Shopify MCP

Serverele Shopify lucrează pentru cumpărători, iar AI Toolkit e gândit pentru dezvoltatori. Când un comerciant vrea să ruleze munca repetitivă din magazin doar cerând-o (să importe un catalog, să reeticheteze o gamă, să publice ce a fost verificat), un mic server MCP pe GraphQL Admin API e piesa lipsă. Am construit unul pentru Horeca Papatya, la mutarea de pe WooCommerce pe Shopify. Designul are două straturi:

• Cunoaștere: Shopify AI Toolkit, ca asistentul să lucreze după schema și documentația reală a Shopify, nu din memorie.
• Acțiune: propriul nostru server MCP, cu o listă fixă de unelte: căutare, citire, creare, actualizare și ștergere de produse, setare de stoc, publicare, actualizare în masă după o interogare, listă de stoc redus și import CSV prin bulk operations.

Uneltele sunt partea ușoară. Regulile din jurul lor îl fac sigur pe un magazin live:

• Produsele noi sunt ciorne. create_product creează implicit DRAFT; publicarea e un pas separat, după verificare.
• Modificările în masă se repetă întâi pe probă. bulk_update_products rulează implicit ca dry run și spune câte produse s-ar schimba; rularea reală cere un al doilea apel explicit.
• Ștergerea cere un „da”. delete_product nu rulează fără confirm: true, iar asistentul e instruit să întrebe întâi.
• Importurile folosesc bulk operations, nu o buclă de creări individuale, ca să rămână în limitele de rată ale Shopify.
• Doar GraphQL Admin API, pe o versiune de API fixată, ca un upgrade să fie o decizie, nu o surpriză.
• Scopes minime, iar tokenul nu apare niciodată în chat.

1. Cerere
   Limbaj natural

   „Etichetează toate produsele acestui furnizor cu coffee-machine.”

2. Probă
   Dry run

   bulk_update_products cu dryRun activ: vine numărul de produse potrivite, nu se schimbă nimic.

3. Confirmare
   Un om

   Comerciantul verifică numărul și spune da.

4. Rulare
   Actualizare reală

   Același apel cu dryRun oprit; rezultatul listează ce s-a schimbat.

Lecția: viteza agentului vine din unelte, siguranța din valorile implicite. Pune opțiunea prudentă în unealta însăși (ciornă, probă, confirmare), nu te baza pe prompt să și-o amintească. E același tipar pe care îl descriem în exemple de agenți AI.

Listă de securitate înainte să conectezi un agent la Shopify

• Dă fiecărui agent propriile credențiale și cele mai restrânse scopes de care are nevoie; întâi doar citire.
• Ține banii și acțiunile ireversibile în spatele unui om: finalizarea plății, rambursările, ștergerile, schimbările de preț.
• Preferă unelte care fac probe (dry run) și creează implicit ciorne.
• Fixează versiunea API și testează înainte să treci la una nouă.
• Tratează datele de produs și mesajele clienților ca input nesigur (prompt injection): un agent nu trebuie să urmeze instrucțiuni pe care le citește în ele.
• Ține un jurnal de audit (audit log) pentru fiecare apel de unealtă, ca să vezi ce a făcut agentul și să poți anula.

Depanare

• Apelurile la /api/mcp eșuează sau nu întorc unelte de catalog: acele unelte au fost eliminate. Treci la https://{shop}/api/ucp/mcp.
• tools/list arată mai puține unelte decât te aștepți: uneltele depind de capabilitățile declarate în agent profile. Ask MCP are nevoie de un profil UCP draft care declară dev.ucp.common.ask.
• Produsele dispar din coș după o actualizare: update_cart înlocuiește tot coșul. Trimite de fiecare dată toate liniile.
• Cererile de checkout sunt respinse: Checkout MCP cere autentificare sau cereri semnate, cu client credentials din secțiunea Catalog a Dev Dashboard.
• Nu vin actualizări de stare de la Shop MCP: la lansare nu există webhooks. Interoghează get_checkout.
• Produsele lipsesc din ChatGPT sau Copilot: verifică Sales channels > Agentic, accesul canalului la Shopify Catalog, statusul produsului și dacă produsul e doar B2B.

Întrebări frecvente

• Ce este Shopify MCP?+−

  O familie de servere Model Context Protocol care le permit agenților AI să lucreze cu Shopify: servere pentru cumpărători (catalog, coș, întrebări, checkout și comenzi, construite pe UCP), Shop MCP pentru tot Shopify Catalog, Customer Accounts MCP, serverul Dev MCP pentru dezvoltatori și unelte WebMCP în browser.

• A fost depreciat Shopify Storefront MCP?+−

  Da. Uneltele de catalog și coș de pe https://{shop}/api/mcp au fost eliminate în favoarea serverelor UCP de la https://{shop}/api/ucp/mcp. Uneltele de coș au fost păstrate până la 31 august 2026. Serverul Customer Accounts MCP nu s-a schimbat.

• Are fiecare magazin Shopify un server MCP?+−

  Shopify oferă endpointul UCP la https://{shop}/api/ucp/mcp pentru magazine, iar fiecare cerere trebuie să includă un agent profile. Ce unelte vede un agent depinde de capabilitățile din acel profil.

• Cum conectez Claude sau Cursor la Shopify?+−

  Pentru dezvoltare, adaugă serverul Dev MCP al Shopify (npx -y @shopify/dev-mcp@latest) sau instalează pluginul Shopify AI Toolkit. Pentru datele live ale unui magazin ai nevoie de o aplicație cu acces la Admin API, prin administrarea magazinului din AI Toolkit sau prin propriul server MCP.

• Am nevoie de un server MCP ca să vând în ChatGPT?+−

  Nu. Shopify conectează comercianții la canale AI precum ChatGPT, Google AI Mode, Gemini și Microsoft Copilot și le gestionează din adminul Shopify. Partea ta sunt date de produs complete și corecte.

• Pot opri apariția produselor mele în ChatGPT?+−

  Da, pe fiecare canal: în Sales channels > Agentic, dezactivează Allow Shopify to manage for me, apoi dezactivează Shopify Catalog access pentru ChatGPT. Ca să ascunzi un produs de toate canalele AI, setează-i statusul Unlisted. Nu poți ieși din Shopify Catalog, iar produsele pot fi găsite în continuare prin indexarea obișnuită a webului.

• Ce permisiuni ar trebui să aibă un server Shopify MCP?+−

  Cele mai puține care fac treaba: întâi scopes de citire precum read_products și read_orders, write_products doar pentru sarcina care îl cere și o aplicație separată pentru fiecare unealtă, ca să poți revoca una fără celelalte.

• Poate un server Shopify MCP să-mi modifice magazinul?+−

  Serverele pentru cumpărători nu ating adminul. Doar un server cu acces la Admin API poate, cum ar fi administrarea magazinului din AI Toolkit sau un server propriu. Dă-i implicit ciorne, rulări de probă și confirmări.

Surse

• Shopify: Migrate from Storefront MCP
• Shopify changelog: Storefront MCP cart tools are being deprecated in favour of UCP Cart MCP
• Shopify: Build commerce agents with UCP
• Shopify: Storefront Catalog MCP
• Shopify: Cart MCP
• Shopify: Checkout MCP
• Shopify: Ask MCP
• Shopify: Order MCP
• Shopify changelog: Add shopping and Shop Pay checkout to any agent with Shop MCP
• Shopify: Customer Accounts MCP server
• Shopify: AI Toolkit
• Shopify: WebMCP tools
• Shopify: The agentic commerce platform
• Shopify Help Center: Shopify agentic storefronts
• Shopify Help Center: Managing agentic storefronts
• Shopify Help Center: Shopify Catalog
• Shopify Help Center: Shopify Catalog and product discovery for agentic storefronts
• Shopify: AI ChatGPT guide for Shopify merchants (Sidekick vs ChatGPT)
• GitHub: shopify-mcp (community server)
• Shopify App Store: ShopMCP
• Google: New tech and tools for retailers to succeed in an agentic shopping era

• Shopify
• MCP

Ahmet Molon

Fondator