Come funziona il Model Context Protocol, quali client lo supportano e cosa offre il MCP Server nativo di Shopware 6.7 ai merchant in Italia: tool, permessi, approvazioni, rischi, configurazione e costi.
Un MCP Server è un’interfaccia standardizzata attraverso cui assistenti di intelligenza artificiale come Claude o ChatGPT accedono ai dati e alle funzioni di un sistema. Il Model Context Protocol su cui si basa è stato pubblicato da Anthropic nel novembre 2024 come standard aperto e da dicembre 2025 è gestito dalla Linux Foundation.
Shopware 6.7 include un proprio MCP Server, che dalla versione 6.7.14 è attivo senza ulteriori impostazioni. Risponde all’indirizzo /api/_mcp, utilizza i permessi della Admin API, cioè l’interfaccia di amministrazione di Shopware, e consente di cercare, analizzare e, previa approvazione, modificare prodotti, ordini e impostazioni.
La tecnologia è gratuita: l’impegno sta nella gestione di permessi, approvazioni e registrazione delle attività. Secondo la nostra esperienza, una configurazione accurata con ruoli e un audit log che registra ogni azione costa da 1.500 a 5.000 €, mentre gli strumenti personalizzati per i processi aziendali costano da 5.000 a 20.000 € (IVA esclusa).
Prima di fondare solution25 abbiamo portato un nostro negozio online a oltre 500 ordini al giorno e dal 2017 realizziamo progetti Shopware, oggi anche integrazioni con Claude, ChatGPT e la piattaforma di workflow n8n. Con AI Connect, il nostro MCP Connector per Shopware, abbiamo sviluppato un’estensione che protegge questo collegamento con ruoli, approvazioni e registro delle attività.
Poiché il MCP Server fa parte del core, in ogni negozio Shopware aggiornato si pone la domanda di chi possa leggere e modificare cosa attraverso di esso. Questo articolo si rivolge ai titolari di e-commerce e ai responsabili e-commerce in Italia che gestiscono un negozio Shopware 6 e vogliono collegare Claude, ChatGPT o n8n a prodotti, ordini e report, oltre agli sviluppatori che realizzano l’integrazione.
Dopo la lettura potrà decidere se per il Suo caso è più adatto il MCP Server, il Copilot nell’amministrazione di Shopware, n8n o la Admin API, e configurare un accesso che non abbia più permessi del necessario. Tutti i prezzi sono aggiornati a ottobre 2026, IVA esclusa.
Il Model Context Protocol (MCP) è uno standard aperto che collega le applicazioni di intelligenza artificiale a fonti di dati e strumenti esterni. Anthropic lo ha pubblicato il 25 novembre 2024, insieme agli SDK, cioè librerie di programmazione, e ai primi server per Google Drive, Slack, GitHub, Git, Postgres e Puppeteer (annuncio di Anthropic).
L’idea di fondo: invece di costruire un’integrazione specifica per ogni combinazione di assistente AI e sistema gestionale, ogni sistema implementa MCP una sola volta e diventa così raggiungibile da tutti i client. Il 9 dicembre 2025 Anthropic ha trasferito il protocollo alla Agentic AI Foundation, sotto l’egida della Linux Foundation, con Block e OpenAI come cofondatori, citando oltre 10.000 MCP Server pubblici attivi e più di 97 milioni di download mensili degli SDK (comunicato sul trasferimento).
MCP segue un’architettura client-server con tre ruoli (descrizione dell’architettura):
La comunicazione avviene tramite JSON-RPC 2.0, cioè con messaggi strutturati. Il protocollo regola solo questo scambio, non il modo in cui l’AI utilizza il contesto.
Al contrario, un server può chiedere al client di interpellare l’utente (elicitation), ad esempio per far confermare una modifica.
Con stdio il client avvia il server come processo locale e scambia i messaggi tramite input e output standard. Streamable HTTP invia ogni messaggio come HTTP POST a un endpoint e consente server remoti con molti client contemporaneamente (Transports nella specifica). Il vecchio trasporto HTTP+SSE (Server-Sent Events) è considerato obsoleto dalla versione del protocollo 2025-03-26.
MCP adotta un versionamento per data: la revisione attuale è la 2026-07-28 (versionamento). Rende il protocollo stateless, eliminando la negoziazione di versione e capacità all’inizio di una connessione (changelog). Shopware tiene ancora disattivata questa revisione e lavora con la procedura di connessione precedente, che i client attuali continuano a supportare.
Oggi tutti i principali assistenti AI supportano il protocollo, con differenze in termini di trasporto, autenticazione e approvazioni.
| Client | Supporto MCP | Approvazione degli accessi in scrittura |
|---|---|---|
| Claude.ai e Claude Desktop | Server remoti come “Custom Connector” su tutti i piani (Free: un connector), server locali tramite file di configurazione o estensione .mcpb | Ogni chiamata a un tool viene sottoposta ad approvazione |
| Claude Code | stdio, HTTP e SSE; configurazione tramite comando o .mcp.json; login OAuth tramite /mcp | I server di progetto devono essere confermati, permessi dei tool tramite Permissions |
| ChatGPT | Developer Mode con client MCP completo su Plus, Pro, Business, Enterprise ed Edu; SSE e Streamable HTTP; OAuth o senza autenticazione | Le azioni di scrittura richiedono per impostazione predefinita una conferma |
| OpenAI Responses API e Agents SDK | Server remoti come tipo di tool “mcp”, nell’Agents SDK anche stdio e Streamable HTTP | require_approval per ogni tool, l’impostazione predefinita è l’approvazione |
| Cursor | stdio, SSE, Streamable HTTP; .cursor/mcp.json; OAuth | Chiede per impostazione predefinita prima di ogni chiamata a un tool |
| n8n | MCP Client Tool nel nodo AI Agent, MCP Server Trigger, MCP Server di istanza per client esterni | Nessuna richiesta di conferma nel workflow, le approvazioni vanno costruite da sé |
| Shopware Copilot | Si collega all’endpoint MCP del proprio negozio | Anteprima tramite dry-run, modifica solo dopo approvazione |
Fonti: Claude Connectors, Claude Code, ChatGPT Developer Mode, OpenAI API, Cursor, n8n Trigger, n8n server di istanza. Gli sviluppatori scelgono di solito Claude Code o Cursor, i reparti operativi Claude Desktop o ChatGPT, mentre i processi senza intervento umano passano da n8n.
MCP dà a un modello linguistico accesso a sistemi reali. Per questo la specifica contiene proprie linee guida di sicurezza e i client implementano le approvazioni. I punti più importanti per chi gestisce un negozio online:
Inizialmente Shopware ha sperimentato con un pacchetto Node.js separato (shopware-admin-mcp su GitHub, oggi archiviato). Da giugno 2026 Shopware distribuisce un MCP Server nativo insieme al core, basato sul Symfony MCP Bundle del framework PHP su cui poggia Shopware (documentazione del MCP Server di Shopware).
L’endpoint per l’amministrazione è /api/_mcp, quello per lo storefront /store-api/_mcp, entrambi tramite Streamable HTTP. Fino alla versione 6.8 Shopware indica il server come sperimentale, quindi i nomi dei tool possono ancora cambiare. Secondo endoflife.date la versione attuale è la 6.7.15.1 del 2 ottobre 2026.
Il core non include tool specifici come “crea prodotto” o “cerca cliente”, ma strumenti generici basati sulla Admin API che funzionano con qualsiasi entità (Tools Reference). A questi si aggiungono resources con dati di riferimento come canali di vendita, valute e macchine a stati, oltre al prompt shopware-context.
| Toolset | Tools | Accesso | Permessi necessari |
|---|---|---|---|
| Discovery | shopware-tool-search, shopware-toolsets-list, shopware-toolset-enable | Ricerca e attivazione nella sessione | nessuno |
| Entity | shopware-entity-schema, shopware-entity-search, shopware-entity-read, shopware-entity-aggregate, shopware-entity-upsert, shopware-entity-delete | Lettura, analisi, scrittura, eliminazione | Lettura, creazione, modifica o eliminazione per ogni entità |
| System-Config | shopware-system-config-read, shopware-system-config-write | Lettura, scrittura | system_config:read oppure system_config:update |
| Media | shopware-media-upload | Scrittura, senza dry-run | media:create, per le immagini prodotto anche product:update |
| Order | shopware-order-state | Modifica dello stato di ordine, pagamento e spedizione | order:read più i permessi di aggiornamento per ogni azione |
| Theme | shopware-theme-config | Lettura o scrittura | theme:read oppure theme:update |
Tutti i tool di scrittura funzionano per impostazione predefinita in modalità dry-run: il modello riceve un’anteprima della modifica e deve ripetere la chiamata con dryRun=false per eseguirla. L’unica eccezione è il caricamento dei media, che avviene immediatamente.
Per ogni integrazione e per ogni utente Lei gestisce una allowlist dei tools, resources e prompts consentiti. È il confine di sicurezza in fase di esecuzione, perché attivare un toolset non concede permessi. Gli amministratori aggirano la allowlist utente, per questo un accesso MCP non va mai associato a un account amministratore.
Shopware limita inoltre le chiamate: 300 al minuto e 1.000 ogni dieci minuti sull’endpoint Admin, 120 e 600 sull’endpoint Store API (configurazione). Per le modifiche massive la strada migliore resta la Sync API, con cui Shopware scrive molti record in un’unica chiamata.
Il Copilot, l’assistente in chat dell’amministrazione, si collega all’endpoint MCP del negozio e lavora con i permessi del merchant che ha effettuato l’accesso. Richiama i tool che modificano dati prima in dry-run, mostra una scheda di approvazione ed esegue la modifica solo dopo la conferma (Copilot Tool Approval).
Secondo Shopware, il Copilot è disponibile per tutti i merchant dalla versione 6.7.1.0, anche nella Community Edition, e le sue funzioni agentiche sono stabili dalla 6.7.15.0 (Release News ottobre 2026). Fanno parte di Shopware Intelligence+, l’abbonamento AI aggiuntivo di Shopware, a 19 € al mese, 29 € nella Community Edition, secondo il fornitore (Shopware sulle funzioni AI, pagina prezzi).
Per i merchant senza sviluppatori i tool generici Entity sono poco pratici, perché il modello deve prima interrogare lo schema e poi costruire i criteri nel formato della Admin API. Shopware fornisce quindi il pacchetto sperimentale swag/mcp-merchant-tools con workflow pronti come merchant-order-summary e merchant-revenue-report, che però potrebbe essere abbandonato a favore del Copilot (Shopware Extensions).
Il nostro plugin AI Connect (MCP Connector per Shopware) si appoggia al server nativo e aggiunge ciò che manca nell’operatività quotidiana: le configurazioni pronte per Claude Desktop, Claude Code e OpenAI Codex vengono generate nell’amministrazione, ogni connessione utilizza un ruolo ACL di Shopware, ogni modifica appare come anteprima prima dell’esecuzione e l’audit log rende tracciabili le attività per tool, modalità, esito e account. Si aggiunge una ricerca in linguaggio naturale per collaboratori e clienti, con una propria chiave API di OpenAI o Anthropic.
Figura: il grafico mostra in quali punti una chiamata a un tool viene fermata o tracciata; chi definisce ruolo e allowlist in modo restrittivo e non concede approvazioni generalizzate limita gli errori del modello. Fonte: developer.shopware.com (MCP Server, Tools Reference, Configuration), solution25.com/mcp-connector; aggiornato a ottobre 2026
Tutto ciò che la Admin API sa fare si può avviare tramite MCP in linguaggio naturale, sempre entro i permessi dell’integrazione. Questi casi d’uso si sono dimostrati efficaci nei progetti:
Più il prompt indica in modo concreto entità, periodo e output desiderato, meno domande di chiarimento ci saranno. Una raccolta di prompt verificati per ogni team si ripaga rapidamente.
MCP non è l’unico modo per collegare Shopware all’AI o ad altri sistemi. La tabella inquadra le cinque soluzioni più diffuse.
| Soluzione | Adatta per | Punti di forza | Limiti |
|---|---|---|---|
| MCP Server (nativo in Shopware) | Lavoro interattivo in chat, analisi, gestione dati con approvazione | Incluso nel core, ACL, dry-run, tutti i client MCP | Sperimentale fino alla 6.8, rate limit, tool specifici solo tramite estensione |
| n8n | Processi ricorrenti senza intervento umano, sistemi terzi | Nodi Shopware pronti, AI Agent con MCP Client Tool, self-hosting | Approvazioni e gestione degli errori vanno costruite nel workflow |
| Admin API diretta | Software proprietario, importazioni massive, interfacce ERP | Controllo completo, Sync API, nessun costo in token | Richiede sviluppo, nessun dialogo in linguaggio naturale |
| Shopware Nexus | Workflow basati su eventi tra Shopware, ERP e CRM | Gestito da Shopware, trigger sugli eventi delle entità, contingente incluso nel piano | Beta, nessun nodo AI o MCP, nessun self-hosting |
| Shopware Copilot | Partenza senza configurazione nell’amministrazione | Nessuna configurazione, approvazione integrata, dati in Europa secondo Shopware | Solo nell’amministrazione, funzioni agentiche tramite Intelligence+ |
I nostri nodi n8n per Shopware coprono prodotti, clienti e ordini; i workflow tipici sono illustrati nell’articolo sull’automazione di Shopware 6 con n8n. Poiché il MCP Client Tool di n8n, dalla versione del nodo 1.2, utilizza per impostazione predefinita HTTP Streamable (codice sorgente del nodo), un AI Agent in n8n può interrogare direttamente il MCP Server di Shopware.
Secondo la documentazione, nella fase beta Shopware Nexus collega tra l’altro Microsoft Dynamics Business Central, Slack e S3, ma non offre un nodo MCP o AI. Come funziona la Admin API diretta lo spieghiamo nella nostra pagina sulla Shopware Admin API, mentre una panoramica delle integrazioni AI è disponibile nella piattaforma di integrazione AI per Shopware. Per i merchant italiani che collegano un ERP, ricordiamo che ordini e fatture devono restare coerenti con la fatturazione elettronica tramite SDI: questa parte dell’integrazione appartiene all’ERP o alla Admin API, non alla chat.
claude mcp add --transport http shopware https://il-suo-shop.it/api/_mcp --header "sw-access-key: …" --header "sw-secret-access-key: …". In Claude Desktop e Cursor inserisca lo stesso endpoint con il tipo streamable-http e i due header nel file di configurazione (Getting Started di Shopware). In n8n colleghi l’AI Agent tramite il MCP Client Tool con autenticazione via header.Una configurazione tipica dalle nostre consulenze, presentata come scenario basato sull’esperienza: un merchant con circa 4.000 articoli vuole utilizzare Claude per analisi, assistenza clienti e gestione del catalogo. Invece di un accesso admin configuriamo tre integrazioni.
| Integrazione | Chi la utilizza | Allowlist (nomi brevi dei tool) | Permessi del ruolo |
|---|---|---|---|
| Analisi | Direzione in Claude Desktop | schema, search, read, aggregate | Lettura ordini e prodotti |
| Assistenza | Team del servizio clienti | schema, search, read, order-state | Lettura ordini e clienti, modifica stato di spedizione |
| Catalogo | Shop manager | schema, search, read, upsert, media-upload | Lettura e modifica prodotti, creazione media, nessun permesso di eliminazione |
Il caricamento dei media, che salva senza anteprima, è riservato al catalogo, mentre i dati dei clienti sono visibili solo all’assistenza. Secondo la nostra esperienza, la configurazione di questi tre accessi con formazione si colloca nella fascia bassa dell’intervallo indicato, da 1.500 a 5.000 €.
Applichiamo lo stesso principio anche al di fuori dei progetti AI: per un cliente tedesco del settore logistico abbiamo realizzato un portale di magazzino con gestione ordini basata sui ruoli e integrazione con SAP, HubSpot e Shopware. Lì i permessi basati sui ruoli garantiscono che le informazioni sensibili siano accessibili solo al personale autorizzato, e gli audit log rendono tracciabili le operazioni.
Come strumenti servono l’audit log di un’estensione come AI Connect o un logging proprio, il riepilogo dei costi del Suo fornitore di AI e, in n8n, l’elenco delle esecuzioni. Questi valori di riferimento si sono dimostrati validi nella nostra esperienza:
Controlli i valori ogni settimana nelle prime quattro settimane, poi ogni mese e dopo ogni aggiornamento di Shopware. È opportuno intervenire non appena il tasso di approvazione cala, un controllo a campione rileva uno scostamento o un prompt collaudato non trova più un tool adatto dopo un aggiornamento.
I costi nascono dal client AI, dalle funzioni aggiuntive di Shopware e dalla configurazione.
| Voce di costo | Importo | Fonte |
|---|---|---|
| MCP Server in Shopware | 0 €, incluso nel core dalla 6.7.14 | Documentazione Shopware |
| Claude per singoli utenti | Pro 20 dollari USA al mese (17 con pagamento annuale), Max da 100, Team da 20 per utente, secondo il fornitore | claude.com/pricing |
| ChatGPT per singoli utenti | Plus 20 dollari USA al mese, Developer Mode da Plus, secondo il fornitore | openai.com |
| Utilizzo API, ad esempio da n8n | Claude Sonnet 5.5: 2 dollari USA per milione di token in input, 10 dollari USA per milione di token in output; OpenAI addebita solo i token per i MCP Server remoti | Anthropic, OpenAI |
| n8n Cloud | Starter 20 € al mese con pagamento annuale, Pro 50 €, secondo il fornitore; Community Edition self-hosted senza costi di licenza | n8n.io/pricing |
| Shopware Intelligence+ | 19 € al mese, Community Edition 29 €, per le funzioni agentiche del Copilot, secondo il fornitore | shopware.com/de/preise |
| Configurazione da parte di un’agenzia | Da 1.500 a 5.000 € (IVA esclusa) per ruoli, allowlist, configurazione dei client, audit log e formazione | Dato di esperienza solution25 |
| Tool personalizzati | Da 5.000 a 20.000 € (IVA esclusa) a seconda del numero e della complessità dei processi | Dato di esperienza solution25 |
I costi di configurazione dipendono soprattutto da quanti ruoli e client Le servono. Quanto fatturano in generale le agenzie Shopware è spiegato nell’articolo sui prezzi delle agenzie Shopware, mentre i costi complessivi di un negozio sono trattati nel nostro articolo sui costi di Shopware.
I tool personalizzati convengono quando un processo si ripete ogni giorno: un tool “crea reso” che gestisce ordine, rimborso e movimento di magazzino in un unico passaggio con una sola approvazione fa risparmiare più tempo di dieci chiamate generiche Entity. Questi tool vengono realizzati come plugin o app (sviluppo di plugin Shopware).
La nostra valutazione: per la maggior parte dei merchant Shopware, anche in Italia, il MCP Server nativo con un’integrazione in sola lettura è il punto di partenza giusto, perché ruoli, allowlist e dry-run sono già integrati e non ci sono costi di licenza. Concediamo i permessi di scrittura solo dopo un periodo di test in staging, e ai negozi sulla 6.6 consigliamo l’aggiornamento invece di un MCP Server separato, che con la 6.7 diventa superfluo.
Un MCP Server è un programma che, tramite il Model Context Protocol, offre a un’applicazione di AI strumenti, dati e modelli ed esegue le chiamate che il client invia dopo l’approvazione. In Shopware il MCP Server fa parte del negozio ed è raggiungibile all’indirizzo /api/_mcp.
MCP è uno standard aperto che collega le applicazioni di AI a strumenti e dati. Un’applicazione host come Claude o ChatGPT interroga i tool di un server e li presenta al modello linguistico. Se il modello sceglie un tool, l’host esegue la chiamata dopo la Sua approvazione e restituisce il risultato al modello.
Il progetto MCP mantiene server di riferimento come Filesystem, Git, Fetch, Memory e Time (GitHub) e un registro pubblico. Nell’e-commerce, oltre al server nativo di Shopware, sono rilevanti il server di istanza di n8n e l’endpoint MCP di ogni negozio Shopify (Shopify).
Esistono SDK ufficiali tra l’altro per TypeScript, Python, PHP, Java e Go (panoramica degli SDK). Si definiscono i tool con nome, descrizione e schema di input e si sceglie stdio o Streamable HTTP come trasporto. In Shopware si estende il server esistente: i plugin registrano i tool come servizio Symfony, le app li dichiarano nel file Resources/mcp.xml, in entrambi i casi con permessi ACL e un parametro dryRun per l’approvazione.
Sono sicuri quanto i loro permessi e la loro configurazione. La specifica descrive attacchi come l’inoltro di token, la prompt injection tramite i risultati dei tool e i server locali manipolati, e richiede approvazioni da parte dell’utente. In Shopware si aggiungono ruoli ACL, allowlist per ogni integrazione, dry-run prima di ogni modifica e rate limit.
Il protocollo è libero e il MCP Server di Shopware è incluso nel core dalla versione 6.7.14. I costi ricorrenti riguardano il client, ad esempio 20 dollari USA al mese per Claude Pro o ChatGPT Plus secondo il fornitore, mentre la configurazione con ruoli, allowlist e audit log costa secondo la nostra esperienza da 1.500 a 5.000 € (IVA esclusa).
Sì, tramite il Developer Mode nei piani Plus, Pro, Business, Enterprise ed Edu. Poiché ChatGPT si collega solo tramite OAuth o senza autenticazione, serve un gateway davanti al negozio che gestisca OAuth, e il negozio deve essere raggiungibile pubblicamente via HTTPS.
Vuole sapere quali attività del Suo negozio si possono svolgere tramite un MCP Server e quali permessi servono? Ci scriva: seguiamo merchant in Italia, verifichiamo la Sua versione di Shopware, proponiamo ruoli e allowlist e configuriamo AI Connect con approvazioni e audit log. Alla fine ogni team dispone di un proprio accesso, che vede e modifica solo ciò che serve al suo compito.
Gestisce già un negozio e vuole prima sapere a che punto è oggi? La nostra analisi del negozio gratuita Le mostra in due giorni lavorativi, in formato PDF, dove il Suo negozio perde fatturato, dai tempi di caricamento e dalla SEO fino alla visibilità negli assistenti AI.
Besnik Bilalli è fondatore e CEO di solution25, l’agenzia Shopware con sede a Brema. Prima di fondare l’agenzia nel 2017 ha costruito un proprio negozio online portandolo a oltre 500 ordini al giorno. Da allora affianca i merchant nei progetti Shopware, dal primo preventivo fino alla gestione operativa. Risponde volentieri di persona alle domande sull’articolo: contattaci.
Responsabile dei contenuti e dell’aggiornamento: Besnik Bilalli. Aggiornato a: ottobre 2026. Prossima revisione dei contenuti: gennaio 2027.