Automazione

Come gestire il tuo negozio Shopify da Claude Code: Guida alla configurazione per commercianti non tecnici

8 aprile 2026

Se gestisce un negozio Shopify e ha osservato la conversazione sull'AI da bordo campo chiedendosi quando diventerà davvero utile per Lei — non per gli sviluppatori, non per il "futuro sé che imparerà a programmare", ma per l'operatore concreto che aggiorna i prodotti e scrive descrizioni un martedì pomeriggio — quel momento è adesso.

Negli ultimi sei mesi, tre cose sono diventate vere contemporaneamente:

Claude Code di Anthropic (lo strumento da terminale che permette a Claude di agire concretamente sul suo computer invece di limitarsi a parlarne) è diventato abbastanza stabile da essere usato in sicurezza anche da chi non è sviluppatore.
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 API.
L'ecosistema MCP è esploso — esistono ora server community per gestire il negozio Shopify, generare immagini con Google Nano Banana, 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ò digitare "trova i 20 prodotti con il CTR più basso in Search Console, riscrivi le loro meta description, genera nuove immagini hero lifestyle per i primi 5 e metti tutto in bozza così posso revisionare prima della pubblicazione" — e allontanarsi mentre il sistema lavora.

Questa guida La porta da zero software installato esattamente a quel flusso di lavoro. È scritta per un commerciante Shopify che sa copiare e incollare comandi ma non scrive codice. Tempo totale di configurazione: circa 60–90 minuti la prima volta. Dopo, ogni nuova automazione richiede pochi minuti.

Cosa avrà alla fine

Al termine di questa guida, avrà Claude Code in esecuzione sul suo computer con quattro superpoteri connessi:

Shopify Dev MCP — documentazione ufficiale Shopify e conoscenza API integrata, così Claude non inventa mai campi inesistenti o sintassi obsoleta
Un MCP per la gestione del negozio Shopify — controllo reale su prodotti, ordini, clienti, collezioni e immagini del suo negozio live
Nano Banana MCP — generazione e modifica di immagini con Google Gemini (lo stesso modello alla base di alcune delle migliori fotografie AI di prodotto viste quest'anno)
Google Search Console MCP — dati SEO live che Claude può leggere e su cui può agire senza che Lei debba esportare CSV

Questo è il ciclo completo: vedere cosa non funziona, correggerlo, generare gli asset, pubblicare su Shopify, verificare in Search Console. Tutto da una sola finestra di chat.

Perché questo è rilevante adesso (Contesto aprile 2026)

Alcune cose da sapere prima di iniziare, perché il panorama è cambiato nell'ultimo trimestre e la maggior parte dei tutorial online è obsoleta:

Dal 1° gennaio 2026, le nuove app Shopify vengono create nel Dev Dashboard e usano le credenziali OAuth client (un client ID e un secret) invece dei vecchi token statici shpat_. Se ha seguito un tutorial più vecchio che le dice di copiare un token shpat_xxxxx, funzionerà solo per le app personalizzate legacy. Le nuove configurazioni usano coppie clientId/clientSecret, e il server MCP le scambia automaticamente con token a breve scadenza.
La versione API Shopify predefinita 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) è ora il default per la maggior parte degli MCP per immagini — offre qualità Pro alla velocità Flash e costa circa $0,04–$0,05 per immagine alla 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 Shopify e agli schemi API. Non controlla il suo negozio. Per le azioni reali sul negozio (creare prodotti, aggiornare prezzi, gestire collezioni) ha bisogno di un MCP community separato. Installeremo entrambi.

Chiaro? Bene. Iniziamo la configurazione.

Passo 1: Installare le fondamenta (Node.js e Claude Code)

Avrà bisogno di Node.js 18 o superiore per quasi tutto in questo stack. Se non lo ha mai installato:

Vada su nodejs.org e scarichi la versione LTS per il suo sistema operativo.
Esegua il programma di installazione con le impostazioni predefinite.
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 effettuare il login:

claude

Si aprirà un browser, le chiederà di accedere al suo account Anthropic, e tornerà al terminale con una sessione Claude Code funzionante. Digiti /exit per uscire per il momento.

Attenzione: Claude Code su Windows può essere problematico con i server MCP — molti server community assumono percorsi Mac/Linux. Se è su Windows e questa è la prima volta, la strada più agevole è installare WSL2 (Windows Subsystem for Linux) e fare tutto dall'interno di Ubuntu. Richiede 15 minuti in più ma risparmia ore di debug.

Passo 2: Installare la Shopify CLI

La Shopify CLI è lo strumento ufficiale da riga di comando per lavorare con temi, app e dati del negozio. Claude Code la utilizzerà internamente.

npm install -g @shopify/cli@latest

Verifichi con shopify version — dovrebbe vedere un numero di versione. Se vuole effettuare il login al suo negozio adesso (opzionale ma utile), esegua shopify auth login e segua il prompt nel browser.

Passo 3: Aggiungere l'MCP ufficiale Shopify Dev

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

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

È tutto. Riavvii Claude Code (/exit poi claude di nuovo), e potrà immediatamente chiedere cose come:

"Mostrami la mutation GraphQL per aggiornare il metafield di un prodotto nella versione API 2026-01"
"Quali scope ha bisogno la mia app per leggere gli ordini bozza?"

L'MCP Dev include uno strumento chiamato learn_shopify_api che deve essere chiamato prima di qualsiasi altro strumento Shopify in una data conversazione — genera un conversationId di cui gli altri strumenti hanno bisogno. Claude lo sa e lo chiamerà automaticamente. Non deve preoccuparsene.

Passo 4: Aggiungere un MCP per la gestione del negozio Shopify

Questo è l'MCP che fa cose concretamente nel suo negozio — crea prodotti, aggiorna l'inventario, gestisce ordini e collezioni. Ci sono due percorsi principali.

Opzione A: MCP Community (gratuito, più configurazione)

L'opzione open-source più popolare è shopify-mcp di GeLi2001. È un pacchetto Node, gira in locale e supporta sia i token di accesso legacy che le nuove credenziali OAuth client.

Per le nuove app Shopify (dopo gennaio 2026):

Dal pannello admin Shopify, vada su Impostazioni > App e canali di vendita > Sviluppa app (o il nuovo Dev Dashboard se il suo negozio lo ha abilitato).
Crei un'app personalizzata, configuri gli scope API che vuole dare a Claude (inizi in piccolo — read_products, write_products, read_orders è un trio sensato per iniziare), 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à automaticamente quelle credenziali con token a breve scadenza (validi per ~24 ore).

Per le app personalizzate legacy con token statico shpat_:

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

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

Opzione B: Composio (a pagamento, quasi nessuna configurazione)

Se i comandi da terminale Le provocano ansia, Composio offre un MCP hosted che gestisce tutto il processo OAuth per Lei. Accede una volta su composio.dev, connette il suo negozio Shopify tramite la loro interfaccia, e le forniscono un singolo URL MCP da aggiungere a Claude Code. Costa denaro ma risparmia circa un'ora di configurazione. Per i commercianti che gestiscono più negozi o che non vogliono gestire le credenziali manualmente, ne vale la pena.

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

Passo 5: Aggiungere Nano Banana per la generazione di immagini AI

Nano Banana è il nome amichevole per i modelli di generazione immagini Gemini di Google. Nano Banana 2 (Gemini 3.1 Flash Image) è il default attuale — offre output fino a 4K, coerenza dei soggetti tra più generazioni e una resa nitida del testo nelle immagini, che è la parte che rende finalmente l'AI utilizzabile per la fotografia di prodotto reale.

Avrà prima bisogno di 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 che la fatturazione sia abilitata — i modelli di testo sono gratuiti, ma la generazione di immagini è a consumo. Non c'è un minimo mensile.

Quindi 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 potrà ora chiedere cose come:

"Genera un'immagine hero per la nuova collezione di tende in lino — luce mattutina naturale che entra da una finestra in un soggiorno scandinavo, tonalità beige calde, formato 16:9, 4K"
"Prendi questa foto prodotto e modificala per mostrare la tenda su un colore di parete diverso"

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

Passo 6: Aggiungere l'MCP di Google Search Console

Qui si chiude il ciclo SEO. Con Claude Code che legge i dati live di Search Console, può identificare le pagine con prestazioni insufficienti, proporre correzioni, applicarle ai prodotti e al tema Shopify, e reinviare gli URL per l'indicizzazione — tutto in un'unica sessione.

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

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

Avrà anche bisogno di un account di servizio 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 account di servizio, generi una chiave JSON e la scarichi.
In Search Console, aggiunga l'email dell'account di servizio come utente sulla sua proprietà con almeno accesso Limitato.
Imposti il percorso a quella chiave JSON come variabile d'ambiente all'avvio dell'MCP.

Se preferisce una strada senza codice, Better Search Console (di Houtini) e il connettore MCP hosted di Windsor.ai offrono entrambi percorsi di configurazione più semplici — Better Search Console è particolarmente comodo perché sincronizza i suoi dati in un database SQLite locale, il che significa che Claude può eseguire vere query SQL sui suoi dati storici invece di essere limitato al limite di 1.000 righe per richiesta dell'API Search Console.

Tre flussi di lavoro che può usare dal primo giorno

La configurazione è la parte noiosa. Ecco cosa rende tutto ciò degno dell'ora appena trascorsa.

Flusso di lavoro 1: Riscrittura SEO in blocco dei prodotti con prestazioni insufficienti

Apra Claude Code e digiti:

"Usa l'MCP GSC per trovare le 20 pagine prodotto del mio negozio con le impressioni più alte ma il CTR più basso negli ultimi 28 giorni. Per ognuna, estrai il titolo e la meta description attuali da Shopify, guarda le query di ricerca effettive per cui quelle pagine appaiono e riscrivi titolo e meta description per adattarli meglio all'intento di ricerca. Non pubblicare nulla — metti tutte le modifiche in bozza come elenco che possa revisionare."

Cosa succede in background: Claude chiama l'MCP GSC per estrarre le analisi delle ricerche, chiama l'MCP Shopify per recuperare i campi SEO attuali di ogni prodotto, usa il proprio ragionamento per elaborare versioni migliorate, e le presenta in una tabella per la sua approvazione. Quando dice "sembra bene, applicale", invia le modifiche tramite l'MCP Shopify.

Questo è il tipo di attività che richiede a un SEO umano un intero pomeriggio. Claude la completa in circa 4 minuti. Il costo: circa $0,30–$0,80 di utilizzo API Claude per 20 prodotti.

Flusso di lavoro 2: Generare immagini hero lifestyle per una nuova collezione

"Ho appena creato una nuova collezione chiamata 'Lino Primavera'. Estrai gli 8 prodotti in essa da Shopify, leggi le descrizioni dei prodotti, poi genera un'immagine hero lifestyle per ogni prodotto usando Nano Banana — luce mattutina naturale, interni scandinavi, stile visivo coerente tra tutti e 8 in modo che sembrino una campagna. Salvale in una cartella locale e prepara una bozza per caricarle come immagini primarie dei prodotti, ma non pubblicare finché non confermo."

Claude legge i suoi prodotti tramite l'MCP Shopify, crea prompt descrittivi usando gli attributi reali del prodotto (colore, materiale, dimensioni), genera le immagini tramite Nano Banana con 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 livello di risoluzione.

La cosa che prima era impossibile — mantenere uno stile visivo coerente su un insieme di prodotti multipli — è esattamente ciò per cui è stata costruita la coerenza soggetto/oggetto di Nano Banana 2. È qui che si riflette concretamente sul suo fatturato.

Flusso di lavoro 3: Controllo giornaliero della salute SEO

Aggiunga un'istruzione salvata al suo progetto Claude Code — un file CLAUDE.md nella cartella del progetto — che dice:

"Ogni mattina quando apro questo progetto, esegui un controllo della salute di Search Console: estrai i click di ieri rispetto alla media degli ultimi 7 giorni, segnala qualsiasi pagina che sia scesa di più del 30%, controlla lo stato di indicizzazione di eventuali nuovi prodotti aggiunti nelle ultime 48 ore, e avvisami se qualche invio di sitemap è fallito. Poi proponi correzioni specifiche."

Ora ogni volta che avvia una sessione Claude Code, lo fa automaticamente. Questo è l'equivalente più vicino ad avere un SEO junior che non dimentica mai e non prende mai un giorno libero.

Aspettative di costo (realistiche, non di marketing)

Per un negozio Shopify di piccole-medie dimensioni che usa attivamente questo stack:

Utilizzo Claude Code (Anthropic): $20–80/mese a seconda della frequenza d'uso. La maggior parte dei commercianti si attesta intorno a $30–50.
Nano Banana (API Gemini): $5–25/mese per le normali esigenze di fotografia di prodotto.
MCP Google Search Console: Gratuito (usa il suo account Google esistente).
Shopify Dev MCP: Gratuito.
MCP per il negozio Shopify: Gratuito se self-hosted, ~$20–50/mese se usa Composio.

Quindi qualcosa tra $25 e $150 al mese, in totale, per sostituire attività che richiedevano 10–20 ore alla settimana di lavoro manuale o un VA part-time a €600–1200/mese.

Consigli di sicurezza (da leggere prima di avviare qualsiasi cosa)

Alcune regole che ho imparato lavorando con i commercianti su questo stack:

Non dare mai a un MCP scope di scrittura che non affiderebbe a un tirocinante il primo giorno. Inizi con sola lettura, osservi cosa fa Claude, poi espanda i permessi man mano che cresce la fiducia. Può sempre aggiungere scope in seguito. Non può annullare l'eliminazione di una collezione prodotti.
Usi sempre la modalità staging o bozza per le prime settimane. Dica a Claude esplicitamente di "mettere tutto in bozza e permettermi di revisionare prima della pubblicazione." La maggior parte delle risorse Shopify supporta gli stati bozza.
Mantenga un export di backup dei suoi prodotti. Esegua l'export prodotti integrato di Shopify settimanalmente. Cinque minuti di assicurazione contro un prompt sbagliato.
Usi un file CLAUDE.md nella cartella del progetto per documentare la voce del suo brand, gli argomenti off-limits, le regole sui prezzi e qualsiasi vincolo. Claude lo legge all'inizio di ogni sessione. Senza di esso, otterrà output inconsistente che si allontana dal suo brand nel tempo.
Verifichi gli MCP che installa. Girano sulla sua macchina con accesso al suo negozio. Si attenga a progetti attivamente mantenuti da autori credibili. Controlli le stelle GitHub, la data dell'ultimo commit e se il maintainer risponde alle segnalazioni.

Cosa cambia davvero per il suo negozio

Il messaggio onesto non è "l'AI sostituisce il suo team." È che il noioso 70% della gestione di un negozio online — gli aggiornamenti SEO, i refresh delle immagini, le revisioni dell'inventario, le riscritture delle descrizioni — diventa qualcosa che Lei supervisiona invece di qualcosa che Lei fa. Recupera i suoi weekend, e le parti dell'azienda che richiedono davvero un essere umano (il posizionamento, le relazioni con i fornitori, l'empatia verso il cliente, le decisioni di brand) ricevono più attenzione perché non vengono più soffocate dal lavoro di routine.

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

Domande frequenti

Ho bisogno di saper programmare? No. Tutto in questa guida usa comandi da copiare e incollare nel terminale. Deve essere a proprio agio nell'aprire un terminale e incollare una riga — questo è tutto. Claude Code gestisce le parti tecniche.

Quanto costa l'intero stack al mese? Tra $25 e $150 a seconda dell'utilizzo. La maggior parte dei piccoli negozi Shopify si attesta intorno a $50–80/mese. Questo sostituisce 10–20 ore di lavoro manuale settimanale.

È sicuro dare a Claude Code accesso al mio negozio live? Sì, con le dovute precauzioni. Inizi con scope di sola lettura, usi la modalità bozza per tutte le modifiche, e mantenga backup settimanali dei prodotti. Espanda i permessi gradualmente man mano che cresce la fiducia.

Quale piano Shopify è necessario? Qualsiasi piano che supporti le app personalizzate — ovvero tutti i piani a pagamento. L'MCP Dev funziona con qualsiasi piano. L'MCP per la gestione del negozio ha bisogno della funzionalità app personalizzate.

Posso usare questo con più negozi Shopify? Sì. Aggiunga un'istanza MCP separata per ogni negozio con credenziali diverse. Claude Code può passare da uno all'altro nella stessa sessione.

Cosa succede se un server MCP smette di funzionare? I server MCP sono mantenuti dalla community. Se uno si rompe dopo un aggiornamento API Shopify, può rimuoverlo temporaneamente con claude mcp remove [name] e aggiungerlo di nuovo una volta aggiornato. Lo Shopify Dev MCP è ufficiale ed è mantenuto da Shopify.

Ha bisogno di aiuto per la configurazione?

Se è arrivato a metà di questa guida e si è bloccato — problemi di percorso su Windows, grattacapi con OAuth, server MCP che si rifiutano di caricarsi — è normale. La prima installazione è la più difficile.

Da areza.digital, configuriamo esattamente questo stack per i commercianti Shopify europei come servizio strutturato. Gestiamo l'autenticazione, la rotazione delle credenziali, la configurazione del brand in CLAUDE.md e i primi tre flussi di lavoro automatizzati su misura per il suo negozio. Se ne va con un sistema funzionante e una chiamata di formazione di 30 minuti per poterlo gestire da solo.

Prenota una chiamata conoscitiva di 30 minuti →

Scritto da Nikita Janochkin, fondatore 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 negozi Shopify live. Ultimo aggiornamento: 8 aprile 2026.

Smetti di perdere lead a causa di un sito lento

Prenota un audit di attrito gratuito e scopri esattamente dove il tuo sito perde denaro.

Prenota una chiamata →