Come collegare Shopware 6 Admin API a Cursor via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Shopware 6 Admin API, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Shopware 6 Admin API + Cursor

Shopware 6 Admin API, l'API di back office del negozio (non la Store API): cerca ogni entità, gestisce prodotti, categorie, layout Shopping Experiences fino allo slot e media, legge canali di vendita, promozioni e URL SEO. Scritture generiche, eliminazioni e sync massivo sono disattivati all'installazione.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

SHOPWARE_URL, SHOPWARE_ACCESS_KEY_ID, SHOPWARE_SECRET_ACCESS_KEY

Step 1 — Ottieni le credenziali

Admin API, non la Store API: questo connettore usa la Admin API (/api) di un negozio Shopware 6, cioè l'API che la Shopware Administration stessa usa per gestire il negozio: prodotti, categorie, layout Shopping Experiences e libreria media. È un connettore diverso da Shopware 6 Store API (shopware-6), che legge la vetrina pubblica con la chiave di accesso di un canale di vendita. Installa questo quando l'AI deve lavorare sui dati di amministrazione del negozio.

La configurazione richiede circa 3 minuti. Ti serve l'accesso alla Shopware Administration del negozio.

1. Nella Shopware Administration apri Settings > System > Integrations e crea una nuova integrazione.
2. Dalle un nome e attiva Administrator oppure assegna un ruolo con i permessi che l'AI deve avere. Con un ruolo di sola lettura ogni tool di scrittura fallisce con 403.
3. Copia l'Access key ID (inizia con SWIA) in SHOPWARE_ACCESS_KEY_ID e la Secret access key in SHOPWARE_SECRET_ACCESS_KEY. La secret viene mostrata una sola volta; se la perdi, crea una nuova chiave nell'integrazione.
4. Imposta SHOPWARE_URL sull'indirizzo del negozio senza percorso, ad es. https://shop.example.com. Non aggiungere /api né /admin.
5. Installa il connettore ed esegui shopware_6_admin_get_version: mostra la versione di Shopware e conferma le credenziali.

AnythingMCP ottiene un token bearer di breve durata su /api/oauth/token del negozio con il grant OAuth2 client credentials e lo rinnova da solo.

Cosa legge: prodotti con ricerca libera e filtri (numero prodotto, attivo, giacenza, produttore, categorie, proprietà, varianti tramite parentId) e un singolo prodotto con i suoi campi (nome, numero, giacenza, prezzo, descrizione, campi SEO, campi personalizzati); categorie con categoria padre, posizione, tipo, layout, flag attiva e visibile e breadcrumb; i layout Shopping Experiences (pagine CMS) e un layout con sezioni, blocchi e slot, compresa la config di ogni slot; la libreria media con URL, nome file, testo alternativo, titolo e cartella; i canali di vendita con i loro domini (la chiave di accesso della Store API viene rimossa dalla risposta); le promozioni con codici, validità e limiti di utilizzo; gli URL SEO. Qualsiasi altra entità della Admin API, ad esempio ordini, clienti, produttori, gruppi e opzioni di proprietà, regole, lingue, valute o snippet, si legge con shopware_6_admin_search_entities e shopware_6_admin_get_entity.

Criteri di ricerca: ogni tool di ricerca accetta i criteria di Shopware: term, ids, filter (equals, equalsAny, contains, prefix, suffix, range, not, multi), sort, associations, includes, limit, page e total_count_mode; i prodotti e la ricerca generica accettano anche aggregations. I campi collegati si filtrano con percorsi a punti come categories.id o manufacturer.name. L'AI passa includes quando non le servono i record completi, perché un prodotto completo è grande. Gli id sono 32 caratteri esadecimali senza trattini; l'AI li trova con i tool di ricerca e non li indovina mai.

Lingue e varianti: i testi sono tradotti per lingua. Con language_id (inviato come header sw-language-id) una lettura restituisce quella traduzione e una scrittura modifica quella traduzione; senza, vale la lingua di sistema del negozio. Le lingue si elencano con shopware_6_admin_search_entities e l'entità language. I nuovi record si creano prima nella lingua di sistema. Le varianti sono prodotti con parentId ed ereditano i campi vuoti dal prodotto padre; inheritance: true mostra i valori ereditati.

Cosa scrive: shopware_6_admin_update_product (testi, campi SEO, campi personalizzati, flag attivo, giacenza, fine serie, EAN, prezzo; un prezzo sostituisce l'intero listino), shopware_6_admin_add_product_property e shopware_6_admin_remove_product_property (collegano o scollegano solo un'opzione), shopware_6_admin_create_property_option, shopware_6_admin_create_category e shopware_6_admin_update_category (anche lo spostamento nell'albero), shopware_6_admin_create_cms_page, shopware_6_admin_update_cms_page (sezioni, blocchi e slot con id vengono aggiornati, quelli senza id aggiunti, nulla viene rimosso), shopware_6_admin_create_cms_block, shopware_6_admin_update_cms_slot (la config sostituisce quella dello slot per quella lingua), shopware_6_admin_create_media seguito da shopware_6_admin_upload_media_from_url, shopware_6_admin_update_media e shopware_6_admin_create_media_folder. Questi tool sono attivi all'installazione e modificano il negozio live: i clienti vedono la modifica appena la cache del negozio viene aggiornata. Il caricamento da URL richiede la enable_url_upload_feature di Shopware (attiva di default) e un URL pubblico, e sostituisce un file già presente nel media.

Disattivati all'installazione: shopware_6_admin_create_entity, shopware_6_admin_update_entity (qualsiasi entità, compresi ordini, clienti, canali di vendita e impostazioni), shopware_6_admin_delete_entity (definitivo, i record dipendenti possono essere eliminati insieme) e shopware_6_admin_sync (upsert ed eliminazione massivi tramite la Sync API). Un admin del workspace li attiva consapevolmente.

Risposte: aggiornamenti, caricamenti ed eliminazioni rispondono con un 204 vuoto, quindi l'AI rilegge il record per confermare la modifica. I tool di creazione restituiscono il nuovo record con il suo id. Gli elenchi restituiscono total, data e aggregations.

Limiti: il massimo predefinito di Shopware è 500 risultati per pagina; l'AI pagina con page. total_count_mode 1 restituisce il totale esatto, 2 solo se esiste una pagina successiva.

Errori comuni: 401 significa Access key ID o secret errati: copiali di nuovo o crea una nuova chiave nell'integrazione. 403 significa che il ruolo dell'integrazione non può farlo: attiva Administrator o estendi il ruolo. 404 su ogni chiamata indica di solito che SHOPWARE_URL contiene /api, /admin o un altro percorso.

Con i tool attivi all'installazione, il connettore non crea né modifica ordini, clienti o impostazioni e non elimina nulla. Carica media solo da un URL pubblico, non dal tuo computer. Per leggere la vetrina pubblica con la chiave di accesso di un canale di vendita usa il connettore Shopware 6 Store API.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Cursor

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Shopware 6 Admin API.

Tool disponibili

Esempi di prompt

• "Trova tutti i prodotti attivi con meno di 5 pezzi in giacenza e mostra numero prodotto, nome e giacenza."
• "Riscrivi meta title e meta description del prodotto SW10001 in tedesco e in inglese. Mostrami i testi prima di salvare."
• "Mostra il layout Shopping Experiences della nostra landing page estiva con sezioni, blocchi e slot."
• "Carica l'immagine https://example.com/banner.jpg nella cartella media Banner e imposta il suo testo alternativo."
• "Quali promozioni sono attive adesso, con codici e date di validità?"

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Gemini
• Collegare a Meta Muse
• Collegare a Microsoft Copilot