Prerequisiti di installazione
PrestaShop MCP Server richiede PrestaShop 8.2+ o PrestaShop 9+.
PrestaShop MCP Server richiede altri moduli PrestaShop per funzionare: PrestaShop Marketplace nel Back Office e PrestaShop Account.
Fasi di onboarding
Installazione di PrestaShop MBO:
Perché MBO? Permette di installare e gestire altri moduli PrestaShop.
Installazione dei moduli richiesti:
Perché Account? Permette di stabilire una connessione sicura.
Perché Eventbus? Attiva la condivisione dei dati necessaria.
Perché MCP Tools? Fornisce un insieme di azioni predefinite che gli LLM possono eseguire.
Account PrestaShop
Perché accedere all'account?
Permette di stabilire una connessione sicura. Inoltre, l'utente che accede sarà autorizzato per impostazione predefinita a utilizzare MCP Server.
ℹ️ Se un prerequisito non viene più soddisfatto dopo la configurazione iniziale (ad esempio, se un modulo richiesto viene disattivato), MCP Server smetterà di funzionare. Un messaggio di errore apparirà nella sua applicazione di IA durante l'esecuzione di azioni sulla sua boutique. La prossima volta che accederà alla configurazione del modulo MCP Server, il processo di onboarding ripartirà da capo. Una volta terminato l'onboarding, MCP Server diventerà nuovamente accessibile.
PrestaShop MCP Server
Configurazione
Può trovare e copiare l'URL del server necessaria per connettere le applicazioni di IA al PrestaShop MCP Server.
Può consultare una guida dettagliata passo dopo passo per connettere le applicazioni di IA più popolari.
Azioni
Può visualizzare e controllare quali azioni sono disponibili per le applicazioni di IA.
Ciò include le azioni fornite da PrestaShop MCP Tools (installato durante l'onboarding), così come da qualsiasi altro modulo che integra funzionalità Tools.
Il controllo Attiva/Disattiva determina se un'azione è disponibile e si applica a tutti gli utenti del server MCP. Attualmente non è possibile personalizzare le azioni per utente.
Membri
Per impostazione predefinita, solo l'utente che si è connesso all'account durante l'onboarding è autorizzato a connettersi al server MCP.
Gli altri utenti devono essere aggiunti da questa pagina. Senza l'aggiunta preventiva, l'accesso verrà loro negato dalla loro applicazione di IA, anche se dispongono di un accesso completo al Back Office.
Parametri sviluppatore
Parametri avanzati destinati agli sviluppatori che creano strumenti personalizzati.
Account
Visualizza l'account dell'utente attualmente connesso e consente di passare a un altro utente.
Aiuto
Include collegamenti alla documentazione utile.
Connessione con gli strumenti di IA
Dopo la configurazione iniziale, tutte le interazioni con MCP Server avvengono direttamente dall'applicazione di IA.
Prerequisiti
La maggior parte delle applicazioni di IA consentono di creare un connettore personalizzato, che permette di stabilire la connessione con il server MCP. Tuttavia, al momento, questa funzionalità è generalmente in versione Beta e riservata esclusivamente agli Amministratori, anche in ChatGPT. Gli utenti di ChatGPT Pro/Team/Enterprise devono ottenere l'accesso Admin per connettersi al server MCP.
Esecuzione delle azioni
Le applicazioni di IA interagiscono con il server MCP utilizzando le azioni disponibili (strumenti). Queste azioni sono visibili nella scheda "Azioni" del modulo PrestaShop MCP Server e nel connettore dell'applicazione di intelligenza artificiale.
Il LLM sceglie quali azioni chiamare in base alla richiesta dell'utente e alle informazioni necessarie per ogni azione.
ℹ️ Anche se lasciare che sia il LLM a scegliere le azioni è potente, la scelta non è sempre ovvia e può variare in base alle richieste.
Ad esempio, in caso di richiesta di informazioni su un prodotto, il LLM verifica generalmente prima quali lingue sono disponibili nel negozio. Utilizza quindi queste informazioni per specificare la lingua dei dettagli del prodotto, poiché uno stesso prodotto può esistere in più lingue.
Tuttavia, a volte il LLM ignora questa fase e seleziona una sola lingua predefinita.
ℹ️ I LLM richiedono un'autorizzazione per eseguire ogni azione, a volte diverse azioni per una sola richiesta, e l'utente deve confermare prima che il LLM possa continuare.
Ciò può creare attriti durante le interazioni con il LLM a causa degli scambi frequenti. Per ridurre questo problema, è possibile attivare l'opzione "Ricordare per questa conversazione" o "Autorizzare sempre", che elimina le richieste di autorizzazione per le azioni successive.
🚨 Anche se PrestaShop fornisce i propri strumenti per l'utilizzo da parte dei LLM, non possiamo garantire l'accuratezza dei risultati ottenuti tramite questi strumenti. L’esecuzione implica una forte interpretazione da parte del LLM: comprensione della richiesta dell’utente, scelta degli strumenti pertinenti, interpretazione dei parametri richiesti e restituzione della risposta all’utente.
Motivi di fallimento della connessione al server MCP
Il negozio
La connessione al server MCP è impossibile se il negozio non è accessibile pubblicamente online.
Ciò si verifica quando:
- La modalità di manutenzione è attiva
- Si tratta di un negozio di test o di pre-produzione con accesso limitato
La rete
Problema con la connessione Internet…
L'utente
Un utente deve essere autorizzato nella scheda Membri del PrestaShop MCP Server per potersi connettere al MCP Server.
L'applicazione di IA
ℹ️ In ChatGPT, il connettore PrestaShop deve essere aggiunto manualmente ad ogni nuova conversazione, il che può essere facilmente dimenticato.
Se il connettore non viene aggiunto, ChatGPT indicherà semplicemente che non ha accesso alle informazioni richieste. Non indicherà che il connettore PrestaShop esiste ed è correttamente configurato.