Che cosa Le serve
- Uno shop Shopware dalla versione 6.7.11 (6.7.x).
- Il plugin Shopware Solution25 MCP Workflows dalla versione 1.9.1: [LINK DI DOWNLOAD / SHOPWARE STORE].
- Un account amministratore in questo shop.
- Un client AI che supporti connettori MCP remoti:
- Claude (claude.ai, desktop, mobile, Claude Code);
- ChatGPT;
- l’app Gemini (attualmente per account Google personali negli Stati Uniti, in inglese);
- oppure Gemini CLI.
Passo 1: installare il plugin
- In Shopware apra Estensioni > Le mie estensioni.
- Carichi o installi Solution25 MCP Workflows e lo attivi.
- Con l’attivazione viene acceso il server MCP di Shopware e viene preparato il ruolo per i client AI.
Il plugin crea tre pagine in Impostazioni > Sistema:
- MCP Connector: collegare e gestire i client AI.
- MCP Log: ogni azione di un client AI nel Suo shop.
- MCP Storefront: la ricerca AI opzionale e la chat nella storefront.
Passo 2: aggiungere il connettore nel client AI
L’indirizzo del connettore è:
[https://mcp.solution25.com/shopware]
- Claude (web, desktop, mobile): apra Impostazioni > Connettori.
- Quando il connettore sarà presente nella directory: Sfoglia connettori, poi Solution25 for Shopware, poi Connetti.
- Fino ad allora: Aggiungi connettore personalizzato e incolli l’indirizzo.
- Claude Code: esegua il comando seguente:
claude mcp add --transport http solution25-shopware [https://mcp.solution25.com/shopware]
Poi effettui l’accesso con /mcp.
- ChatGPT: aggiunga un connettore personalizzato (app) con l’indirizzo indicato sopra. [VERIFICARE IL PERCORSO DI MENU ATTUALE E I PIANI SUPPORTATI.]
- App Gemini: apra Impostazioni > App collegate > Aggiungi app personalizzata e incolli l’indirizzo.
- Gemini CLI: aggiunga quanto segue a
~/.gemini/settings.json; Gemini CLI aprirà poi automaticamente la pagina di accesso:
{ "mcpServers": { "shopware": { "httpUrl": "[https://mcp.solution25.com/shopware]" } } }
Passo 3: stabilire che cosa può fare il client AI
Il client AI apre la nostra pagina di accesso, che mostra:
- Un codice di collegamento monouso, valido 30 minuti.
- Le autorizzazioni: per ogni area (Products, Categories, Manufacturers, Media, Reviews, Orders, Customers) sceglie View, Edit, Create o Delete (visualizzare, modificare, creare, eliminare).
- Selezioni predefinite:
- Read only (sola lettura, impostazione predefinita);
- Catalogue editor (gestione del catalogo);
- Order management (gestione degli ordini);
- Everything (tutto).
Lasci la pagina aperta.
Passo 4: confermare il collegamento in Shopware
- In Shopware apra Impostazioni > Sistema > MCP Connector.
- Incolli il codice di collegamento. La pagina mostra:
- quale client AI richiede l’accesso;
- se il suo dominio è verificato;
- dove ritorna l’accesso;
- quali autorizzazioni richiede.
- Verifichi che si tratti della Sua richiesta e clicchi su Connetti.
Il client AI completa l’accesso da solo. Può concedere solo autorizzazioni che possiede Lei stesso.
Utilizzo
Alcuni esempi da provare:
- «Quali prodotti sono esauriti o stanno per finire?»
- «Mostrami gli ordini di oggi e tutto ciò che è bloccato.»
- «Imposta il prezzo di SW10011 a 24,90 e la giacenza a 50.» (Prima vede un’anteprima.)
- «Trova le recensioni in attesa di approvazione.»
- «Mostrami il fatturato di questa settimana rispetto alla precedente.»
Comandi pronti: Daily report (report giornaliero), Weekly sales (vendite settimanali) e Connect another shop (collegare un altro shop). In Claude, ChatGPT e negli altri client che lo supportano, una scheda shop nella chat mostra gli shop collegati e offre il pulsante Add another shop.
Che cosa può fare il client AI
Quali di questi strumenti riceve il client AI dipende dalle autorizzazioni concesse.
| Area |
Strumenti |
| Shop |
Visualizzare gli shop collegati, collegare un altro shop, verificare il collegamento (ping) |
| Prodotti |
Cercare prodotti; creare prodotti; modificare nome, prezzo, giacenza, stato o descrizione; aggiungere immagini da indirizzi web |
| Categorie e produttori |
Cercare categorie; assegnare prodotti alle categorie o rimuoverli; cercare produttori; creare produttori |
| Recensioni |
Trovare recensioni; pubblicarle o nasconderle e impostare la Sua risposta |
| Ordini e clienti |
Cercare ordini, dettagli dell’ordine, report sul fatturato, cercare clienti, dettagli del cliente |
| Processi dello shop (plugin) |
Controllo giornaliero dello shop, report sul rischio di esaurimento scorte, verifica e correzione della qualità del catalogo, report sui problemi degli ordini, piano di risoluzione per gli ordini e relativa esecuzione, diagnosi |
Come le modifiche restano sicure
- Prima l’anteprima: ogni modifica è inizialmente un’anteprima. Nello shop non cambia nulla finché Lei non approva e il client AI conferma con un token monouso valido 15 minuti.
- Nuovo controllo: se lo shop è cambiato dopo l’anteprima, la modifica viene rifiutata ed è necessaria una nuova anteprima.
- Registrato: ogni azione è visibile in Impostazioni > Sistema > MCP Log.
- Limitato: il client AI vede solo gli strumenti consentiti dalle sue autorizzazioni e la gestione dei permessi di Shopware controlla inoltre ogni chiamata.
Più shop
Un accesso può comprendere fino a 10 shop.
- Chieda al client AI di collegare un altro shop oppure usi il pulsante Add another shop nella scheda shop. Riceve un link monouso valido 60 minuti.
- Apra il link, scelga le autorizzazioni e incolli il codice nell’altro shop in Impostazioni > Sistema > MCP Connector.
Modificare le autorizzazioni o scollegare
- Modificare le autorizzazioni: in Shopware, in Impostazioni > Sistema > MCP Connector, clicchi su Modifica autorizzazioni accanto al collegamento.
- Scollegare: clicchi su Scollega. In questo modo il collegamento viene eliminato anche sul nostro server.
- Nel client AI: può rimuovere lì il connettore.
- Durata di un accesso: un accesso vale al massimo 90 giorni. Dopo questo periodo il client AI Le chiede di accedere di nuovo.
Risoluzione dei problemi
| Problema |
Soluzione |
| «Questo codice è sconosciuto, già utilizzato o scaduto» |
I codici valgono 30 minuti e una sola volta. Riavvii il collegamento nel client AI. |
| Manca uno strumento |
Al collegamento manca questa autorizzazione. In Shopware clicchi su Modifica autorizzazioni e avvii una nuova chat. |
| Il server del connettore non raggiunge lo shop |
Lo shop necessita di un indirizzo HTTPS pubblico. Se è diverso dall’indirizzo principale dello shop, lo inserisca in Impostazioni > Sistema > MCP Connector. Deve essere uno dei domini propri dello shop. |
| «Registrazione automatica non riuscita» (Gemini) |
Verifichi di aver usato l’indirizzo completo con /shopware alla fine. |
Privacy e sicurezza
- Che cosa memorizziamo: il nostro server memorizza solo ciò che serve per il collegamento. Le chiavi di accesso sono cifrate, codici e token vengono salvati solo come hash.
- Che cosa non memorizziamo: i dati dello shop come prodotti, ordini e clienti vengono trasmessi al Suo client AI su Sua richiesta e non vengono salvati da noi.
- Dettagli: nella nostra informativa sulla privacy: Informativa sulla privacy di Solution25 for Shopware.
Assistenza
info@solution25.com · Pagina contatti · +49 421 438 1919-0