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.
