Processo

Gestire tutto il Suo store Shopify da Claude Code: la guida per merchant non tecnici

Guida passo passo per i proprietari di store Shopify: configurare Claude Code con Shopify CLI, Shopify Dev MCP, Nano Banana per le immagini AI e Google Search Console, ed eseguire aggiornamenti prodotto, fix SEO e generazione immagini in autonomia.

8 aprile 2026

Finestra di terminale con i comandi claude mcp add collegati a uno storefront Shopify

Se gestisce uno store Shopify e finora ha guardato la conversazione sull’AI dalla panchina, chiedendosi quando diventa davvero utile per Lei — non per gli sviluppatori, non per il «Lei del futuro che imparerà a programmare», ma per l’operatore vero che aggiorna i prodotti e scrive le descrizioni un martedì pomeriggio — quel momento è adesso.

Negli ultimi sei mesi tre cose sono diventate vere nello stesso periodo:

Claude Code di Anthropic (lo strumento da terminale che permette a Claude di fare davvero le cose sul Suo computer, invece di limitarsi a parlarne) è diventato abbastanza stabile da essere usato in sicurezza anche da chi non sviluppa.
Shopify ha rilasciato un server Dev MCP ufficiale che dà a Claude accesso live alla documentazione di Shopify, agli schemi GraphQL e alle best practice delle API.
L’ecosistema MCP è esploso — oggi esistono server della community per gestire il Suo store Shopify, generare immagini con Nano Banana di Google, estrarre dati da Google Search Console, pubblicare su Klaviyo e cento altre cose, tutti che parlano lo stesso protocollo.

Li colleghi insieme e ottiene una configurazione in cui può scrivere «trova i 20 prodotti con il CTR più basso in Search Console, riscrivi le loro meta description, genera nuove hero image lifestyle per i primi 5 e prepara tutto in bozza così posso rivedere prima di pubblicare» — e andarsene mentre il sistema lavora.

Questa guida La porta da zero software installato a quel preciso workflow. È scritta per un merchant Shopify che se la cava a copia-incollare comandi ma non scrive codice. Tempo di setup totale: circa 60-90 minuti la prima volta. Dopodiché ogni nuova automazione richiede pochi minuti.

Cosa avrà alla fine

Alla fine di questa guida avrà Claude Code in esecuzione sul Suo computer con quattro superpoteri collegati:

Shopify Dev MCP — documentazione ufficiale Shopify e conoscenza delle API integrate, così Claude non si inventa mai campi inesistenti o sintassi obsoleta
Un MCP per la gestione dello store Shopify — controllo reale su prodotti, ordini, clienti, collezioni e immagini del Suo store live
Nano Banana MCP — generazione e editing di immagini con Google Gemini (lo stesso modello dietro alcune delle migliori product photography AI viste quest’anno)
Google Search Console MCP — dati SEO live che Claude può leggere e su cui può agire senza che Lei esporti CSV

Questo è il loop completo: vede cosa non funziona, lo sistema, genera gli asset, pubblica su Shopify, verifica in Search Console. Tutto da un’unica finestra di chat.

Perché conta proprio adesso (il contesto di aprile 2026)

Qualche cosa da sapere prima di iniziare, perché il panorama si è spostato nell’ultimo trimestre e la maggior parte dei tutorial online è ormai superata:

Dal 1° gennaio 2026, le nuove app Shopify si creano nel Dev Dashboard e usano credenziali client OAuth (un client ID e un secret) al posto dei vecchi access token statici shpat_. Se ha seguito un tutorial più vecchio che Le dice di copiare un token shpat_xxxxx, funzionerà solo per le custom app legacy. Le configurazioni nuove usano coppie clientId/clientSecret, e il server MCP le scambia automaticamente con token a vita breve.
La versione API Shopify di default verso cui puntano la maggior parte degli MCP è 2026-01. Qualsiasi tutorial che fa riferimento a 2024-04 o precedenti è obsoleto.
Nano Banana 2 (Gemini 3.1 Flash Image) è ormai il default per la maggior parte degli MCP di immagini — Le dà qualità di livello Pro alla velocità del tier Flash e costa circa 0,04-0,05 $ per immagine a risoluzione standard, fino a circa 0,15 $ per immagine in 4K.
Esistono due MCP Shopify e fanno cose diverse. Shopify Dev MCP è uno strumento per sviluppatori che gira in locale e fornisce accesso alla documentazione e agli schemi API di Shopify. Non controlla il Suo store. Per le azioni vere sullo store (creare prodotti, aggiornare prezzi, gestire collezioni) serve un MCP separato della community. Li installeremo entrambi.

Tutto chiaro? Bene. Configuriamo.

Step 1: installare le fondamenta (Node.js e Claude Code)

Le servirà Node.js 18 o superiore per quasi tutto in questo stack. Se non l’ha mai installato:

Vada su nodejs.org e scarichi la versione LTS per il Suo sistema operativo.
Esegua l’installer con le impostazioni di default.
Apra il Terminale (Mac) o il Prompt dei comandi / PowerShell (Windows) e digiti node --version. Dovrebbe vedere qualcosa come v20.x.x o superiore.

Poi installi Claude Code:

npm install -g @anthropic-ai/claude-code

Quindi lo esegua una volta per accedere:

claude

Aprirà un browser, Le chiederà di accedere al Suo account Anthropic, e tornerà al terminale con una sessione Claude Code funzionante. Digiti /exit per uscirne per ora.

Attenzione: Claude Code su Windows può fare le bizze con i server MCP — molti server della community danno per scontati path Mac/Linux. Se è su Windows ed è la prima volta, la strada più liscia è installare WSL2 (Windows Subsystem for Linux) ed eseguire tutto da dentro Ubuntu. Richiede 15 minuti in più ma Le risparmia ore di debug.

Step 2: installare la Shopify CLI

La Shopify CLI è lo strumento ufficiale a riga di comando per lavorare con temi, app e dati dello store. Claude Code la userà dietro le quinte.

npm install -g @shopify/cli@latest

Verifichi con shopify version — dovrebbe vedere un numero di versione. Se vuole accedere al Suo store adesso (opzionale ma utile), esegua shopify auth login e segua il prompt del browser.

Step 3: aggiungere il Shopify Dev MCP ufficiale

È quello che dà a Claude accesso alla documentazione, agli schemi GraphQL e alla validazione del codice di Shopify. Non richiede autenticazione e gira interamente sulla Sua macchina.

claude mcp add --scope user shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest

Tutto qui. Riavvii Claude Code (/exit e poi di nuovo claude) e potrà subito chiedere cose come:

«Mostrami la mutation GraphQL per aggiornare il metafield di un prodotto nella versione API 2026-01»
«Quali scope servono alla mia app per leggere le bozze d’ordine?»

Il Dev MCP include un tool chiamato learn_shopify_api che deve essere chiamato prima di qualunque altro tool Shopify in una data conversazione — genera un conversationId di cui gli altri tool hanno bisogno. Claude lo sa e lo chiamerà in automatico. Non deve pensarci Lei.

Step 4: aggiungere un MCP per la gestione dello store Shopify

È l’MCP che fa davvero le cose nel Suo store — crea prodotti, aggiorna l’inventario, processa ordini, gestisce collezioni. Ci sono due strade principali.

Opzione A: MCP della community (gratuito, più setup)

L’opzione open source più diffusa è shopify-mcp di GeLi2001. È un pacchetto Node, gira in locale e supporta sia i vecchi access token sia le nuove credenziali client OAuth.

Per le nuove app Shopify (post-gennaio 2026):

Dall’admin Shopify, vada su Impostazioni > App e canali di vendita > Sviluppa app (o il nuovo Dev Dashboard se il Suo store lo ha abilitato).
Crei una custom app, configuri gli scope API che vuole concedere a Claude (parta in piccolo — read_products, write_products, read_orders è un terzetto di partenza sensato) e copi il Client ID e il Client Secret.
Aggiunga l’MCP a Claude Code:

claude mcp add shopify -- npx shopify-mcp \
  --clientId YOUR_CLIENT_ID \
  --clientSecret YOUR_CLIENT_SECRET \
  --domain your-store.myshopify.com

Il server scambierà quelle credenziali con token a vita breve (validi ~24 ore) in automatico.

Per le custom app legacy con un token statico shpat_:

claude mcp add shopify -- npx shopify-mcp \
  --accessToken YOUR_ACCESS_TOKEN \
  --domain your-store.myshopify.com

Importante: si assicuri di installare shopify-mcp e non shopify-mcp-server — sono pacchetti diversi con nomi di argomenti diversi, e confonderli genera errori.

Opzione B: Composio (a pagamento, setup quasi a zero)

Se i comandi da terminale Le mettono ansia, Composio offre un MCP hosted che gestisce tutto l’OAuth per Lei. Accede una volta su composio.dev, collega il Suo store Shopify dalla loro interfaccia e Le danno un unico URL MCP da aggiungere a Claude Code. Costa qualcosa ma Le risparmia circa un’ora di smanettamento. Per i merchant che gestiscono più store o che non vogliono occuparsi delle credenziali, ne vale la pena.

In entrambi i casi, riavvii Claude Code dopo aver aggiunto il server. Verifichi che sia caricato con claude mcp list.

Step 5: aggiungere Nano Banana per la generazione di immagini AI

Nano Banana è il nome amichevole dei modelli di generazione immagini Gemini di Google. Nano Banana 2 (Gemini 3.1 Flash Image) è il default attuale — Le dà output fino al 4K, coerenza dei personaggi su più generazioni e una resa nitida del testo dentro le immagini, che è la parte che finalmente rende l’AI utilizzabile per la product photography vera.

Prima Le servirà una chiave API Gemini. Vada su Google AI Studio (aistudio.google.com), acceda con il Suo account Google e crei una chiave API. La generazione di immagini richiede il billing attivo — i modelli di testo sono gratuiti, ma la generazione immagini è a consumo. Non c’è alcun minimo mensile.

Poi aggiunga l’MCP:

claude mcp add nano-banana \
  --env GEMINI_API_KEY=your_api_key_here \
  -- npx @rafarafarafa/nano-banana-pro-mcp

Riavvii Claude Code e ora può chiedere cose come:

«Genera una hero image per la nuova collezione di tende in lino — luce mattutina naturale che entra da una finestra in un soggiorno scandinavo, toni beige tenui, formato 16:9, 4K»
«Prendi questa foto prodotto e modificala per mostrare la tenda su una parete di colore diverso»

L’MCP supporta text-to-image, editing image-to-image e immagini di riferimento per il trasferimento di stile. Aspettativa di costo per uno store attivo: generare 50-100 immagini al mese per varianti prodotto, scatti lifestyle e hero banner costa circa 5-15 $.

Step 6: aggiungere il Google Search Console MCP

È qui che il loop SEO si chiude. Con Claude Code che legge i Suoi dati live di Search Console, può individuare le pagine che rendono poco, proporre fix, applicarli ai Suoi prodotti e al Suo tema Shopify e rinviare gli URL per l’indicizzazione — tutto in un’unica sessione.

L’opzione mantenuta più attivamente è mcp-gsc di AminForou. Se ha uvx installato (l’equivalente Python di npx), il setup più semplice è:

claude mcp add gsc -- uvx --from git+https://github.com/AminForou/mcp-gsc mcp-gsc

Le servirà anche un service account Google con accesso in lettura alla Sua proprietà Search Console:

Vada su Google Cloud Console, crei un progetto e abiliti la Search Console API e (opzionalmente) la Web Search Indexing API.
Crei un service account, generi una chiave JSON e la scarichi.
In Search Console, aggiunga l’email del service account come utente sulla Sua proprietà con almeno accesso Limitato.
Imposti il path di quella chiave JSON come variabile d’ambiente all’avvio dell’MCP.

Se invece vuole una strada no-code, Better Search Console (di Houtini) e il connettore MCP hosted di Windsor.ai offrono entrambi percorsi di setup più facili — Better Search Console è particolarmente comodo perché sincronizza i Suoi dati in un database SQLite locale, il che significa che Claude può eseguire query SQL vere sui Suoi dati storici invece di essere limitato al tetto di 1.000 righe per richiesta della Search Console API.

Tre workflow che può eseguire dal primo giorno

Il setup è la parte noiosa. Ecco cosa rende l’intera operazione degna dell’ora che ha appena investito.

Workflow 1: riscrittura SEO di massa dei prodotti che rendono poco

Apra Claude Code e digiti:

«Usa l’MCP di GSC per trovare le 20 pagine prodotto del mio store con il maggior numero di impressioni ma il CTR più basso negli ultimi 28 giorni. Per ciascuna, estrai il title e la meta description attuali da Shopify, guarda le query di ricerca reali per cui quelle pagine compaiono e riscrivi title e meta description per allinearli meglio all’intento di ricerca. Non pubblicare nulla — prepara tutte le modifiche come una lista che posso rivedere.»

Cosa succede dietro le quinte: Claude chiama l’MCP di GSC per estrarre le search analytics, chiama l’MCP Shopify per recuperare i campi SEO attuali di ogni prodotto, usa il proprio ragionamento per redigere versioni migliorate e le stampa in una tabella che Lei può approvare. Quando dice «vanno bene, applicale», pubblica le modifiche tramite l’MCP Shopify.

È il tipo di task che a un SEO umano porta via un intero pomeriggio. Claude lo fa in circa 4 minuti. Il costo: all’incirca 0,30-0,80 $ di consumo API Claude per 20 prodotti.

Workflow 2: generare hero image lifestyle per una nuova collezione

«Ho appena creato una nuova collezione chiamata “Spring Linen”. Estrai gli 8 prodotti che contiene da Shopify, leggi le descrizioni prodotto, poi genera una hero image lifestyle per ogni prodotto usando Nano Banana — luce mattutina naturale, interno scandinavo, stile visivo coerente su tutti e 8 così sembrano una campagna. Salvale in una cartella locale e prepara una bozza per caricarle come immagini prodotto principali, ma non pubblicare finché non confermo.»

Claude legge i Suoi prodotti tramite l’MCP Shopify, costruisce prompt descrittivi usando gli attributi reali del prodotto (colore, materiale, dimensioni), genera le immagini con Nano Banana seguendo istruzioni di stile coerenti, le salva in locale e prepara il caricamento. Costo totale per 8 immagini ad alta risoluzione: circa 0,30-1,20 $ a seconda del tier di risoluzione.

La cosa che prima era impossibile — mantenere uno stile visivo coerente su un set di più prodotti — è esattamente quella per cui è stata costruita la coerenza di personaggi/oggetti di Nano Banana 2. È qui che si vede davvero sul Suo conto economico.

Workflow 3: controllo quotidiano dello stato SEO

Aggiunga un’istruzione salvata al Suo progetto Claude Code — un file CLAUDE.md nella cartella del progetto — che dica:

«Ogni mattina, quando apro questo progetto, esegui un controllo dello stato di Search Console: estrai i clic di ieri rispetto alla media dei 7 giorni precedenti, segnala ogni pagina che è calata di oltre il 30%, verifica lo stato di indicizzazione di qualsiasi nuovo prodotto aggiunto nelle ultime 48 ore e avvisami se l’invio di una sitemap è fallito. Poi proponi fix specifici.»

Ora ogni volta che avvia una sessione Claude Code, lo fa in automatico. È la cosa più vicina ad avere un SEO junior che non dimentica mai e non prende mai un giorno libero.

Aspettative di costo (realistiche, non marketing)

Per uno store Shopify piccolo o medio che fa girare questo stack in modo attivo:

Consumo Claude Code (Anthropic): 20-80 $/mese a seconda di quanto spesso lo usa. La maggior parte dei merchant si attesta sui 30-50 $.
Nano Banana (API Gemini): 5-25 $/mese per esigenze di product photography tipiche.
Google Search Console MCP: gratuito (usa il Suo account Google esistente).
Shopify Dev MCP: gratuito.
MCP dello store Shopify: gratuito se self-hosted, ~20-50 $/mese se usa Composio.

Quindi una cifra tra i 25 e i 150 $ al mese, tutto compreso, per sostituire task che prima portavano via 10-20 ore a settimana di lavoro manuale o un VA part-time da 600-1.200 €/mese.

Consigli di sicurezza (legga questo prima di eseguire qualsiasi cosa)

Qualche regola che ho imparato a mie spese lavorando con i merchant su questo stack:

Non dia mai a un MCP scope di scrittura che non affiderebbe a uno stagista al primo giorno. Parta in sola lettura, osservi cosa fa Claude, poi ampli i permessi man mano che costruisce fiducia. Gli scope può sempre aggiungerli dopo. Una collezione di prodotti cancellata non la può recuperare.
Usi sempre la modalità staging o bozza nelle prime settimane. Dica a Claude in modo esplicito di «preparare tutto come bozza e lasciarmi rivedere prima di pubblicare». La maggior parte delle risorse Shopify supporta gli stati di bozza.
Tenga un export di backup dei Suoi prodotti. Esegua l’export prodotti integrato di Shopify ogni settimana. Cinque minuti di assicurazione contro un prompt sbagliato.
Usi un file CLAUDE.md nella cartella del progetto per documentare il Suo brand voice, gli argomenti off-limits, le Sue regole di prezzo e qualsiasi vincolo. Claude lo legge all’avvio di ogni sessione. Senza, otterrà output incoerenti che con il tempo si allontanano dal Suo brand.
Verifichi gli MCP che installa. Girano sulla Sua macchina con accesso al Suo store. Si attenga a progetti mantenuti attivamente da autori credibili. Controlli le stelle su GitHub, la data dell’ultimo commit e se chi lo mantiene risponde alle issue.

Cosa cambia davvero per il Suo store

La promessa onesta non è «l’AI sostituisce il Suo team». È che il noioso 70% del gestire uno store online — gli aggiornamenti SEO, i refresh delle immagini, le sweep dell’inventario, le riscritture delle descrizioni — diventa qualcosa che Lei supervisiona invece di qualcosa che fa. Si riprende i weekend, e le parti del business che hanno davvero bisogno di una persona (posizionamento, rapporti con i fornitori, empatia con i clienti, decisioni di brand) ricevono più della Sua attenzione, perché non vengono più soffocate dal lavoro di routine.

Non è una previsione sul futuro del lavoro. È uno stack che può installare questo pomeriggio.

FAQ

Devo saper programmare? No. Tutto in questa guida usa comandi da terminale da copia-incollare. Le basta sapere aprire un terminale e incollare una riga — tutto qui. Claude Code gestisce le parti tecniche.

Quanto costa lo stack completo al mese? Tra i 25 e i 150 $ a seconda dell’uso. La maggior parte dei piccoli store Shopify si attesta sui 50-80 $/mese. Questo sostituisce 10-20 ore di lavoro manuale a settimana.

È sicuro dare a Claude Code accesso al mio store live? Sì, con qualche precauzione. Parta da scope in sola lettura, usi la modalità bozza per tutte le modifiche e tenga backup settimanali dei prodotti. Ampli i permessi gradualmente man mano che costruisce fiducia.

Quale piano Shopify mi serve? Qualsiasi piano che supporti le custom app — cioè tutti i piani a pagamento. Il Dev MCP funziona con qualsiasi piano. L’MCP per la gestione dello store richiede la funzionalità delle custom app.

Posso usarlo con più store Shopify? Sì. Aggiunga un’istanza MCP separata per ogni store con credenziali diverse. Claude Code può passare dall’uno all’altro nella stessa sessione.

E se un server MCP smette di funzionare? I server MCP sono mantenuti dalla community. Se uno si rompe dopo un aggiornamento delle API Shopify, può rimuoverlo temporaneamente con claude mcp remove [name] e riaggiungerlo quando è aggiornato. Il Shopify Dev MCP è ufficiale e mantenuto da Shopify.

Le serve una mano con la configurazione?

Se è arrivato a metà di questa guida e ha sbattuto contro un muro — problemi di path su Windows, grane con OAuth, server MCP che si rifiutano di caricarsi — è normale. La prima installazione è la più difficile.

In areza.digital configuriamo esattamente questo stack per i merchant Shopify europei, come servizio prodotto. Ci occupiamo noi dell’auth, della rotazione delle credenziali, del setup del brand nel CLAUDE.md e dei primi tre workflow di automazione su misura per il Suo store. Lei se ne va con un sistema funzionante e una call di formazione di 30 minuti per gestirlo da solo. I merchant Shopify nordici in particolare — AOV alto, acquirenti che tollerano l’inglese, quota Google da monopolio — vedono qui un effetto composto sproporzionato; l’economia per ogni verticale è sulla nostra pagina di mercato per l’e-commerce DTC in Svezia.

Prenoti una discovery call di 30 minuti →

Scritto da Nikita Janockin, founder di areza.digital. Fonti: documentazione ufficiale Shopify Dev, documentazione Anthropic Claude Code, Google AI Studio, AminForou/mcp-gsc, GeLi2001/shopify-mcp, ConechoAI/Nano-Banana-MCP, Composio e test diretti su store Shopify live. Ultimo aggiornamento 8 aprile 2026.