Salt la conținut
Înapoi la blog
mcpaiintegrationstutorial

MCP pentru configurator de produse: conectați Claude, Cursor și VS Code la Simplio3D

Simplio3D·
MCP pentru configurator de produse: conectați Claude, Cursor și VS Code la Simplio3D

Întrebați astăzi un asistent AI despre configuratorul dvs. de produse și acesta răspunde pe baza a orice lipiți în chat: o captură de ecran, o listă de opțiuni, un preț introdus manual. Conectorii MCP elimină acest pas. Un conector oferă asistentului acces direct, cu permisiuni, la contul dvs. Simplio3D, astfel încât să citească proiectul real (blocurile de opțiuni, regulile condiționale, formula de preț, denumirile pieselor din modelul 3D) și să răspundă pe baza acestuia.

Acest ghid explică ce este un conector MCP, ce poate și ce nu poate face un agent conectat în Simplio3D, cum rămân modificările riscante sub controlul dvs. și cum să conectați Claude, Cursor sau VS Code.

Ce sunt conectorii MCP?

Model Context Protocol (MCP) este un standard deschis pentru conectarea asistenților AI la instrumente și date externe. Are două componente. Un client MCP este instrumentul AI pe care îl utilizați deja, precum Claude, Cursor sau VS Code. Un server MCP este sistemul la care se conectează asistentul: publică o listă de instrumente, fiecare cu o descriere și o schemă, pe care asistentul le poate apela atunci când o întrebare le necesită.

Un conector reprezintă legătura dintre cele două: adresa serverului, plus o acreditare care indică cine se conectează și ce poate accesa. Claude îl numește conector personalizat; alți clienți îl numesc o intrare de server MCP. Pentru Simplio3D sunt întotdeauna aceleași două elemente:

  • Endpoint-ul: https://app.simplio3d.ai/mcp
  • O acreditare: o autentificare OAuth pe care o aprobați într-un ecran de consimțământ Simplio3D sau un token de conectare pe care îl creați în Tablou de bord → Integrări → Conexiuni AI.

Odată conectat, asistentul vede instrumentele Simplio3D alături de propriile instrumente și decide când să le apeleze în funcție de solicitarea dvs.

Diagramă: Claude, Cursor și VS Code se conectează la serverul MCP Simplio3D la app.simplio3d.ai/mcp. Fiecare apel trece prin patru verificări (cont verificat, plan activ sau perioadă de probă, rol în spațiul de lucru, permisiuni de conexiune) înainte de a ajunge la 123 de instrumente (52 de citire, 68 de scriere, 3 de flux de lucru) și la proiectele unui singur spațiu de lucru. Modificările cu risc ridicat devin o propunere care așteaptă în Pending AI changes până când apeși Apply, apoi sunt salvate ca instantanee.
Fiecare client AI trece prin același endpoint și aceleași patru verificări. O modificare cu risc ridicat rămâne o propunere până când o aplici în tabloul de bord.

Ce poate face un agent conectat în Simplio3D

Serverul MCP Simplio3D pune la dispoziție 123 de instrumente: 52 pentru citire, 68 pentru scriere în cadrul unui model de scriere controlată și 3 pentru rularea fluxurilor de lucru ale agentului. Împreună, acestea acoperă proiecte, inspectarea modelelor 3D, materiale, blocuri de opțiuni, logică condițională, prețuri, formulare, solicitări de ofertă și conexiuni cu magazine. În practică, un agent conectat poate:

  • Citi un proiect real: modelele, blocurile de opțiuni și variantele acestuia, materialele, regulile condiționale, blocurile și formula de preț, precum și câmpurile formularului.
  • Analiza modelul 3D: numele și ierarhia componentelor, pentru a verifica dacă fiecare opțiune vizează în continuare o plasă existentă.
  • Audita un configurator: ținte de componente lipsă, materiale șterse, reguli care nu pot fi declanșate niciodată și variante fără preț.
  • Explica logica și calcula prețul unei configurații: ce regulă ascunde o opțiune și cât costă un anumit set de selecții, calculat pe server.
  • Construi și edita: crea proiecte, blocuri de opțiuni, variante, materiale, reguli condiționale și câmpuri de formular și organiza ceea ce există deja.
  • Rula fluxuri de lucru ale agentului: porni o sarcină în mai mulți pași, precum auditarea unui proiect sau o remediere sigură, răspunde la întrebările acesteia și urmări progresul. Fluxurile de lucru se opresc pentru aprobarea dvs. și nu publică niciodată.
  • Rezuma potențiali clienți: citi solicitările de ofertă primite și configurația aleasă de fiecare client.
  • Răspunde la întrebări despre produs folosind documentația: căuta în documentația oficială Simplio3D și cita pagina, în loc să răspundă din memorie.

Fiecare instrument, inclusiv domeniul de aplicare necesar și dacă citește sau scrie, este listat în referința instrumentelor MCP.

Ce nu poate face

Anumite acțiuni rămân inaccesibile, indiferent de domeniile de aplicare acordate. Un agent conectat nu poate publica un proiect, crea un link de partajare sau modifica setările de încorporare. Nu poate încărca fișiere sau șterge un proiect. Nu poate conecta sau deconecta un magazin Shopify sau WooCommerce și nici nu poate citi acreditările acelui magazin. De asemenea, nu primește niciodată acces la baza de date, chei API, secrete webhook sau parole pentru vizualizări partajate: instrumentele returnează rezumate selectate, nu înregistrări brute.

Arii de acces: oferiți fiecărei conexiuni doar ceea ce are nevoie

O conexiune poate vedea și apela doar instrumentele acoperite de ariile sale de acces. Începeți cu acces numai pentru citire și adăugați câte o arie de scriere, pe măsură ce sarcina o necesită.

Permisiuni de conexiune MCP Simplio3D
PermisiuneCe permiteAcordă-o atunci când agentul trebuie să
Spațiu de lucru (citire)Rezumatul spațiului dvs. de lucru, al planului și al utilizăriiVă indică planul pe care îl aveți și cât de mult îl utilizați
Proiecte (citire / scriere)Listați și inspectați proiecte; creați, redenumiți, duplicați și modificați setările sigureGenerați rapoarte despre proiectele dvs. sau configurați altele noi
Resurse (citire)Listați resursele și inspectați numele pieselor și ierarhia unui modelDiscutați despre mesh-urile din modelele dvs.
Materiale (citire / scriere)Consultați biblioteca; creați și editați materiale și atribuiți-le variantelorCreați sau organizați biblioteca de materiale
Configurator (citire / scriere)Consultați și creați blocuri de opțiuni, variante și reguli condiționaleCreați sau restructurați opțiunile pe care le văd cumpărătorii
Prețuri (citire / scriere)Consultați prețurile și formulele; propuneți modificări ale prețurilor, SKU-urilor și formulelorLucrează la prețuri. Fiecare modificare de preț este o propunere pe care o aprobi.
Formulare (citire / scriere)Citește și creează câmpuri pentru formularele de ofertă și finalizare a comenziiCreează sau ajustează formularul de leaduri
Oferte (citire)Solicitări de ofertă trimise, inclusiv detaliile cliențilorRezumați leadurile primite. Acestea sunt date ale clienților, așa că acordați accesul în mod deliberat.
Comerț (citire / scriere)Dacă un magazin este conectat, produsele acestuia și propuneri pentru a asocia un produs sau a seta modul de finalizare a comenziiAsociază un proiect cu un produs din magazin. Nu oferă niciodată acces la datele de autentificare ale magazinului.
Fluxuri de lucru (citire / scriere)Urmărește fluxurile de lucru ale agentului; pornește-le, răspunde la întrebările lor, întrerupe-le temporar sau anulează-leRulează sau monitorizează o activitate de durată, cum ar fi un audit al proiectului
Documentație (citire)Documentația oficială Simplio3D, fără date din spațiul de lucruRăspunde la întrebări despre produs folosind o sursă

Mai multe conexiuni restrânse sunt mai sigure decât una care poate face totul. Oferiți asistentului care verifică prețurile propria conexiune, cu arii de citire plus scriere pentru prețuri, iar celui care construiește proiecte o altă conexiune. Astfel, revocarea uneia nu o întrerupe niciodată pe cealaltă.

Cum rămân modificările sub controlul dvs.

Permiterea editării de către un AI a unui configurator activ funcționează doar dacă o editare greșită nu poate ajunge la clienții dvs. Simplio3D gestionează fiecare scriere în trei pași: propune, confirmă, salvează instantaneu.

  • Editările cu risc redus sunt efectuate fără să aștepte intervenția dvs., cum ar fi redenumirea unui bloc sau adăugarea unei variante.
  • Modificările cu risc ridicat produc întotdeauna doar o propunere: prețuri, SKU-uri, ștergeri, editări în masă, materiale partajate și linkuri către produse din magazin. Propunerea așteaptă în secțiunea Modificări AI în așteptare din pagina Conexiuni AI și listează fiecare modificare pe care ar efectua-o. Apăsați Aplică sau respingeți-o. Niciun agent nu își poate aproba propria propunere, iar regula nu poate fi dezactivată.
  • Fiecare modificare aplicată este salvată instantaneu, astfel încât poate fi anulată, apoi revalidată și înregistrată într-un jurnal de audit.

Propunerile au o durată de viață scurtă. Dacă proiectul s-a modificat de când agentul a propus ceva, propunerea veche este refuzată în loc să suprascrie editările dvs. mai recente; solicitați din nou agentului.

În plus, un apel de instrument reușește doar când toate cele patru verificări sunt îndeplinite: adresa de e-mail a contului este verificată, planul proprietarului spațiului de lucru este activ, rolul locului permite acțiunea, iar conexiunea deține aria de acces. Se aplică întotdeauna cea mai restrictivă. De exemplu, un loc de Viewer nu poate efectua sau confirma niciodată o modificare, indiferent de ariile de acces ale conexiunii sale.

Cum configurezi conectorii MCP pentru Simplio3D

Ruta cu token funcționează în orice client. Folosești Claude? Ruta OAuth de mai jos elimină necesitatea tokenului.

  1. Deschide AI Connections

    În Simplio3D, accesează Tablou de bord → Integrări → AI Connections și copiază endpointul MCP afișat în partea de sus a paginii.

  2. Creează câte o conexiune pentru fiecare instrument

    Fă clic pe Creează conexiune și denumește-o după instrumentul care o va utiliza, precum „Claude Desktop” sau „Cursor”. O conexiune pentru fiecare instrument îți arată clar pe care să o revoci ulterior.

  3. Alege spațiul de lucru

    O conexiune este asociată permanent cu spațiul de lucru pe care îl alegi aici. Pentru a lucra în două spații de lucru, creează câte o conexiune din fiecare.

  4. Bifează doar permisiunile de care are nevoie

    Începe cu acces doar pentru citire și adaugă permisiuni de scriere pe rând. Acordă acces la Quotes doar atunci când agentul trebuie să vadă detaliile clienților.

  5. Copiază tokenul și adaugă-l în instrumentul tău

    Tokenul începe cu smcp_ și este afișat o singură dată, niciodată din nou. Lipește-l în instrumentul tău AI împreună cu endpointul, așa cum este indicat în tabelul de mai jos. Tratează-l ca pe o parolă: este valabil 90 de zile și îl poți roti sau revoca oricând.

  6. Verifică conexiunea

    Întreabă ceva la care doar contul tău poate răspunde: „Afișează proiectele mele Simplio3D și spune-mi care dintre ele sunt publicate.” Dacă răspunsul menționează proiectele tale reale, conectorul funcționează.

Conectarea Claude fără token. Simplio3D este listat în directorul de conectori Claude. În Claude, deschideți Personalizare → Conectori, căutați Simplio3D și faceți clic pe Conectare sau alegeți Adăugați un conector personalizat și inserați https://app.simplio3d.ai/mcp. În ambele cazuri, Claude deschide pagina de conectare Simplio3D și un ecran de consimțământ, unde alegeți spațiul de lucru și domeniile de aplicare, cu accesul doar pentru citire bifat în mod implicit. Conexiunea apare apoi în aceeași listă de conexiuni AI, marcată aplicație OAuth, iar de acolo o puteți roti sau revoca la fel ca pe oricare alta.

Unde fiecare client AI configurează conectorul Simplio3D
client AIUnde să îl adăugațiCe să adăugați
Claude (OAuth)Personalizare → Conectori: caută Simplio3D sau Adaugă un conector personalizatNimic din director; URL-ul endpointului pentru un conector personalizat. Fără token: aprobi în schimb ecranul de consimțământ Simplio3D.
Claude DesktopSetări → Dezvoltator → Editați configurația (claude_desktop_config.json)Un server „simplio3d” de tip http, cu URL-ul endpointului și un antet Authorization: Bearer smcp_…
Claude CodeTerminalul tăuclaude mcp add --transport http simplio3d https://app.simplio3d.ai/mcp --header "Authorization: Bearer smcp_…"
Cursor~/.cursor/mcp.json sau .cursor/mcp.json pentru un proiectUn server „simplio3d” cu URL-ul endpointului și antetul Authorization
VS Code (GitHub Copilot).vscode/mcp.jsonUn server HTTP cu URL-ul endpointului, care citește tokenul dintr-o solicitare de parolă în loc să îl stocheze în fișier
ChatGPT și CodexChatGPT → Pluginuri: caută Simplio3D, apoi instalează pluginul și conectează Simplio3DNimic: pluginul include conectorul. Nu este necesar niciun token: te autentifici pe Simplio3D și aprobi accesul

Prompturi pe care să le încercați mai întâi

Menționați proiectul și cereți dovezi: „care regulă o ascunde?” oferă un răspuns mai precis decât „de ce este ascunsă?”.

Exemple de solicitări pentru un conector MCP Simplio3D
ÎntreabăCe verifică agentulCe primești înapoi
„Verifică configuratorul meu Oak Dining Table și enumeră tot ce nu funcționează.”Găsește proiectul, apoi îl validează, inclusiv numele componentelor din modelul 3DRezultate după severitate: ținte de piese lipsă, materiale șterse, reguli care nu se pot declanșa niciodată, variante fără preț
„De ce este ascuns finisajul Nuc atunci când aleg blatul mic?”Blocurile de opțiuni și regulile condiționale, apoi le evalueazăRegula care îl ascunde și condiția care s-a potrivit
„Fiecare variantă din acest configurator are un preț?”Blocurile de prețuri, apoi o etapă de validareVariantele fără preț după denumire, împreună cu blocul de prețuri din care face parte fiecare
„Care opțiuni vizează piese care nu mai există în model?”Țintele pe care le-ai creat pe baza geometriei realeȚintele neactualizate, listate
„Cât ar costa stejarul în dimensiunea mare?”Blocurile de opțiuni, urmate de un calcul al prețului pe serverPrețul de bază, fiecare ajustare, taxa și totalul în moneda proiectului
„Rezumă cererile de ofertă primite în această săptămână.”Cererile de ofertă și fiecare configurareDatele de contact, configurația aleasă de fiecare client și prețul din acel moment

Limitări pe care merită să le cunoașteți înainte de a vă baza pe acesta

  • Agenții citesc datele salvate. Editorul salvează automat la câteva secunde după fiecare modificare, astfel încât o editare făcută cu câteva momente în urmă este posibil să nu fie încă vizibilă. Salvați, apoi întrebați din nou.
  • Prețurile și logica de pe server au anumite limitări. Calculul prețului și evaluarea regulilor acoperă cazurile obișnuite, nu toate comportamentele configuratorului publicat, cum ar fi stabilirea prețului per unitate pentru Number Input. Fiecare rezultat indică ce nu a evaluat, iar Previzualizarea și vizualizarea partajată publicată rămân referința finală.
  • Limite de solicitări. Fiecare conexiune poate efectua 300 de solicitări la fiecare cinci minute. Un spațiu de lucru acceptă 30 de modificări AI aplicate la fiecare zece minute, partajate între toți agenții conectați și asistentul integrat.
  • Răspunsurile mari sunt trunchiate și acest lucru este indicat. Un rezultat de peste aproximativ 60 KB este rezumat și marcat ca trunchiat, astfel încât agentul să nu poată confunda o parte dintr-o listă cu întreaga listă.
  • Ceea ce citește agentul este trimis furnizorului dvs. de AI. Cererile de ofertă includ numele clienților și datele de contact, așadar acordați cu atenție domeniul Quotes.
  • Tokenurile expiră după 90 de zile. Rotiți imediat unul dacă a fost lipit într-un chat, un tichet de asistență sau o partajare de ecran. Rotirea oprește imediat vechiul token.

Un singur strat de instrumente în spatele fiecărei interfețe AI

Serverul MCP nu este un produs separat adăugat ulterior. Asistentul AI integrat al Simplio3D, endpointul de instrumente REST autentificat pentru propriile dvs. automatizări și clienții MCP externi apelează cu toții același registru de instrumente, protejat de aceeași autentificare, aceleași permisiuni și același jurnal de audit. O capabilitate se comportă la fel indiferent de unde o apelați, iar un domeniu sau un rol care o blochează într-un loc o blochează peste tot.

Aceasta este și diferența dintre MCP și REST API și SDK. SDK este un client tipizat pentru propriul dvs. cod, autentificat cu o cheie API, iar acea cheie nu este acceptată niciodată la endpointul MCP. MCP este destinat agenților AI, autentificați printr-o conexiune pe care o configurați pentru fiecare instrument.

Întrebări despre conectorii MCP

Toate: Starter, Pro și Enterprise, precum și perioada de probă Pro de 30 de zile cu care începe fiecare cont. Conectorii MCP sunt incluși în Starter din septembrie 2026. În Starter, un agent conectat respectă aceleași reguli de plan ca tabloul de bord, astfel încât nu poate crea proiecte Modular și nu poate duplica un proiect.

Construiți mai întâi configuratorul?

Cum trece un proiect de la un model 3D la opțiuni, logică condițională și prețuri, înainte ca un agent să îl analizeze.

Vrei ca agentul să îți verifice prețurile?

Blocurile de prețuri și editorul de formule pe care un agent conectat le citește și pe baza cărora efectuează calcule.

Vrei ca AI să creeze și configuratorul?

Generează cu AI opțiunile, regulile, prețul și formularul pe baza unei descrieri de produs, direct în Simplio3D.

Folosești ChatGPT?

Pluginul Simplio3D din directorul de pluginuri ChatGPT realizează această conexiune pentru tine, cu autentificare ghidată în locul unui token.

De pe blog

Ghiduri, tutoriale și știri de la echipa Simplio3D.

Creează, lansează și extinde comerțul 3D.

Deține un configurator de produse 3D pentru a crește vânzările și a genera oferte direct de pe site-ul tău

Articole similare

Pluginul Simplio3D pentru ChatGPT: tutorial pas cu pas

Pluginul Simplio3D pentru ChatGPT: tutorial pas cu pas

Simplio3D are acum un plugin oficial în directorul de pluginuri ChatGPT. Instalați-l, conectați-vă spațiul de lucru și cereți-i lui ChatGPT să auditeze, să calculeze prețuri, să creeze și să gestioneze configuratoarele dvs. 3D.