MCP Configuratore di prodotto: collega Claude, Cursor e VS Code a Simplio3D

Chiedi oggi a un assistente AI informazioni sul tuo configuratore di prodotti e risponderà in base a ciò che incolli nella chat: uno screenshot, un elenco di opzioni, un prezzo digitato. I connettori MCP eliminano questo passaggio. Un connettore offre all'assistente un accesso diretto e autorizzato al tuo account Simplio3D, così può leggere il progetto reale (i blocchi di opzioni, le regole condizionali, la formula di prezzo, i nomi delle parti all'interno del modello 3D) e rispondere di conseguenza.

Questa guida spiega che cos'è un connettore MCP, cosa può e non può fare un agente connesso in Simplio3D, come mantenere sotto controllo le modifiche rischiose e come connettere Claude, Cursor o VS Code.

Cosa sono i connettori MCP?

Il Model Context Protocol (MCP) è uno standard aperto per connettere gli assistenti AI a strumenti e dati esterni. Ha due componenti. Un client MCP è lo strumento AI che già utilizzi, come Claude, Cursor o VS Code. Un server MCP è il sistema a cui l'assistente si connette: pubblica un elenco di strumenti, ciascuno con una descrizione e uno schema, che l'assistente può richiamare quando una domanda lo richiede.

Un connettore è il collegamento tra i due: l'indirizzo del server, più una credenziale che indica chi si sta connettendo e a cosa può accedere. Claude lo chiama connettore personalizzato; altri client lo chiamano voce del server MCP. Per Simplio3D si tratta sempre delle stesse due cose:

• L'endpoint: https://app.simplio3d.ai/mcp
• Una credenziale: un accesso OAuth che approvi in una schermata di consenso di Simplio3D, oppure un token di connessione che crei in Dashboard → Integrazioni → Connessioni AI.

Una volta connesso, l'assistente vede gli strumenti di Simplio3D insieme ai propri e decide quando richiamarli in base a ciò che chiedi.

Cosa può fare un agente connesso in Simplio3D

Il server MCP di Simplio3D mette a disposizione 123 strumenti: 52 in lettura, 68 in scrittura secondo un modello di scrittura controllata e 3 per eseguire workflow di agenti. Nel complesso, coprono progetti, ispezione di modelli 3D, materiali, blocchi di opzioni, logica condizionale, prezzi, moduli, richieste di preventivo e connessioni allo store. In pratica, un agente connesso può:

• Leggere un progetto reale: modelli, blocchi di opzioni e varianti, materiali, regole condizionali, blocchi e formule di prezzo, nonché campi dei moduli.
• Esaminare il modello 3D: nomi e gerarchia delle parti, per verificare che ogni opzione punti ancora a una mesh esistente.
• Verificare un configuratore: destinazioni di parti mancanti, materiali eliminati, regole che non possono mai attivarsi e varianti senza prezzo.
• Spiegare la logica e calcolare il prezzo di una configurazione: quale regola nasconde un'opzione e quanto costa un determinato insieme di selezioni, con calcolo eseguito sul server.
• Creare e modificare: creare progetti, blocchi di opzioni, varianti, materiali, regole condizionali e campi dei moduli, oltre a organizzare ciò che è già presente.
• Eseguire workflow di agenti: avviare un'attività in più passaggi, come una verifica del progetto o una riparazione sicura, rispondere alle sue domande e seguirne l'avanzamento. I workflow si fermano in attesa della tua approvazione e non pubblicano mai nulla.
• Riepilogare i lead: leggere le richieste di preventivo ricevute e ciò che ha configurato ciascun cliente.
• Rispondere alle domande sui prodotti usando la documentazione: cercare nella documentazione ufficiale di Simplio3D e citare la pagina, anziché rispondere in base alla memoria.

Ogni strumento, con l'ambito necessario e l'indicazione se è in lettura o scrittura, è elencato nel riferimento degli strumenti MCP.

Cosa non può fare

Alcune azioni restano impossibili, indipendentemente dagli ambiti che concedi. Un agente connesso non può pubblicare un progetto, creare un link di condivisione o modificare le impostazioni di incorporamento. Non può caricare file né eliminare un progetto. Non può connettere o disconnettere uno store Shopify o WooCommerce, né leggere le credenziali di tale store. Inoltre, non riceve mai accesso al database, chiavi API, segreti webhook o password per le viste condivise: gli strumenti restituiscono riepiloghi selezionati, non record grezzi.

Ambiti: assegna a ogni connessione solo ciò di cui ha bisogno

Una connessione può vedere e richiamare solo gli strumenti coperti dai suoi ambiti. Inizia con accesso in sola lettura e aggiungi un ambito di scrittura alla volta, secondo le necessità dell'attività.

Diverse connessioni limitate sono più sicure di una sola connessione che può fare tutto. Assegna all'assistente che verifica i prezzi una connessione dedicata con ambiti di lettura più la scrittura dei prezzi, e un'altra a quello che crea i progetti. In questo modo, la revoca di una non interromperà mai l'altra.

Come mantenere sotto controllo le modifiche

Consentire a un'AI di modificare un configuratore live funziona solo se una modifica errata non può raggiungere i tuoi clienti. Simplio3D gestisce ogni scrittura in tre passaggi: proposta, conferma, snapshot.

• Le modifiche a basso rischio vengono applicate senza attendere il tuo intervento, come rinominare un blocco o aggiungere una variante.
• Le modifiche ad alto rischio generano sempre e solo una proposta: prezzi, SKU, eliminazioni, modifiche in blocco, materiali condivisi e collegamenti ai prodotti dello store. La proposta resta in attesa in Modifiche AI in sospeso nella pagina Connessioni AI e riporta ogni modifica che verrebbe effettuata. Puoi premere Applica oppure ignorarla. Nessun agente può approvare la propria proposta e questa regola non può essere disattivata.
• Ogni modifica applicata viene salvata in uno snapshot, così può essere annullata, quindi nuovamente convalidata e registrata in un log di audit.

Le proposte hanno una durata limitata. Se il progetto è cambiato da quando l'agente ha formulato una proposta, quella precedente viene rifiutata anziché sovrascrivere le modifiche più recenti; chiedi di nuovo all'agente.

Inoltre, una chiamata a uno strumento riesce solo se vengono superati tutti e quattro i controlli: l'indirizzo email dell'account è verificato, il piano del proprietario dello spazio di lavoro è attivo, il ruolo del posto consente l'azione e la connessione dispone dell'ambito richiesto. Prevale il vincolo più restrittivo. Ad esempio, un posto Viewer non può mai apportare o confermare una modifica, indipendentemente dagli ambiti della sua connessione.

Connetti Claude senza token. Simplio3D è presente nella directory dei connettori di Claude. In Claude, apri Personalizza → Connettori, cerca Simplio3D e fai clic su Connetti, oppure seleziona Aggiungi connettore personalizzato e incolla https://app.simplio3d.ai/mcp. In entrambi i casi, Claude apre la pagina di accesso di Simplio3D e una schermata di consenso in cui scegli lo spazio di lavoro e gli ambiti, con l'accesso in sola lettura già selezionato. La connessione viene quindi visualizzata nello stesso elenco Connessioni AI, contrassegnata come app OAuth, e potrai ruotarla o revocarla da lì come qualsiasi altra.

Prompt da provare per primi

Indica il nome del progetto e chiedi prove: “quale regola lo nasconde?” fornisce una risposta più precisa di “perché è nascosto?”.

Limiti da conoscere prima di farvi affidamento

• Gli agenti leggono i dati salvati. L’editor salva automaticamente alcuni secondi dopo ogni modifica, quindi una modifica effettuata pochi istanti fa potrebbe non essere ancora visibile. Salva, quindi riprova.
• I prezzi e la logica lato server presentano alcune limitazioni. Il calcolo del prezzo e la valutazione delle regole coprono i casi più comuni, non tutti i comportamenti del configuratore pubblicato, come la tariffazione per unità del campo di input numerico. Ogni risultato indica cosa non è stato valutato, mentre l’anteprima e la visualizzazione condivisa pubblicata restano il riferimento definitivo.
• Limiti di frequenza. Ogni connessione può effettuare 300 richieste ogni cinque minuti. Un workspace accetta 30 modifiche AI applicate ogni dieci minuti, condivise tra tutti gli agenti connessi e l’assistente integrato.
• Le risposte di grandi dimensioni vengono ridotte e lo segnalano. Un risultato superiore a circa 60 KB viene riepilogato e contrassegnato come troncato, così l’agente non può scambiare una parte di un elenco per l’elenco completo.
• Ciò che l’agente legge viene inviato al tuo provider AI. Le richieste di preventivo includono nomi dei clienti e recapiti, quindi concedi l’ambito Preventivi con consapevolezza.
• I token scadono dopo 90 giorni. Ruotane subito uno se è stato incollato in una chat, in un ticket di assistenza o in una condivisione dello schermo. La rotazione disattiva immediatamente il vecchio token.

Un unico livello di strumenti dietro ogni interfaccia AI

Il server MCP non è un prodotto separato aggiunto successivamente. L’assistente AI integrato di Simplio3D, l’endpoint strumenti autenticato REST per le tue automazioni e i client MCP esterni chiamano tutti lo stesso registro di strumenti, con la stessa autenticazione, le stesse autorizzazioni e lo stesso registro di audit. Una funzionalità si comporta allo stesso modo ovunque venga chiamata e un ambito o ruolo che la blocca in un punto la blocca ovunque.

È anche questo che distingue MCP da REST API e SDK. SDK è un client tipizzato per il tuo codice, autenticato con una chiave API, e tale chiave non viene mai accettata dall’endpoint MCP. MCP è pensato per gli agenti AI, autenticati tramite una connessione il cui ambito viene definito per ogni strumento.