Pereiti prie turinio
Grįžti į tinklaraštį
mcpaiintegrationstutorial

Produktų konfigūratorius MCP: prijunkite Claude, Cursor ir VS Code prie Simplio3D

Simplio3D·
Produktų konfigūratorius MCP: prijunkite Claude, Cursor ir VS Code prie Simplio3D

Paklauskite AI asistento apie savo produkto konfigūratorių šiandien, ir jis atsakys pagal tai, ką įklijuosite į pokalbį: ekrano kopiją, parinkčių sąrašą ar įvestą kainą. MCP jungtys pašalina šį žingsnį. Jungtis suteikia asistentui tiesioginę, leidimais pagrįstą prieigą prie jūsų Simplio3D paskyros, todėl jis gali nuskaityti tikrą projektą (parinkčių blokus, sąlygines taisykles, kainodaros formulę, 3D modelyje esančių dalių pavadinimus) ir pagal tai atsakyti.

Šiame vadove paaiškinama, kas yra MCP jungtis, ką prijungtas agentas gali ir ko negali daryti sistemoje Simplio3D, kaip rizikingi pakeitimai lieka jūsų kontrolėje ir kaip prijungti Claude, Cursor arba VS Code.

Kas yra MCP jungtys?

Model Context Protocol (MCP) – tai atviras standartas, skirtas AI asistentams prijungti prie išorinių įrankių ir duomenų. Jį sudaro dvi pusės. MCP klientas yra jau naudojamas AI įrankis, pavyzdžiui, Claude, Cursor arba VS Code. MCP serveris – tai sistema, prie kurios jungiasi asistentas: ji pateikia įrankių sąrašą su kiekvieno įrankio aprašu ir schema, kuriuos asistentas gali iškviesti, kai jų reikia atsakant į klausimą.

Jungtis yra ryšys tarp šių dviejų dalių: serverio adresas ir kredencialas, nurodantis, kas jungiasi ir prie ko gali prieiti. Claude ją vadina pasirinktine jungtimi; kiti klientai – MCP serverio įrašu. Sistemoje Simplio3D tai visada yra du dalykai:

  • Galinis taškas: https://app.simplio3d.ai/mcp
  • Kredencialas: OAuth prisijungimas, kurį patvirtinate Simplio3D sutikimo lange, arba ryšio žetonas, kurį sukuriate skiltyje Dashboard → Integrations → AI Connections.

Prisijungus asistentas mato Simplio3D įrankius greta savųjų ir pagal jūsų užklausą nusprendžia, kada juos iškviesti.

Diagrama: Claude, Cursor ir VS Code jungiasi prie Simplio3D MCP serverio adresu app.simplio3d.ai/mcp. Kiekviena užklausa prieš pasiekdama 123 įrankius (52 skaitymo, 68 rašymo, 3 darbo eigos) ir vienos darbo srities projektus pereina keturias patikras (patvirtinta paskyra, aktyvus planas arba bandomasis laikotarpis, vaidmuo darbo srityje, ryšio apimtys). Didelės rizikos pakeitimai tampa pasiūlymu, kuris laukia skiltyje „Pending AI changes“, kol paspausite „Apply“, o tuomet sukuriama momentinė kopija.
Kiekvienas AI klientas naudoja tą patį galinį tašką ir pereina tuos pačius keturis patikrinimus. Didelės rizikos pakeitimas sustabdomas kaip pasiūlymas, kol jį pritaikysite valdymo skydelyje.

Ką prijungtas agentas gali atlikti Simplio3D

Simplio3D MCP serveris suteikia prieigą prie 123 įrankių: 52 skirti duomenims skaityti, 68 – duomenims rašyti pagal kontroliuojamo rašymo modelį, o 3 – agento darbo eigoms vykdyti. Jie apima projektus, 3D modelių tikrinimą, medžiagas, parinkčių blokus, sąlyginę logiką, kainodarą, formas, pasiūlymų užklausas ir parduotuvių jungtis. Praktikoje prijungtas agentas gali:

  • Skaityti realų projektą: jo modelius, parinkčių blokus ir variantus, medžiagas, sąlygines taisykles, kainodaros blokus bei formules ir formų laukus.
  • Nagrinėti 3D modelį: dalių pavadinimus ir hierarchiją, kad galėtų patikrinti, ar kiekviena parinktis vis dar taikoma egzistuojančiam tinkleliui.
  • Atlikti konfigūratoriaus auditą: aptikti trūkstamus dalių taikinius, pašalintas medžiagas, niekada nesuveikiančias taisykles ir variantus be kainos.
  • Paaiškinti logiką ir apskaičiuoti konfigūracijos kainą: nustatyti, kuri taisyklė slepia parinktį, ir serveryje apskaičiuoti, kiek kainuoja konkretus pasirinkimų rinkinys.
  • Kurti ir redaguoti: kurti projektus, parinkčių blokus, variantus, medžiagas, sąlygines taisykles ir formų laukus bei sutvarkyti jau esančius elementus.
  • Vykdyti agento darbo eigas: pradėti kelių etapų užduotį, pvz., projekto auditą arba saugų taisymą, atsakyti į jos klausimus ir stebėti eigą. Darbo eigos sustoja laukdamos jūsų patvirtinimo ir niekada neskelbia pakeitimų.
  • Apibendrinti potencialius klientus: peržiūrėti gautas pasiūlymų užklausas ir kiekvieno kliento sukurtą konfigūraciją.
  • Atsakyti į produktų klausimus remiantis dokumentacija: ieškoti oficialioje Simplio3D dokumentacijoje ir nurodyti puslapį, užuot atsakius iš atminties.

Kiekvienas įrankis, jam reikalinga apimtis ir tai, ar jis skaito, ar rašo duomenis, pateikti MCP įrankių nuorodoje.

Ko jis negali atlikti

Kai kurie veiksmai lieka nepasiekiami, nesvarbu, kokias apimtis suteiksite. Prijungtas agentas negali paskelbti projekto, sukurti bendrinimo nuorodos ar keisti įterpimo nustatymų. Jis negali įkelti failų ar pašalinti projekto. Jis negali prijungti ar atjungti Shopify ar WooCommerce parduotuvės arba nuskaityti tos parduotuvės prisijungimo duomenų. Jis taip pat niekada negauna prieigos prie duomenų bazės, API raktų, webhook paslapčių ar bendrinamo rodinio slaptažodžių: įrankiai pateikia atrinktas suvestines, o ne neapdorotus įrašus.

Apimtys: kiekvienai jungčiai suteikite tik tai, ko jai reikia

Jungtis gali matyti ir iškviesti tik tuos įrankius, kuriuos apima jos apimtys. Pradėkite nuo tik skaitymo prieigos ir prireikus pridėkite po vieną rašymo apimtį.

Simplio3D MCP jungties apimtys
ApimtisKą tai leidžiaSuteikite, kai agentas turėtų
Darbo sritis (skaitymas)Jūsų darbo srities, plano ir naudojimo suvestinėNurodo, kokį planą naudojate ir kiek jo išnaudojate
Projektai (skaitymas / rašymas)Išvardyti ir peržiūrėti projektus; kurti, pervadinti, dubliuoti ir keisti saugius nustatymusTeikti ataskaitas apie jūsų projektus arba kurti naujus
Ištekliai (skaitymas)Išvardyti išteklius ir peržiūrėti modelio dalių pavadinimus bei hierarchijąAptarti jūsų modeliuose esančius tinklelius
Medžiagos (skaityti / rašyti)Peržiūrėkite biblioteką; kurkite ir redaguokite medžiagas bei priskirkite jas variantamsKurkite arba tvarkykite savo medžiagų biblioteką
Konfigūratorius (skaityti / rašyti)Peržiūrėkite ir kurkite parinkčių blokus, variantus bei sąlygines taisyklesKurkite arba pertvarkykite pirkėjams rodomas parinktis
Kainodara (skaityti / rašyti)Peržiūrėkite kainas ir formules; siūlykite kainų, SKU ir formulių pakeitimusTvarkykite kainodarą. Kiekvienas kainodaros įrašas yra pasiūlymas, kurį patvirtinate.
Formos (skaitymas / rašymas)Skaitykite ir kurkite pasiūlymo bei atsiskaitymo formų laukusSukurkite arba pakoreguokite potencialių klientų formą
Pasiūlymai (skaitymas)Pateikti pasiūlymų užklausimai, įskaitant klientų duomenisApibendrinkite gaunamas potencialių klientų užklausas. Tai klientų duomenys, todėl suteikite prieigą apgalvotai.
Komercija (skaitymas / rašymas)Ar parduotuvė prijungta, jos produktai ir pasiūlymai susieti produktą arba nustatyti atsiskaitymo režimąSusiekite projektą su parduotuvės produktu. Tai niekada nesuteikia parduotuvės prisijungimo duomenų.
Darbo eigos (skaitymas / rašymas)Stebėkite agento darbo eigas; paleiskite jas, atsakykite į jų klausimus, pristabdykite arba atšaukiteVykdykite arba stebėkite ilgesnės trukmės užduotį, pvz., projekto auditą
Dokumentacija (skaitymas)Oficiali Simplio3D dokumentacija be jokių darbo srities duomenųAtsakykite į klausimus apie produktą, nurodydami šaltinį

Kelios mažos jungtys yra saugesnės nei viena, galinti atlikti viską. Asistentui, kuris peržiūri kainodarą, suteikite atskirą jungtį su skaitymo apimtimis ir kainodaros rašymo teise, o projektus kuriančiam asistentui – kitą. Atšaukus vieną jungtį, kita niekada nebus nutraukta.

Kaip pakeitimai lieka jūsų kontrolėje

Leisti AI redaguoti veikiantį konfigūratorių prasminga tik tada, jei netinkamas redagavimas negali pasiekti jūsų klientų. Simplio3D kiekvieną rašymo veiksmą vykdo trimis etapais: pasiūlyti, patvirtinti, sukurti momentinę kopiją.

  • Mažos rizikos pakeitimai atliekami nelaukiant jūsų, pavyzdžiui, pervadinamas blokas ar pridedamas variantas.
  • Didelės rizikos pakeitimai visada sukuria tik pasiūlymą: kainodaros, SKU, trynimo, masinio redagavimo, bendrinamų medžiagų ir parduotuvės produktų nuorodų pakeitimai. Pasiūlymas laukia skiltyje Pending AI changes, AI Connections puslapyje, ir pateikia visus numatomus pakeitimus. Galite pasirinkti Apply arba jį atmesti. Joks agentas negali patvirtinti savo paties pasiūlymo, o šios taisyklės negalima išjungti.
  • Kiekvienam pritaikytam pakeitimui sukuriama momentinė kopija, todėl jį galima atšaukti, iš naujo patikrinti ir užregistruoti audito žurnale.

Pasiūlymai galioja trumpai. Jei nuo agento pasiūlymo pateikimo projektas pasikeitė, senasis pasiūlymas atmetamas, užuot perrašius naujesnius jūsų pakeitimus; paprašykite agento dar kartą.

Be to, įrankio iškvietimas sėkmingas tik tuomet, kai praeina visus keturis patikrinimus: paskyros el. pašto adresas yra patvirtintas, darbo srities savininko planas aktyvus, vietos vaidmuo leidžia atlikti veiksmą ir jungtis turi reikiamą apimtį. Galioja siauriausia teisė. Pavyzdžiui, Viewer vietos naudotojas niekada negali atlikti ar patvirtinti pakeitimo, kad ir kokias apimtis turėtų jo jungtis.

Kaip nustatyti MCP jungtis, skirtas Simplio3D

Prieigos rakto būdas veikia kiekvienoje kliento programoje. Naudojate Claude? Toliau pateiktas OAuth būdas leidžia praleisti prieigos raktą.

  1. Atidaryti AI Connections

    Sistemoje Simplio3D eikite į Dashboard → Integrations → AI Connections ir nukopijuokite puslapio viršuje pateiktą MCP galinį tašką.

  2. Sukurkite po vieną jungtį kiekvienam įrankiui

    Spustelėkite Create connection ir pavadinkite ją pagal įrankį, kuris ją naudos, pavyzdžiui, „Claude Desktop“ arba „Cursor“. Atskira jungtis kiekvienam įrankiui leidžia aiškiai matyti, kurią vėliau reikia atšaukti.

  3. Pasirinkite darbo sritį

    Jungtis visam laikui susiejama su čia pasirinkta darbo sritimi. Jei norite dirbti su dviem darbo sritimis, sukurkite po jungtį kiekvienoje iš jų.

  4. Pažymėkite tik tas apimtis, kurių jam reikia

    Pradėkite nuo tik skaitymo apimčių ir rašymo apimtis pridėkite po vieną. Suteikite prieigą prie Quotes tik tada, kai agentas turi matyti klientų duomenis.

  5. Nukopijuokite prieigos raktą ir pridėkite jį prie savo įrankio

    Prieigos raktas prasideda smcp_ ir rodomas tik vieną kartą – daugiau niekada. Įklijuokite jį į savo AI įrankį kartu su galiniu tašku, kaip parodyta toliau pateiktoje lentelėje. Elkitės su juo kaip su slaptažodžiu: jis galioja 90 dienų, o jūs bet kada galite jį pakeisti arba panaikinti.

  6. Patikrinkite ryšį

    Paklauskite to, į ką gali atsakyti tik jūsų paskyra: „Išvardykite mano Simplio3D projektus ir nurodykite, kurie iš jų yra paskelbti.“ Jei atsakyme nurodomi jūsų tikrieji projektai, jungtis veikia.

Claude prijungimas be žetono. Simplio3D pateiktas Claude jungčių kataloge. Claude aplinkoje atidarykite Tinkinti → Jungtys, ieškokite Simplio3D ir spustelėkite Prijungti arba pasirinkite Pridėti pasirinktinę jungtį ir įklijuokite https://app.simplio3d.ai/mcp. Abiem atvejais Claude atidaro Simplio3D prisijungimo ir sutikimo ekraną, kuriame pasirenkate darbo sritį bei apimtis; tik skaitymo prieiga jau bus pažymėta. Tada jungtis rodoma tame pačiame AI jungčių sąraše, pažymėta kaip OAuth programa; ten ją galite atnaujinti arba atšaukti kaip ir bet kurią kitą.

Kur kiekvienas AI klientas priima Simplio3D jungtį
AI klientasKur jį pridėtiKą pridėti
Claude (OAuth)Tinkinti → Jungtys: ieškokite Simplio3D arba pasirinkite „Pridėti pasirinktinę jungtį“Nieko iš katalogo; tai pasirinktinės jungties galinio taško URL. Jokio žetono: vietoje to patvirtinate Simplio3D sutikimo ekraną.
Claude DesktopNustatymai → Kūrėjas → Redaguoti konfigūraciją (claude_desktop_config.json)„simplio3d“ http tipo serveris su galinio taško URL ir Authorization: Bearer smcp_… antrašte
Claude CodeJūsų terminalasclaude mcp add --transport http simplio3d https://app.simplio3d.ai/mcp --header "Authorization: Bearer smcp_…"
Cursor~/.cursor/mcp.json arba .cursor/mcp.json vienam projektui„simplio3d“ serveris su galinio taško URL ir Authorization antrašte
VS Code (GitHub Copilot).vscode/mcp.jsonHTTP serveris su galinio taško URL, nuskaitantis žetoną iš slaptažodžio raginimo, užuot saugojęs jį faile
ChatGPT ir CodexChatGPT → Įskiepiai: ieškokite Simplio3D, tada įdiekite įskiepį ir prijunkite Simplio3DNieko: įskiepis turi jungtį. Žetono nereikia: prisijungiate prie Simplio3D ir patvirtinate prieigą

Pirmiausia išbandykite šias užklausas

Nurodykite projekto pavadinimą ir prašykite įrodymų: „kuri taisyklė tai slepia?“ pateiks tikslesnį atsakymą nei „kodėl tai paslėpta?“.

Simplio3D MCP jungties pavyzdinės užklausos
KlauskiteKą tikrina agentasKą gaunate atgal
„Patikrinkite mano „Oak Dining Table“ konfigūratorių ir išvardykite viską, kas neveikia.“Randa projektą, tada jį patikrina, įskaitant 3D modelio dalių pavadinimusIšvados pagal svarbumą: trūkstami dalių taikiniai, pašalintos medžiagos, taisyklės, kurios niekada negali suveikti, variantai be kainos
„Kodėl riešutmedžio apdaila paslepiama, kai pasirenku mažą viršų?“Parinkčių blokai ir sąlyginės taisyklės, po to atliekamas jų įvertinimasJą slepianti taisyklė ir atitikusi sąlyga
„Ar kiekvienas šio konfigūratoriaus variantas turi kainą?“Kainodaros blokai, po to – patikros etapasVariantai be kainos pagal pavadinimą, nurodant kainodaros bloką, kuriam kiekvienas priklauso
„Kurios parinktys taikomos modelyje nebeegzistuojančioms dalims?“Tikslai, kuriuos sukūrėte pagal tikrąją geometrijąIšvardyti nebeaktualūs tikslai
„Kiek kainuotų didelio dydžio ąžuolas?“Parinkčių blokai ir serverio pusėje atliekamas kainos apskaičiavimasBazinė kaina, kiekvienas koregavimas, mokestis ir bendra suma projekto valiuta
„Apibendrinkite šią savaitę gautas užklausas dėl pasiūlymų.“Užklausos dėl pasiūlymų ir kiekviena konfigūracijaKontaktinė informacija, kiekvieno kliento pasirinkta konfigūracija ir tuo metu galiojusi kaina

Ribojimai, kuriuos verta žinoti prieš juo pasikliaujant

  • აგენტai nuskaito išsaugotus duomenis. Redaktorius automatiškai išsaugo pakeitimus praėjus kelioms sekundėms po kiekvieno pakeitimo, todėl prieš akimirką atliktas redagavimas dar gali būti nematomas. Išsaugokite, tada paklauskite dar kartą.
  • Serverio pusės kainoms ir logikai taikomos išlygos. Kainos skaičiavimas ir taisyklių vertinimas apima įprastus atvejus, tačiau ne kiekvieną publikuoto konfigūratoriaus veikimą, pavyzdžiui, kainodarą pagal vienetą, taikomą Number Input. Kiekviename rezultate nurodoma, kas nebuvo įvertinta, o Preview ir publikuota bendrinimo peržiūra išlieka galutiniu kriterijumi.
  • Dažnio ribojimai. Kiekvienas ryšys gali pateikti 300 užklausų per penkias minutes. Darbo srityje galima pritaikyti 30 AI pakeitimų per dešimt minučių; šis limitas bendras visiems prijungtiems agentams ir integruotam asistentui.
  • Dideli atsakymai sutrumpinami ir apie tai pranešama. Didesnis nei maždaug 60 KB rezultatas apibendrinamas ir pažymimas kaip sutrumpintas, todėl agentas negali supainioti sąrašo dalies su visu sąrašu.
  • Agentų skaitoma informacija siunčiama jūsų AI tiekėjui. Pasiūlymų užklausose pateikiami klientų vardai ir kontaktiniai duomenys, todėl Quotes apimtį suteikite apgalvotai.
  • Žetonų galiojimas baigiasi po 90 dienų. Nedelsdami pakeiskite žetoną, jei jis buvo įklijuotas į pokalbį, pagalbos užklausą ar ekrano bendrinimo sesiją. Pakeitus žetoną, senasis iškart nustoja galioti.

Vienas įrankių sluoksnis už kiekvienos AI sąsajos

MCP serveris nėra atskiras prijungtas produktas. Simplio3D integruotas AI asistentas, autentifikuotas REST įrankio galinis taškas jūsų automatizacijoms ir išoriniai MCP klientai naudoja tą patį įrankių registrą, tą patį autentifikavimą, leidimus ir audito žurnalą. Funkcija veikia vienodai, nesvarbu, iš kur ją iškviečiate, o apimtis ar vaidmuo, blokuojantis ją vienoje vietoje, blokuoja ją visur.

Taip MCP skiriasi ir nuo REST API ir SDK. SDK yra tipizuotas klientas jūsų kodui, autentifikuojamas API raktu, o šis raktas niekada nepriimamas MCP galiniame taške. MCP skirtas AI agentams, autentifikuojamiems ryšiu, kuriam kiekvienam įrankiui nustatote atskirą apimtį.

Klausimai apie MCP jungtis

Visi jie: Starter, Pro ir Enterprise, taip pat 30 dienų Pro bandomasis laikotarpis, kurį gauna kiekviena paskyra. MCP jungtys į Starter įtrauktos nuo 2026 m. rugsėjo. Naudojant Starter, prijungtas agentas laikosi tų pačių plano taisyklių kaip ir valdymo skydelis, todėl negali kurti Modular projektų ar dubliuoti projekto.

Pirmiausia kuriate konfigūratorių?

Kaip projektas nuo 3D modelio pereina prie pasirinkimų, sąlyginės logikos ir kainodaros, dar prieš agentui jį perskaitant.

Norite, kad agentas tikrintų jūsų kainas?

Kainų blokai ir formulių redaktorius, kuriuos prijungtas agentas nuskaito ir pagal juos skaičiuoja.

Norite, kad AI taip pat sukurtų konfigūratorių?

Sugeneruokite naudodami AI parinktis, taisykles, kainą ir formą pagal produkto aprašymą tiesiog Simplio3D.

Naudojate ChatGPT?

Simplio3D įskiepis ChatGPT įskiepių kataloge užmezga šį ryšį už jus – vietoj žetono siūlomas vedamas prisijungimas.

Iš tinklaraščio

Vadovai, pamokos ir naujienos iš Simplio3D komandos.

Kurkite, diekite ir plėskite 3D prekybą.

Naudokite 3D produktų konfigūratorių, kad didintumėte pardavimus ir generuotumėte pasiūlymus tiesiai iš savo svetainės

Susiję straipsniai