Sette attività concrete che un assistente AI svolge tramite il server MCP di Shopware, con prompt di esempio, strumenti, permessi ed errori tipici.
Con il server MCP di Shopware, un assistente AI come Claude o ChatGPT svolge attività reali nello shop: creare report, controllare le giacenze, trovare clienti, registrare spedizioni, completare testi prodotto, creare articoli e modificare impostazioni. Dalla versione 6.7.14 il server fa parte stabilmente del core di Shopware e lavora con i permessi di un’integrazione che Lei crea nell’Amministrazione.
Ogni modifica viene eseguita prima come anteprima. Shopware la chiama dry run: il modello mostra cosa cambierebbe e scrive solo dopo una seconda chiamata confermata. L’unica eccezione è il caricamento delle immagini, che salva subito.
Il valore dipende meno dall’AI che da ruoli ben definiti. Chi crea per ogni attività un’integrazione separata con una allowlist ristretta può usare le attività di sola lettura dal primo giorno e concedere i permessi di scrittura passo dopo passo.
Questo articolo si rivolge a titolari di shop, responsabili e-commerce e responsabili del servizio clienti che gestiscono uno shop Shopware 6.7 e vogliono sapere quale lavoro un assistente AI può svolgere oggi in concreto. Le basi del protocollo, dei client e della configurazione sono spiegate nel nostro articolo Server MCP per Shopware. Qui parliamo di pratica: sette attività, ciascuna con un prompt di esempio, gli strumenti in background, i permessi necessari e i punti a cui prestare attenzione.
Il server MCP è un’interfaccia nello shop tramite cui un assistente AI legge i dati e, dopo l’approvazione, li modifica. Funziona all’indirizzo /api/_mcp e usa la Admin API, l’interfaccia di gestione di Shopware. Shopware lo ha introdotto con la versione 6.7.11 dietro un feature flag, dalla 6.7.14 è sempre attivo. Secondo le release notes, la versione 6.7.16 di novembre 2026 migliora tra l’altro la gestione delle risposte molto grandi degli strumenti. Fino a Shopware 6.8 il server è considerato sperimentale, quindi i nomi degli strumenti possono ancora cambiare.
Shopware non fornisce comandi speciali come “report giornaliero” o “cerca cliente”. Offre strumenti generici che lavorano con qualsiasi entità, cioè con ogni tipo di dato come prodotto, ordine o cliente:
shopware-entity-search cerca record, shopware-entity-read legge un singolo record, shopware-entity-schema mostra i campi di un’entità.shopware-entity-aggregate calcola somme, medie, conteggi e andamenti direttamente in Shopware, senza trasferire righe.shopware-entity-upsert crea o aggiorna, shopware-entity-delete elimina, entrambi come anteprima per impostazione predefinita.shopware-order-state cambia lo stato di ordine, pagamento e consegna, shopware-media-upload carica immagini da un URL, shopware-system-config-read e shopware-system-config-write leggono e modificano le impostazioni, shopware-theme-config il tema.A questi si aggiungono resources con dati di riferimento come shopware://sales-channels, shopware://currencies o shopware://state-machines. Da qui il modello legge, per esempio, quali cambi di stato sono consentiti per un ordine.
MCP è pensato per il dialogo. Shopware limita le chiamate all’endpoint admin a 300 al minuto e 1.000 ogni dieci minuti. Per importare 20.000 prezzi resta valida la Sync API tramite la Shopware Admin API. Anche i processi che girano di notte senza persone vanno in un’interfaccia o in un workflow, non in una chat.
L’attività più frequente è anche la più sicura: chiedere numeri. Oggi in molti shop significa esportare gli ordini, filtrare in Excel e costruire una tabella pivot. Con MCP Lei pone la domanda direttamente.
Prompt di esempio: “Quanto fatturato abbiamo fatto ieri per canale di vendita, quanti ordini sono stati e qual è stato lo scontrino medio? Confronta con lo stesso giorno della settimana scorsa.”
Il modello legge i canali di vendita dalla resource, chiama shopware-entity-aggregate sull’entità order e calcola somma e media di amountTotal più un conteggio, filtrati per data. Il confronto settimanale aggiunge una seconda chiamata. Shopware restituisce solo i risultati, non i singoli ordini. Questo mantiene la risposta compatta e protegge i dati dei clienti.
L’integrazione ha bisogno solo dei permessi di lettura su ordini e canali di vendita. Nella allowlist bastano shopware-entity-schema, shopware-entity-search e shopware-entity-aggregate. Gli strumenti di scrittura mancano del tutto.
Chi gestisce un proprio magazzino perde fatturato con gli scaffali vuoti e capitale con quelli pieni. Un assistente AI non sostituisce un gestionale di magazzino, ma fornisce in pochi secondi un elenco che altrimenti qualcuno dovrebbe filtrare e ordinare.
Prompt di esempio: “Mostra tutti i prodotti attivi con giacenza inferiore a 10, ordinati per quantità venduta negli ultimi 30 giorni. Per ogni prodotto stima per quanti giorni basta ancora la giacenza.”
Il modello cerca con shopware-entity-search i prodotti con i filtri active e stock inferiore a 10. La quantità venduta la ricava da un’aggregazione sulle righe d’ordine. La copertura la calcola il modello stesso: giacenza divisa per le vendite medie giornaliere. Questo calcolo va compreso, perché non proviene da Shopware.
Bastano i permessi di lettura su prodotti e ordini. Se il modello deve anche correggere la giacenza dopo una consegna, si aggiunge shopware-entity-upsert con diritto di modifica sui prodotti. Nella pratica lo separiamo in un’integrazione dedicata al magazzino.
Nel servizio clienti non è la risposta a richiedere tempo, ma la raccolta delle informazioni: trovare l’account, aprire l’ordine, controllare lo stato del pagamento, copiare il numero di tracking. È proprio questo che l’assistente fa al posto Suo.
Prompt di esempio: “Cerca la cliente con il numero d’ordine 10482. Riassumi i suoi ultimi tre ordini con data, articoli, stato del pagamento, stato della consegna e numero di tracking.”
Il modello cerca l’ordine con shopware-entity-search, lo legge con shopware-entity-read insieme a righe, pagamenti e consegne e poi cerca altri ordini dello stesso cliente. Dal risultato scrive una breve sintesi su cui il Suo team basa la risposta.
Permessi di lettura su ordine, cliente e consegna, più i tre strumenti di lettura. Shopware raccomanda espressamente per questo caso un’integrazione in sola lettura. Il motivo è la prompt injection: note d’ordine, nomi dei clienti o righe di indirizzo provengono dai clienti e possono contenere testo che cerca di spingere il modello verso altre azioni. I permessi limitano il danno, ma non impediscono l’inganno.
Da qui in poi l’assistente modifica i dati. L’attività è comunque adatta per iniziare presto, perché lo strumento shopware-order-state conosce solo i cambi di stato che Shopware consente comunque.
Prompt di esempio: “Imposta la consegna degli ordini da 10501 a 10512 su spedita. Mostrami prima l’elenco con lo stato attuale.”
Il modello legge le transizioni consentite da shopware://state-machines e chiama shopware-order-state con deliveryAction: ship, prima con dryRun=true. Lei vede quali ordini cambierebbero e come. Solo dopo la Sua conferma segue la stessa chiamata con dryRun=false. Una chiamata può cambiare insieme stato dell’ordine, del pagamento e della consegna, per esempio in caso di annullamento con rimborso.
Il ruolo ha bisogno di order:read e, a seconda dell’azione, dei diritti di modifica su ordine, pagamento o consegna. Chi può solo registrare le spedizioni riceve solo order_delivery:update. Un annullamento si blocca così già sui permessi, non solo sull’attenzione di una persona.
In quasi ogni catalogo mancano descrizioni nella seconda lingua, i meta title sono vuoti o duplicati, le proprietà incomplete. Un modello linguistico colma bene queste lacune se riceve indicazioni chiare.
Prompt di esempio: “Trova tutti i prodotti attivi della categoria Mobili da giardino senza meta title. Per i primi 20 proponi un meta title di massimo 60 caratteri, schema: nome prodotto, caratteristica principale, marca. Mostra le proposte in una tabella e non salvare ancora nulla.”
Il modello cerca i prodotti, legge nome, proprietà e descrizione e formula le proposte. Dopo la Sua revisione chiama shopware-entity-upsert, prima come anteprima con i valori vecchi e nuovi, poi con conferma. Per le traduzioni Lei indica la lingua di destinazione e il modello scrive nella traduzione di quella lingua.
Permessi di lettura e modifica sui prodotti, nessun permesso su ordini o clienti. Nella allowlist ci sono gli strumenti di lettura e shopware-entity-upsert, ma non shopware-entity-delete.
La nuova merce arriva spesso come foglio di calcolo dal fornitore: codice articolo, nome, prezzo d’acquisto, prezzo consigliato, URL dell’immagine. Creare ogni articolo nell’Amministrazione richiede qualche minuto. Per pochi articoli un’interfaccia di importazione non conviene, ma con 15 articoli a settimana l’assistente sì.
Prompt di esempio: “Crea questi otto articoli come prodotti inattivi: nome, numero prodotto, giacenza 0, produttore Giardinoforte, aliquota IVA 22 per cento, prezzo lordo dalla tabella. Mostrami prima l’anteprima. Poi carica l’immagine dalla colonna URL immagine come immagine di copertina.”
Shopware lavora internamente con gli ID. Il modello cerca quindi prima l’ID dell’aliquota e del produttore, legge la valuta da shopware://currencies e poi costruisce la chiamata a shopware-entity-upsert. L’anteprima mostra ogni articolo con tutti i campi. Dopo l’approvazione, shopware-media-upload carica le immagini e le imposta come copertina.
Creare e modificare prodotti, leggere aliquote, produttori e valute, più media:create per il caricamento. Poiché il caricamento salva senza anteprima, solo questa integrazione riceve lo strumento media.
Le impostazioni di sistema di Shopware sono numerose e distribuite. Chi vuole sapere quanti prodotti mostra una pagina di categoria o quale ordinamento è predefinito deve passare per diversi menu. L’assistente lo legge in un solo passaggio.
Prompt di esempio: “Quali impostazioni valgono per gli elenchi prodotti nel canale di vendita Storefront IT? Cambia l’ordinamento predefinito in prezzo crescente, ma mostrami prima cosa cambia.”
shopware-system-config-read legge tutti i valori sotto la chiave core.listing, se richiesto per un canale di vendita specifico. Per la modifica, shopware-system-config-write mostra nel dry run un confronto prima e dopo. Dopo la conferma salva il nuovo valore. Per logo e colori c’è shopware-theme-config, anch’esso con anteprima.
system_config:read per leggere, system_config:update per modificare. Questi permessi vanno in un’integrazione per una persona che già oggi gestisce le impostazioni, di solito il responsabile dello shop o l’agenzia che lo segue.
La decisione più importante arriva prima del primo prompt: quale integrazione può fare cosa? Shopware consiglia un’integrazione per ogni attività o ruolo nel team. La tabella mostra come suddividiamo le sette attività nei progetti.
| Attività | Integrazione | Strumenti nella allowlist | Scrive dati |
|---|---|---|---|
| 1 Report giornaliero | Analisi | schema, search, aggregate | no |
| 2 Giacenze | Analisi o magazzino | schema, search, aggregate, upsert per il magazzino | solo magazzino |
| 3 Servizio clienti | Servizio in sola lettura | schema, search, read | no |
| 4 Spedizioni e annullamenti | Servizio stati | search, read, order-state | sì, con anteprima |
| 5 Testi prodotto | Catalogo | schema, search, read, upsert | sì, con anteprima |
| 6 Nuovi articoli | Catalogo | schema, search, read, upsert, media-upload | sì, immagini senza anteprima |
| 7 Impostazioni | Direzione shop | system-config-read, system-config-write | sì, con anteprima |
I tre strumenti di discovery, con cui un client trova altri strumenti e attiva i toolset, si aggiungono a ogni allowlist. Importante: attivare un toolset non concede permessi. Il limite resta la allowlist dell’integrazione. Un accesso MCP non va mai collegato a un account amministratore, perché gli amministratori aggirano la allowlist degli utenti.
Un esempio ipotetico basato sulla nostra esperienza: un retailer con 1.500 ordini al mese prepara ogni lunedì un report settimanale. Oggi richiede 60 minuti, con l’assistente 10. Il servizio clienti gestisce 400 richieste al mese e risparmia circa 2 minuti di ricerca per richiesta. In totale sono poco più di 3 ore per i report e circa 13 ore nel servizio, quindi circa 17 ore al mese.
Dall’altra parte ci sono la configurazione con ruoli, allowlist, modelli di prompt e formazione, che secondo la nostra esperienza costa da 1.500 a 5.000 €, e i costi correnti dei client AI, circa 20 dollari USA per utente al mese per Claude Pro o ChatGPT Plus. Con un costo orario interno di 40 €, una configurazione nella fascia bassa si ripaga in due o tre mesi. Per un piccolo shop con 100 ordini al mese conviene soprattutto la parte in sola lettura, che richiede pochissima configurazione.
Le sette attività funzionano, ma non senza supervisione. Questi sono i limiti che vediamo più spesso nella pratica.
Anche in Italia vale il GDPR: per i dati dei clienti che arrivano a Claude o ChatGPT serve un accordo sul trattamento dei dati ai sensi dell’art. 28. Nella creazione dei prodotti il modello usa le aliquote IVA salvate come regole fiscali in Shopware: 22 per cento ordinaria, ridotte al 10, 5 e 4 per cento. La fatturazione elettronica tramite SDI non passa da MCP: la gestisce il gestionale collegato allo shop, e i cambi di stato di un ordine via MCP devono rispettare quel flusso. Un’agenzia con sede in Italia si trova tramite il filtro per paese nell’elenco dei partner Shopware.
Per i retailer che non vogliono gestire ruoli e prompt propri esistono alternative. Lo Shopware Copilot nell’Amministrazione usa lo stesso endpoint MCP con i permessi dell’utente connesso e chiede conferma prima delle modifiche. Le sue funzioni agentiche fanno parte dell’abbonamento aggiuntivo Intelligence+. Il pacchetto sperimentale SwagMcpMerchantTools offre strumenti pronti come merchant-revenue-report o merchant-customer-lookup, ma Shopware si riserva di eliminarlo a favore del Copilot. Il nostro articolo su Shopware AI offre una panoramica di tutte le funzioni AI di Shopware.
No. Da Shopware 6.7.14 il server MCP fa parte del core ed è sempre attivo. Lei crea un’integrazione con ruolo e allowlist e collega un client come Claude o ChatGPT. Plugin come AI Connect aggiungono viste di anteprima, un audit log e configurazioni pronte.
Solo se Lei lo consente. Tutti gli strumenti di scrittura tranne il caricamento immagini funzionano come anteprima per impostazione predefinita, e client come Claude e ChatGPT sottopongono le chiamate all’approvazione. Chi disattiva entrambe le cose rinuncia al controllo.
Con il report giornaliero. Richiede solo permessi di lettura, è utile dal primo giorno e mostra rapidamente quanto il modello lavora con precisione sui Suoi dati.
Il server MCP nativo manca nella 6.6. È possibile un server MCP separato che comunica tramite la Admin API. Di solito consigliamo l’aggiornamento alla 6.7, perché dopo l’aggiornamento un server separato diventa superfluo.
Il server in sé è gratuito. I costi correnti derivano dai client AI. La configurazione con ruoli, allowlist e formazione costa secondo la nostra esperienza da 1.500 a 5.000 €.
Vuole sapere quale delle sette attività porta più valore nel Suo shop? Verifichiamo la Sua versione di Shopware, proponiamo integrazioni con ruoli e allowlist adeguati e configuriamo i primi modelli di prompt insieme al Suo team. Per anteprime e audit log usiamo il nostro plugin AI Connect.
Ci scriva tramite il modulo di contatto. Se prima vuole sapere a che punto è oggi il Suo shop, la nostra analisi gratuita dello shop La aiuta.
Besnik Bilalli è fondatore e CEO di solution25, l’agenzia Shopware con sede a Brema. Prima di fondare l’agenzia nel 2017 ha costruito in prima persona un negozio online e lo ha portato a oltre 500 ordini al giorno. Da allora accompagna i merchant nei progetti Shopware, dal primo calcolo dei costi alla gestione operativa. Risponde volentieri di persona alle domande sull’articolo: contattaci.
Responsabile di contenuto e aggiornamento: Besnik Bilalli. Aggiornato a: novembre 2026. Prossima revisione dei contenuti: febbraio 2027.