Riferimento strumenti
Ogni strumento MCP che TellMyShop dà alla chat (Claude o ChatGPT) nel tuo negozio PrestaShop: cosa fa, se legge o scrive e quale interruttore serve per una modifica.
Gli strumenti di lettura non cambiano mai il negozio. Gli strumenti di scrittura restituiscono prima un’anteprima e un token monouso valido 30 minuti; la chat salva solo dopo la tua approvazione. Con TellMyShop Pro le modifiche a contenuti, SEO e catalogo si possono salvare subito; Vendite, Tema, Moduli e Manutenzione richiedono un interruttore che attivi nel pannello del modulo, e Tema, Moduli e Manutenzione si spengono da soli dopo 24, 24 e 3 ore. TellMyShop Free ha solo i report pronti indicati qui sotto, che si limitano a leggere. I dati personali dei tuoi clienti non sono accessibili all’IA finché non attivi tu l’accesso nel modulo; l’assistenza clienti salva allora bozze di risposta come note private e non invia nulla. 71 strumenti nel modulo 2.7.2, 24 dei quali in TellMyShop Free.
Usi WordPress con WooCommerce? Guarda gli strumenti del plugin per WordPress.
Base · sempre attivo
ps_get_shop_info, ps_check_capacity e ps_get_ready_job. Sempre disponibili, in TellMyShop Free e Pro. Il numero di blocco 0 è usato qui solo perché ogni strumento abbia un blocco intero.
| Strumento | Cosa fa | Accesso | Free | Salvataggio |
|---|---|---|---|---|
| Informazioni sul negozio ps_get_shop_info | Dice alla chat com’è il tuo negozio: versione di PrestaShop, lingue, valuta e cosa può fare. | Sola lettura | sì | – |
| Controlla se il lavoro rientra nei limiti ps_check_capacity | Prima di un lavoro più grande, controlla se rientra nei limiti orari che hai impostato nel pannello del modulo, così la chat non si ferma mai a metà. | Sola lettura | sì | – |
| Ottieni un’attività pronta ps_get_ready_job | Dà alla chat il piano passo per passo di un’attività pronta, così puoi avviarla anche in un’app di chat senza il menu delle attività, per esempio ChatGPT. | Sola lettura | sì | – |
Contenuti e SEO e Catalogo · scrive subito
Nessun interruttore: con Pro e una licenza attiva le modifiche in queste aree si possono salvare subito, sempre dopo un’anteprima e la tua approvazione. Qui ci sono anche la diagnostica del negozio, le statistiche di vendita, la cronologia delle modifiche e l’assistenza clienti. L’assistenza clienti funziona solo quando l’accesso ai dati dei clienti (scheda «Dati dei clienti») è impostato su pseudonimizzato o completo. Gli strumenti del blog compaiono solo quando è installato e attivo un modulo blog supportato (SmartBlog). TellMyShop Free ha i report pronti di questo blocco, che si limitano a leggere.
| Strumento | Cosa fa | Accesso | Free | Salvataggio |
|---|---|---|---|---|
| Controlla lo stato del negozio ps_check_shop_health | Controlla il negozio alla ricerca di problemi tecnici e dice come risolverli uno per uno. | Sola lettura | sì | – |
| Diagnostica la visibilità di un prodotto ps_diagnose_product_visibility | Scopre perché un prodotto non compare nel negozio o nella sua categoria. | Sola lettura | sì | – |
| Leggi i log di PrestaShop ps_get_logs | Legge il registro degli errori del negozio, così la chat può dirti cosa è andato storto e quando. | Sola lettura | sì | – |
| Elenca i moduli ps_list_modules | Elenca i moduli installati nel tuo negozio. | Sola lettura | sì | – |
| Cerca prodotti ps_search_products | Trova prodotti per nome, riferimento, categoria o informazioni mancanti. | Sola lettura | sì | – |
| Leggi un prodotto ps_get_product | Legge tutto di un prodotto: testi, prezzi, foto, categorie. | Sola lettura | sì | – |
| Albero delle categorie ps_get_category_tree | Mostra come sono organizzate le tue categorie. | Sola lettura | sì | – |
| Leggi una categoria ps_get_category | Legge i testi e le impostazioni di una categoria. | Sola lettura | sì | – |
| Elenca le caratteristiche ps_list_features | Elenca le caratteristiche dei prodotti come colore, materiale o taglia, e i loro valori. | Sola lettura | sì | – |
| Audit SEO ps_audit_seo | Controlla prodotti, categorie e pagine alla ricerca di testi SEO mancanti o scarsi. | Sola lettura | sì | – |
| Ispeziona una pagina del negozio ps_inspect_page | Apre una pagina del tuo negozio come la vede un visitatore o Google. | Sola lettura | sì | – |
| Report 404 ps_get_404_report | Mostra quali indirizzi del negozio portano a un errore «pagina non trovata». | Sola lettura | sì | – |
| Elenca i reindirizzamenti ps_list_redirects | Mostra quali vecchi indirizzi del negozio mandano visitatori e Google a una nuova pagina. | Sola lettura | sì | – |
| Elenca le pagine CMS ps_list_cms_pages | Elenca le tue pagine informative, come Consegna, Condizioni o Chi siamo. | Sola lettura | sì | – |
| Leggi una pagina CMS ps_get_cms_page | Legge il contenuto di una pagina informativa. | Sola lettura | sì | – |
| Elenca gli articoli del blog ps_list_blog_posts | Elenca gli articoli del tuo blog (SmartBlog). | Sola lettura | sì | – |
| Leggi un articolo del blog ps_get_blog_post | Legge un articolo del blog. | Sola lettura | sì | – |
| Elenca le categorie del blog ps_list_blog_categories | Elenca le categorie del tuo blog. | Sola lettura | sì | – |
| Vendite per prodotto ps_get_product_sales | Mostra quali prodotti vendono di più e quanto hanno incassato, senza dati dei clienti. | Sola lettura | sì | – |
| Acquistati insieme ps_get_bought_together | Mostra quali prodotti i clienti comprano nello stesso ordine, senza dati dei clienti. | Sola lettura | sì | – |
| Elenca le modifiche ps_list_changes | Mostra cosa ha cambiato la chat nel tuo negozio e quando. | Sola lettura | sì | – |
| Aggiorna il contenuto dei prodotti ps_update_product_content | Cambia nomi, descrizioni e testi SEO dei prodotti dopo che approvi un’anteprima. | Scrittura · anteprima + approvazione | solo Pro | subito |
| Aggiorna il contenuto delle categorie ps_update_category_content | Cambia nomi, descrizioni e testi SEO delle categorie dopo che approvi un’anteprima. | Scrittura · anteprima + approvazione | solo Pro | subito |
| Imposta le categorie dei prodotti ps_set_product_categories | Sposta i prodotti dentro o fuori dalle categorie. | Scrittura · anteprima + approvazione | solo Pro | subito |
| Imposta le caratteristiche dei prodotti ps_set_product_features | Compila le caratteristiche dei prodotti come colore o materiale. | Scrittura · anteprima + approvazione | solo Pro | subito |
| Crea o duplica un prodotto ps_create_product | Aggiunge un nuovo prodotto, o una copia di uno esistente, come bozza spenta che controlli prima che la vedano i clienti. | Scrittura · anteprima + approvazione | solo Pro | subito |
| Gestisci le immagini dei prodotti ps_manage_product_images | Aggiunge foto dei prodotti da link web, sceglie la foto principale e imposta l’ordine delle foto. | Scrittura · anteprima + approvazione | solo Pro | subito |
| Crea, sposta e ordina le categorie ps_manage_categories | Crea nuove categorie, le sposta in un altro punto del menu e imposta l’ordine dei prodotti in una categoria. | Scrittura · anteprima + approvazione | solo Pro | subito |
| Traduci caratteristiche, attributi e marche ps_translate_catalog_items | Traduce in un’altra lingua nomi e valori delle caratteristiche, opzioni dei prodotti come colori e taglie, e descrizioni di marche e fornitori. | Scrittura · anteprima + approvazione | solo Pro | subito |
| Cambia l’URL (slug) ps_change_url | Cambia l’indirizzo di una pagina e si assicura che il vecchio indirizzo reindirizzi al nuovo. | Scrittura · anteprima + approvazione | solo Pro | subito |
| Aggiorna il testo alternativo delle immagini ps_update_image_legends | Scrive le descrizioni (testi alternativi) delle foto dei prodotti. | Scrittura · anteprima + approvazione | solo Pro | subito |
| Spegni o riattiva un prodotto, con reindirizzamento ps_set_product_redirect | Spegne i prodotti che non vendi più e decide dove arrivano invece visitatori e Google, oppure riattiva i prodotti. | Scrittura · anteprima + approvazione | solo Pro | subito |
| Gestisci i reindirizzamenti ps_manage_redirects | Manda visitatori e Google da un indirizzo vecchio o rotto alla pagina giusta, ad esempio dopo averlo trovato nel report delle pagine mancanti. | Scrittura · anteprima + approvazione | solo Pro | subito |
| Aggiorna una pagina CMS ps_update_cms_page | Cambia il testo di una pagina informativa. | Scrittura · anteprima + approvazione | solo Pro | subito |
| Crea una pagina CMS ps_create_cms_page | Crea una nuova pagina informativa, come una guida, le FAQ o il regolamento di una promozione, spenta finché non la controlli. | Scrittura · anteprima + approvazione | solo Pro | subito |
| Salva un articolo del blog ps_save_blog_post | Scrive un nuovo articolo del blog o modifica uno esistente. | Scrittura · anteprima + approvazione | solo Pro | subito |
| Aggiorna una categoria del blog ps_update_blog_category | Cambia il nome e la descrizione di una categoria del blog. | Scrittura · anteprima + approvazione | solo Pro | subito |
| Annulla una modifica ps_revert_change | Annulla una modifica fatta dalla chat. | Scrittura · anteprima + approvazione | solo Pro | subito |
| Assistenza clienti: messaggi e bozze di risposta ps_customer_service | Legge i messaggi dei clienti e scrive bozze di risposta che controlli e invii tu; non invia mai nulla ai clienti. | Scrittura · anteprima + approvazione | solo Pro | subito |
| Elemento con tutti i campi ps_get_element_full | Mostra tutto ciò che è salvato per un prodotto, una categoria o una pagina CMS, compresi i campi aggiunti da altri moduli. | Sola lettura | solo Pro | – |
| Cambia qualsiasi campo di un elemento ps_update_element_field | Cambia un campo di un prodotto, una categoria o una pagina CMS che gli strumenti normali non coprono, anche un campo di un altro modulo, dopo che approvi un’anteprima. | Scrittura · anteprima + approvazione | solo Pro | subito |
Vendite · interruttore, finché non lo spegni
Prezzi, promozioni sui prodotti, promozioni su categorie e marche, codici sconto, scorte, combinazioni, spedizioni, prodotti correlati. Claude può leggere tutto in qualsiasi momento; per salvare una modifica serve l’interruttore Vendite nella scheda «Salvataggio per area», che resta attivo finché non lo spegni. Spento dopo l’installazione. Solo Pro.
| Strumento | Cosa fa | Accesso | Free | Salvataggio |
|---|---|---|---|---|
| Aggiorna i prezzi ps_update_prices | Cambia i prezzi dei prodotti. I grandi salti richiedono una tua approvazione in più. | Scrittura · anteprima + approvazione | solo Pro | interruttore Vendite (finché non lo spegni) |
| Gestisci i prezzi scontati (prezzi specifici) ps_manage_specific_prices | Imposta, elenca o rimuove prezzi scontati per le date scelte. | Scrittura · anteprima + approvazione | solo Pro | interruttore Vendite (finché non lo spegni) |
| Promozioni su categorie e marche (regole sui prezzi del catalogo) ps_manage_catalog_price_rules | Applica uno sconto a intere categorie o marche in una volta, e copre anche i prodotti che aggiungerai dopo. | Scrittura · anteprima + approvazione | solo Pro | interruttore Vendite (finché non lo spegni) |
| Gestisci regole del carrello e codici sconto ps_manage_cart_rules | Crea codici sconto, anche serie di codici monouso, e li attiva o disattiva. I nuovi codici partono disattivati. | Scrittura · anteprima + approvazione | solo Pro | interruttore Vendite (finché non lo spegni) |
| Aggiorna le scorte ps_update_stock | Cambia quanti articoli hai in magazzino. | Scrittura · anteprima + approvazione | solo Pro | interruttore Vendite (finché non lo spegni) |
| Elenca i corrieri ps_list_carriers | Mostra le tue opzioni di consegna, i loro prezzi e le soglie di consegna gratuita. | Sola lettura | solo Pro | – |
| Combinazioni dei prodotti (varianti) ps_manage_combinations | Mostra le varianti di un prodotto, come taglie e colori, e cambia i loro prezzi, codici e quale variante viene mostrata per prima. | Scrittura · anteprima + approvazione | solo Pro | interruttore Vendite (finché non lo spegni) |
| Spedizione: consegna gratuita, prezzi, corrieri ps_update_shipping | Imposta la consegna gratuita da un valore dell’ordine scelto, cambia i prezzi di consegna e attiva o disattiva le opzioni di consegna. | Scrittura · anteprima + approvazione | solo Pro | interruttore Vendite (finché non lo spegni) |
| Imposta i prodotti correlati ps_set_related_products | Imposta i prodotti correlati mostrati nella pagina prodotto, ad esempio in base a ciò che i clienti comprano insieme. | Scrittura · anteprima + approvazione | solo Pro | interruttore Vendite (finché non lo spegni) |
Tema · interruttore, 24 h
File del tema, cache, child theme, override dei template dei moduli, posizioni dei moduli nella pagina. La lettura funziona in qualsiasi momento; per salvare serve l’interruttore Tema, che attivi per 24 ore e che poi si spegne da solo. Per attivarlo serve un backup del database di oggi, che il modulo fa da solo. Spento dopo l’installazione. Solo Pro. I backup dei file (ps_list_file_backups, ps_restore_file_backup) sono elencati qui; per ripristinare un file serve l’interruttore dell’area a cui appartiene il file (Tema, Moduli o Manutenzione).
| Strumento | Cosa fa | Accesso | Free | Salvataggio |
|---|---|---|---|---|
| Elenca i file del tema ps_list_theme_files | Elenca i file che formano l’aspetto del tuo negozio. | Sola lettura | solo Pro | – |
| Leggi un file del tema ps_read_theme_file | Legge un file dell’aspetto del tuo negozio. | Sola lettura | solo Pro | – |
| Scrivi un file del tema ps_write_theme_file | Cambia un file dell’aspetto del negozio, dopo averne fatto un backup. | Scrittura · anteprima + approvazione | solo Pro | interruttore Tema (24 h) |
| Elenca i backup dei file ps_list_file_backups | Elenca i backup fatti prima di ogni modifica ai file, così si può ripristinare una versione precedente. | Sola lettura | solo Pro | – |
| Ripristina il backup di un file ps_restore_file_backup | Riporta una versione precedente di un file dal suo backup. | Scrittura · anteprima + approvazione | solo Pro | interruttore dell’area del file |
| Svuota la cache ps_clear_cache | Svuota la cache così le modifiche recenti compaiono sul sito. | Scrittura · anteprima + approvazione | solo Pro | interruttore Tema (24 h) |
| Crea un child theme ps_create_child_theme | Crea un child theme che contiene le tue modifiche, così gli aggiornamenti del tema non le cancellano. | Scrittura · anteprima + approvazione | solo Pro | interruttore Tema (24 h) |
| Override del template di un modulo ps_override_module_template | Cambia l’aspetto di un modulo senza toccare il modulo stesso. | Scrittura · anteprima + approvazione | solo Pro | interruttore Tema (24 h) |
| Gestisci le posizioni degli hook ps_manage_hook_positions | Cambia dove compaiono i moduli nella pagina e in quale ordine. | Scrittura · anteprima + approvazione | solo Pro | interruttore Tema (24 h) |
Moduli · interruttore, 24 h
Attivazione o disattivazione dei moduli, installazione o aggiornamento da un link ZIP, disinstallazione, impostazioni dei moduli, file dei moduli con backup. La lettura funziona in qualsiasi momento; per salvare serve l’interruttore Moduli, attivato per 24 ore, poi si spegne da solo. Per attivarlo serve un backup del database di oggi. Spento dopo l’installazione. Solo Pro.
| Strumento | Cosa fa | Accesso | Free | Salvataggio |
|---|---|---|---|---|
| Attiva o disattiva un modulo ps_toggle_module | Attiva o disattiva un modulo installato; le sue impostazioni e i suoi dati restano, così puoi riattivarlo in qualsiasi momento. | Scrittura · anteprima + approvazione | solo Pro | interruttore Moduli (24 h) |
| Installa o aggiorna un modulo da ZIP ps_install_module | Installa un nuovo modulo, o aggiorna uno che hai già, da un link di download che indichi, dopo averne mostrato nome, versione e provenienza. | Scrittura · anteprima + approvazione | solo Pro | interruttore Moduli (24 h) |
| Disinstalla un modulo (irreversibile) ps_uninstall_module | Rimuove un modulo insieme alle sue impostazioni e ai suoi dati; non si può annullare, quindi disattivare il modulo di solito è la scelta migliore. | Scrittura · anteprima + approvazione | solo Pro | interruttore Moduli (24 h) |
| Impostazioni del modulo ps_module_config | Legge e cambia le impostazioni salvate di un modulo, ad esempio quanti prodotti mostra un blocco della pagina principale; password e chiavi restano nascoste. | Scrittura · anteprima + approvazione | solo Pro | interruttore Moduli (24 h) |
| File dei moduli ps_module_file | Legge i file di un modulo e, quando non c’è altro modo, li cambia dopo averne fatto un backup; queste modifiche spariscono quando il modulo viene aggiornato. | Scrittura · anteprima + approvazione | solo Pro | interruttore Moduli (24 h) |
Manutenzione · interruttore, 3 h
Qualsiasi file del negozio, letture e modifiche del database, impostazioni di PrestaShop: accesso tecnico completo, come l’accesso FTP e al database. La lettura funziona in qualsiasi momento; per salvare serve l’interruttore Manutenzione, attivato per 3 ore, poi si spegne da solo. Per attivarlo serve un backup del database di oggi. Spento dopo l’installazione. Solo Pro. I file con password e chiavi, i moduli di pagamento e i file del connettore stesso restano bloccati. L’esecuzione di codice PHP arbitrario non è disponibile; i file PHP si possono scrivere con controllo della sintassi e backup.
| Strumento | Cosa fa | Accesso | Free | Salvataggio |
|---|---|---|---|---|
| File del negozio (area Manutenzione) ps_server_file | Legge qualsiasi file del negozio e, con l’interruttore Manutenzione attivo per 3 ore, lo cambia, con un backup prima di ogni modifica. | Scrittura · anteprima + approvazione | solo Pro | interruttore Manutenzione (3 h) |
| Query sul database (lettura) ps_db_query | Cerca informazioni direttamente nel database del negozio quando nessun altro strumento le mostra, senza cambiare nulla. | Sola lettura | solo Pro | – |
| Modifica al database ps_db_execute | Con l’interruttore Manutenzione attivo, fa una modifica diretta nel database del negozio dopo aver mostrato quante righe tocca, e conserva una copia di quelle righe così la modifica si può annullare. | Scrittura · anteprima + approvazione | solo Pro | interruttore Manutenzione (3 h) |
| Impostazioni di PrestaShop ps_config | Legge le impostazioni del negozio e, con l’interruttore Manutenzione attivo, le cambia; password e chiavi restano nascoste. | Scrittura · anteprima + approvazione | solo Pro | interruttore Manutenzione (3 h) |
In programma
Previsti, non ancora nel modulo. Non sono strumenti e non hanno pagine.
- Accesso OAuth per il connettore
Sostituire il token statico nell’URL del connettore con OAuth. Un token in un URL può finire nei log del server e dei proxy. Oggi sia Claude sia ChatGPT si collegano con il token (ChatGPT tramite un server MCP personalizzato aggiunto in Plugins). Non nella 2.7.x; previsto dopo il lancio, o prima se un’app di chat lo richiede.
- Notifica di aggiornamento del modulo
Avvisare il titolare del negozio nel pannello del modulo quando è disponibile una nuova versione di TellMyShop. Non nella 2.7.x; oggi una nuova versione viene mostrata nell’account TellMyShop.