Risorse

Guida di riferimento agli strumenti MCP di WareRushAI

Gli strumenti di lettura e scrittura del server MCP di WareRushAI, i relativi ambiti e cosa restituiscono o modificano.

Revised:

1. get_account_info (ambito account.read)

Restituisce l'azienda dell'utente connesso, il relativo ruolo, il piano di abbonamento e i moduli attivi. Gli assistenti lo richiamano come prima operazione per sapere di chi sono i dati consultati.

2. list_warehouses (ambito inventory.read)

Elenca i magazzini e le sedi dell'azienda e indica quali sono collegati a una sede Shopify.

3. search_products (ambito catalog.read)

Cerca i prodotti per nome, SKU, codice a barre, brand o modello e restituisce una riga sintetica per prodotto con prezzo, categoria e stock. I risultati sono impaginati; usa get_product per visualizzare la scheda completa.

4. get_product (ambito catalog.read)

Restituisce i dati di un singolo prodotto, il relativo stock per sede e lo stato di pubblicazione sui marketplace.

5. get_inventory_summary (ambito inventory.read)

Restituisce la quantità totale di stock per sede, consentendo all'assistente di indicare quanto stock l'azienda detiene in ciascun magazzino.

6. find_missing_product_data (ambito catalog.read)

Trova i prodotti a cui mancano i dati necessari per la vendita (immagine, prezzo, categoria, descrizione, codice a barre e simili) e specifica cosa manca. I risultati sono impaginati.

7. find_listing_problems (ambito catalog.read)

Trova i prodotti che non sono stati pubblicati su un marketplace o canale e spiega l'errore con una soluzione chiara, ad esempio un codice EAN mancante richiesto dalla categoria Allegro.

8. find_unfulfilled_orders (ambito orders.read)

Elenca gli ordini aperti di webshop, marketplace e B2B non ancora spediti, indicandone origine, partner e stato.

9. search_categories (ambito catalog.read)

Cerca nell'albero delle categorie di prodotto per nome e restituisce ID e percorsi delle categorie; update_product usa l'ID per impostare una categoria.

10. Come funzionano gli strumenti di scrittura

Gli strumenti di scrittura richiedono l'ambito catalog.write o inventory.write e il ruolo di titolare o amministratore. Ognuno lavora in due passaggi: con confirm=false restituisce solo un'anteprima dei valori vecchi e nuovi; con confirm=true ed expected_version (la versione del prodotto dall'anteprima o da get_product) salva. Se nel frattempo il prodotto è cambiato, il salvataggio viene rifiutato. Una chiamata modifica un prodotto, ogni modifica viene registrata con origine mcp e non si può eliminare nulla.

11. update_product (ambito catalog.write)

Modifica nome, descrizione, marca, tipo, categoria, codice a barre, SKU, prezzo di vendita o stato (attivo o bozza) di un prodotto. Un prezzo impostato qui conta come prezzo manuale che l'AI in background non sovrascrive mai. Lo SKU si modifica con una chiamata separata.

12. adjust_stock (ambito inventory.write)

Imposta, aggiunge o toglie giacenza di un prodotto in una sede tramite il normale movimento di magazzino, così si aggiornano anche il registro dei movimenti e la sincronizzazione delle giacenze con Shopify.

13. set_channel_listing (ambito catalog.write)

Attiva, disattiva o riporta alla regola del canale un prodotto su un marketplace o canale. I prodotti usati, ricondizionati o danneggiati non possono mai essere attivati sui canali che accettano solo prodotti nuovi (eMAG, Árukereső, Árgép, Pepita).

14. create_product (ambito catalog.write)

Crea un nuovo prodotto da un codice a barre o da un nome, facoltativamente con giacenza iniziale in una sede. L'AI in background lo identifica e completa il resto entro il consueto limite di massimo 5 chiamate AI per prodotto; un codice a barre esistente non viene mai duplicato.