Ugrás a tartalomhoz
Vissza a bloghoz
mcpaiintegrationstutorial

Termékkonfigurátor MCP: Claude, Cursor és VS Code csatlakoztatása a következőhöz: Simplio3D

Simplio3D·
Termékkonfigurátor MCP: Claude, Cursor és VS Code csatlakoztatása a következőhöz: Simplio3D

Kérdezzen meg még ma egy AI-asszisztenst a termékkonfigurátoráról, és az abból válaszol, amit beilleszt a chatbe: képernyőképből, opciólistából vagy egy beírt árból. A MCP-kapcsolatok ezt a lépést kiküszöbölik. Egy kapcsolat közvetlen, engedélyezett hozzáférést biztosít az asszisztensnek az Ön Simplio3D fiókjához, így a tényleges projektet olvassa (az opcióblokkokat, a feltételes szabályokat, az árképzési képletet, a 3D modellben szereplő alkatrészneveket), és ezek alapján válaszol.

Ez az útmutató bemutatja, mi az MCP-kapcsolat, mit tehet és mit nem tehet egy csatlakoztatott ügynök a Simplio3D rendszerben, hogyan maradnak az Ön irányítása alatt a kockázatos módosítások, valamint hogyan csatlakoztathatja a Claude-ot, a Cursort vagy a VS Code-ot.

Mik azok az MCP-kapcsolatok?

A Model Context Protocol (MCP) egy nyílt szabvány az AI-asszisztensek külső eszközökhöz és adatokhoz való csatlakoztatására. Két oldala van. Az MCP-kliens az Ön által már használt AI-eszköz, például a Claude, a Cursor vagy a VS Code. Az MCP-szerver az a rendszer, amelyhez az asszisztens csatlakozik: közzéteszi az eszközök listáját, mindegyiket leírással és sémával, amelyeket az asszisztens meghívhat, amikor egy kérdéshez szüksége van rájuk.

A kapcsolat köti össze a kettőt: a szerver címe, valamint egy hitelesítő adat, amely meghatározza, ki csatlakozik és mihez férhet hozzá. A Claude ezt egyéni kapcsolatnak nevezi; más kliensek MCP-szerverbejegyzésnek hívják. A Simplio3D esetében mindig ugyanarról a két elemről van szó:

  • Végpont: https://app.simplio3d.ai/mcp
  • Hitelesítő adat: egy OAuth-bejelentkezés, amelyet a Simplio3D hozzájárulási képernyőjén hagy jóvá, vagy egy kapcsolati token, amelyet a Dashboard → Integrációk → AI-kapcsolatok menüpontban hoz létre.

A csatlakoztatás után az asszisztens a saját eszközei mellett látja a Simplio3D eszközeit is, és az Ön kérdése alapján dönti el, mikor hívja meg őket.

Diagram: Claude, Cursor és VS Code kapcsolódik az app.simplio3d.ai/mcp címen található Simplio3D MCP-kiszolgálóhoz. Minden hívás négy ellenőrzésen megy keresztül (hitelesített fiók, aktív csomag vagy próbaidőszak, munkaterületi szerepkör, kapcsolati jogosultsági körök), mielőtt elérné a 123 eszközt (52 olvasási, 68 írási, 3 munkafolyamat-) és egy munkaterület projektjeit. A magas kockázatú módosítások javaslattá válnak, amely az Függőben lévő AI-módosítások között várakozik, amíg meg nem nyomja az Alkalmaz gombot, majd pillanatfelvétel készül róluk.
Minden AI-kliens ugyanazon a végponton és ugyanazon a négy ellenőrzésen halad át. A magas kockázatú módosítás javaslatként várakozik, amíg nem alkalmazza azt az irányítópulton.

Mire képes egy csatlakoztatott ügynök a(z) Simplio3D rendszerben

A(z) Simplio3D MCP-kiszolgáló 123 eszközt kínál: 52 olvasási, 68 szabályozott írási modellben működő írási, valamint 3 ügynöki munkafolyamatokat futtató eszközt. Ezek lefedik a projekteket, a 3D-modellek vizsgálatát, az anyagokat, az opcióblokkokat, a feltételes logikát, az árazást, az űrlapokat, az árajánlatkéréseket és az áruházi kapcsolatokat. A gyakorlatban egy csatlakoztatott ügynök a következőkre képes:

  • Valós projekt olvasása: a modellek, opcióblokkok és változatok, anyagok, feltételes szabályok, árazási blokkok és képletek, valamint űrlapmezők megtekintése.
  • A 3D-modell vizsgálata: az alkatrésznevek és a hierarchia ellenőrzése, így meggyőződhet arról, hogy minden opció létező hálóra mutat-e.
  • Konfigurátor auditálása: hiányzó alkatrészcélok, törölt anyagok, soha nem aktiválódó szabályok és árazás nélküli változatok feltárása.
  • A logika magyarázata és egy konfiguráció beárazása: annak megállapítása, melyik szabály rejt el egy opciót, és mennyibe kerül egy adott választáskészlet a szerveren végzett számítás alapján.
  • Létrehozás és szerkesztés: projektek, opcióblokkok, változatok, anyagok, feltételes szabályok és űrlapmezők létrehozása, valamint a meglévő elemek rendezése.
  • Ügynöki munkafolyamatok futtatása: többlépéses feladatok, például projektaudit vagy biztonságos javítás indítása, a kérdéseik megválaszolása és az előrehaladásuk követése. A munkafolyamatok az Ön jóváhagyására várnak, és soha nem tesznek közzé semmit.
  • Érdeklődők összegzése: a beérkezett árajánlatkérések és az egyes ügyfelek által konfigurált elemek megtekintése.
  • Termékkérdések megválaszolása a dokumentáció alapján: a hivatalos Simplio3D dokumentációban keres, és megjelöli az oldalt, ahelyett hogy emlékezetből válaszolna.

Minden eszköz, a szükséges jogosultsági körével és azzal együtt, hogy olvas vagy ír, szerepel az MCP-eszközök referenciaanyagában.

Amire nem képes

Egyes műveletek a megadott jogosultsági köröktől függetlenül elérhetetlenek maradnak. Egy csatlakoztatott ügynök nem tehet közzé projektet, nem hozhat létre megosztási hivatkozást, és nem módosíthatja a beágyazási beállításokat. Nem tölthet fel fájlokat, és nem törölhet projektet. Nem csatlakoztathat vagy választhat le Shopify vagy WooCommerce áruházat, és nem olvashatja az áruház hitelesítő adatait. Soha nem kap hozzáférést az adatbázishoz, a(z) API kulcsokhoz, webhook-titkokhoz vagy megosztott nézetek jelszavaihoz sem: az eszközök válogatott összefoglalókat adnak vissza, nem nyers rekordokat.

Hatókörök: minden kapcsolatnak csak azt adja meg, amire szüksége van

Egy kapcsolat csak azokat az eszközöket láthatja és hívhatja meg, amelyeket a hatókörei lefednek. Kezdjen csak olvasási hozzáféréssel, majd a feladat igényei szerint egyszerre csak egy írási hatókört adjon hozzá.

Simplio3D MCP-kapcsolat jogosultsági körei
Jogosultsági körMit tesz lehetővéAkkor adja meg, ha az ügynöknek
Munkaterület (olvasás)Munkaterülete, csomagja és használati összesítőjeMegmutatja, melyik csomagot használja, és mennyit vesz igénybe belőle
Projektek (olvasás / írás)Projektek listázása és ellenőrzése; létrehozás, átnevezés, duplikálás és biztonságos beállítások módosításaJelentés készítése a projektjeiről, vagy újak beállítása
Eszközök (olvasás)Eszközök listázása, valamint egy modell alkatrészneveinek és hierarchiájának ellenőrzéseBeszélgetés a modelleken belüli hálókról
Anyagok (olvasás / írás)Könyvtár olvasása; anyagok létrehozása és szerkesztése, valamint változatokhoz rendeléseÉpítse fel vagy rendszerezze anyagkönyvtárát
Konfigurátor (olvasás / írás)Opcióblokkok, változatok és feltételes szabályok olvasása és létrehozásaÉpítse fel vagy strukturálja át a vásárlók számára látható opciókat
Árazás (olvasás / írás)Árak és képletek olvasása; árazási, SKU- és képletmódosítások javaslataDolgozzon az árazáson. Minden árazási módosítás egy jóváhagyásra váró javaslat.
Űrlapok (olvasás / írás)Olvassa és hozza létre az árajánlat- és pénztárűrlap-mezőketHozza létre vagy módosítsa az érdeklődői űrlapját
Árajánlatok (olvasás)Beküldött árajánlatkérések, beleértve az ügyféladatokat isFoglalja össze a beérkező érdeklődéseket. Ez ügyféladat, ezért megfontoltan adjon hozzáférést.
Kereskedelem (olvasás / írás)A bolt kapcsolódási állapota, termékei, valamint javaslatok egy termék összekapcsolására vagy a fizetési mód beállításáraProjekt összekapcsolása egy bolti termékkel. Soha nem biztosít hozzáférést a bolt hitelesítő adataihoz.
Munkafolyamatok (olvasás / írás)Kövesse az ügynök munkafolyamatait; indítsa el őket, válaszoljon kérdéseikre, szüneteltesse vagy törölje őketHosszabb feladat, például projektaudit futtatása vagy nyomon követése
Dokumentáció (olvasás)A hivatalos Simplio3D dokumentáció, munkaterület-adatok nélkülVálaszoljon termékkel kapcsolatos kérdésekre forrással

Több kisebb kapcsolat biztonságosabb, mint egyetlen olyan, amely mindenre képes. Adjon külön kapcsolatot az árképzést felülvizsgáló asszisztensnek olvasási hatókörökkel és árképzési írási jogosultsággal, a projekteket építő asszisztensnek pedig egy másikat. Így az egyik visszavonása soha nem szakítja meg a másik működését.

Hogyan maradnak a módosítások az Ön irányítása alatt

AI-t csak akkor lehet élő konfigurátor szerkesztésére használni, ha egy hibás módosítás nem juthat el az ügyfelekhez. A Simplio3D minden írást három lépésben kezel: javaslat, jóváhagyás, pillanatkép.

  • Az alacsony kockázatú módosítások az Ön várakoztatása nélkül végbemennek, például egy blokk átnevezése vagy egy változat hozzáadása.
  • A magas kockázatú módosítások kizárólag javaslatot hoznak létre: árképzés, SKU-k, törlések, tömeges szerkesztések, megosztott anyagok és áruházi termékkapcsolatok. A javaslat az AI-kapcsolatok oldalon, a Függőben lévő AI-módosítások alatt várakozik, és felsorol minden elvégzendő módosítást. Ön az Alkalmaz gombbal hagyhatja jóvá, vagy elutasíthatja. Egyetlen ügynök sem hagyhatja jóvá a saját javaslatát, és ez a szabály nem kapcsolható ki.
  • Minden alkalmazott módosításról pillanatkép készül, így visszavonható, majd újra ellenőrizhető és rögzíthető az auditnaplóban.

A javaslatok rövid ideig érvényesek. Ha a projekt megváltozott azóta, hogy az ügynök javaslatot tett, a régi javaslatot a rendszer elutasítja ahelyett, hogy felülírná az újabb szerkesztéseit; kérje meg újra az ügynököt.

Ezen felül egy eszközhívás csak akkor sikeres, ha mind a négy ellenőrzés teljesül: a fiók e-mail-címe ellenőrzött, a munkaterület tulajdonosának előfizetése aktív, a munkamenet szerepköre engedélyezi a műveletet, és a kapcsolat rendelkezik a hatókörrel. Mindig a legszűkebb korlátozás érvényesül. Egy Viewer szerepkörrel rendelkező felhasználó például soha nem végezhet vagy hagyhat jóvá módosítást, függetlenül a kapcsolat hatóköreitől.

Az MCP-csatlakozók beállítása a(z) Simplio3D számára

A tokenes útvonal minden kliensben működik. Claude-ot használ? Az alábbi OAuth-útvonal kihagyja a tokent.

  1. AI-kapcsolatok megnyitása

    A(z) Simplio3D felületén lépjen a Vezérlőpult → Integrációk → AI-kapcsolatok menüpontra, majd másolja ki az oldal tetején megjelenő MCP-végpontot.

  2. Hozzon létre eszközönként egy kapcsolatot

    Kattintson a Kapcsolat létrehozása lehetőségre, és nevezze el azt az eszközről, amely használni fogja, például „Claude Desktop” vagy „Cursor”. Az eszközönkénti külön kapcsolat révén később egyértelmű lesz, melyiket kell visszavonni.

  3. Válassza ki a munkaterületet

    A kapcsolat véglegesen az itt kiválasztott munkaterülethez lesz kötve. Ha két munkaterületen is szeretne dolgozni, mindkettőből hozzon létre egy kapcsolatot.

  4. Csak a szükséges jogosultsági köröket jelölje be

    Kezdje csak olvasási jogosultságokkal, majd egyenként adja hozzá az írási jogosultságokat. Az Árajánlatokhoz csak akkor adjon hozzáférést, ha az ügynöknek látnia kell az ügyféladatokat.

  5. Másolja ki a tokent, és adja hozzá az eszközéhez

    A token smcp_ előtaggal kezdődik, és csak egyszer jelenik meg, később soha többé. Illessze be az AI-eszközébe a végponttal együtt, az alábbi táblázatban látható módon. Kezelje jelszóként: 90 napig érvényes, és bármikor lecserélheti vagy visszavonhatja.

  6. Ellenőrizze a kapcsolatot

    Tegyen fel olyan kérdést, amelyre csak az Ön fiókja tud válaszolni: „Sorolja fel a(z) Simplio3D projektemet, és mondja meg, melyek vannak közzétéve.” Ha a válaszban a valós projektjei szerepelnek, a csatlakozó működik.

Claude csatlakoztatása token nélkül. A(z) Simplio3D szerepel Claude összekötőkönyvtárában. A Claude-ban nyissa meg a Testreszabás → Összekötők menüt, keressen rá a(z) Simplio3D elemre, és kattintson a Csatlakozás gombra, vagy válassza az Egyéni összekötő hozzáadása lehetőséget, majd illessze be: https://app.simplio3d.ai/mcp. Mindkét esetben Claude megnyitja a(z) Simplio3D bejelentkezési oldalát és egy jóváhagyási képernyőt, ahol kiválaszthatja a munkaterületet és a jogosultsági köröket; a csak olvasási hozzáférés már be lesz jelölve. A kapcsolat ezután ugyanabban az AI-kapcsolatok listájában jelenik meg, OAuth app jelöléssel, és ugyanott cserélheti le vagy vonhatja vissza, mint bármely más kapcsolatot.

Hol adható meg az egyes AI-kliensekben a(z) Simplio3D csatlakozó
MI-kliensHová kell hozzáadniMit kell hozzáadni
Claude (OAuth)Testreszabás → Csatlakozók: keresse meg a Simplio3D elemet, vagy válassza az Egyéni csatlakozó hozzáadása lehetőségetNincs szükség semmire a könyvtárból; egyéni csatlakozóhoz a végpont URL-je kell. Nincs token: ehelyett jóváhagyja a Simplio3D hozzájárulási képernyőjét.
Claude DesktopBeállítások → Fejlesztő → Konfiguráció szerkesztése (claude_desktop_config.json)Egy „simplio3d” nevű, http típusú szerver végpont-URL-lel és Authorization: Bearer smcp_… fejléccel
Claude CodeAz Ön termináljaclaude mcp add --transport http simplio3d https://app.simplio3d.ai/mcp --header "Authorization: Bearer smcp_…"
Cursor~/.cursor/mcp.json, illetve egyetlen projekt esetén .cursor/mcp.jsonEgy „simplio3d” szerver a végpont URL-jével és az Authorization fejléccel
VS Code (GitHub Copilot).vscode/mcp.jsonEgy HTTP-kiszolgáló végponti URL-lel, amely a tokent jelszókérésből olvassa ki, ahelyett hogy a fájlban tárolná
ChatGPT és CodexChatGPT → Bővítmények: keressen rá erre: Simplio3D, majd telepítse a bővítményt, és csatlakoztassa ezt: Simplio3DSemmi: a bővítmény tartalmazza a csatlakozót. Nincs token: jelentkezzen be a(z) Simplio3D felületén, és hagyja jóvá a hozzáférést

Elsőként kipróbálható promptok

Nevezze meg a projektet, és kérjen bizonyítékot: a „melyik szabály rejti el?” pontosabb választ ad, mint a „miért van elrejtve?”.

Példakérések egy Simplio3D MCP-csatlakozóhoz
KérdezésAmit az ügynök ellenőrizAmit visszakap
„Ellenőrizd az Oak Dining Table konfigurátoromat, és sorolj fel mindent, ami hibás.”Megkeresi a projektet, majd ellenőrzi azt, beleértve a 3D-modellben található alkatrészneveket isMegállapítások súlyosság szerint: hiányzó alkatrészcélok, törölt anyagok, soha nem aktiválódó szabályok, árazatlan változatok
„Miért rejtett a Dió felület, amikor a kis felső részt választom?”Az opcióblokkok és a feltételes szabályok, majd ezek kiértékeléseAz azt elrejtő szabály és az illeszkedő feltétel
„Ebben a konfigurátorban minden változatnak van ára?”Az árképzési blokkok, majd egy érvényesítési ellenőrzésAz árazatlan változatok név szerint, azzal az árképzési blokkal együtt, amelyhez tartoznak
„Mely opciók céloznak olyan alkatrészeket, amelyek már nem léteznek a modellben?”Azok a célok, amelyeket a valós geometriához készítettA felsorolt elavult célok
„Mennyibe kerülne a nagy méretű tölgy?”Az opcióblokkok, majd szerveroldali árkalkulációAlapár, minden módosítás, adó és a végösszeg a projekt pénznemében
„Foglald össze az ezen a héten beérkezett árajánlatkéréseket.”Az árajánlatkérések és minden egyes konfigurációKapcsolattartási adatok, az egyes ügyfelek konfigurációi és az akkori ár

Fontos korlátok, amelyeket érdemes ismerni, mielőtt erre támaszkodna

  • Az ügynökök a mentett adatokat olvassák. A szerkesztő minden módosítás után néhány másodperccel automatikusan ment, ezért előfordulhat, hogy a pillanatokkal korábban végzett szerkesztés még nem látható. Mentse el, majd kérdezzen rá újra.
  • A szerveroldali árak és logika korlátozásokkal járnak. Az árkalkuláció és a szabálykiértékelés a gyakori eseteket fedi le, de nem a közzétett konfigurátor minden működését, például az egységenkénti Number Input árazást. Minden eredmény felsorolja, mit nem értékelt ki, és a Preview, valamint a közzétett megosztási nézet marad a végső mérvadó forrás.
  • Rátakorlátok. Minden kapcsolat ötpercenként 300 kérést indíthat. Egy munkaterület tízpercenként 30 alkalmazott AI-módosítást fogad el, amelyen minden csatlakoztatott ügynök és a beépített asszisztens osztozik.
  • A nagy válaszokat csonkoljuk, és ezt jelezzük is. A körülbelül 60 KB-nál nagyobb eredményeket összefoglaljuk és csonkoltként jelöljük, így az ügynök nem tévesztheti össze egy lista egy részét annak teljes tartalmával.
  • Amit az ügynök olvas, az az Ön AI-szolgáltatójához kerül. Az árajánlatkérések ügyfélneveket és kapcsolattartási adatokat tartalmaznak, ezért a Quotes hatókört megfontoltan adja meg.
  • A tokenek 90 nap után lejárnak. Azonnal cseréljen le egyet, ha beillesztette egy csevegésbe, támogatási jegybe vagy képernyőmegosztásba. A csere azonnal letiltja a régi tokent.

Egyetlen eszközréteg minden AI-felület mögött

Az MCP-szerver nem egy külön, utólag hozzáillesztett termék. A(z) Simplio3D beépített AI-asszisztense, a saját automatizálásaihoz használható hitelesített REST eszközvégpont, valamint a külső MCP-kliensek mind ugyanazt az eszközjegyzéket hívják, ugyanazon hitelesítés, jogosultságok és naplózási rendszer mögött. Egy képesség mindenhol ugyanúgy működik, ahonnan csak meghívja, és egy hatókör vagy szerepkör, amely egy helyen blokkolja, mindenhol blokkolja.

Ez különbözteti meg az MCP-t a(z) REST API és SDK megoldástól is. A(z) SDK egy típusos kliens a saját kódjához, amelyet API kulccsal hitelesít, és ezt a kulcsot az MCP-végpont soha nem fogadja el. Az MCP AI-ügynököknek készült, amelyek eszközönként beállított hatókörű kapcsolattal hitelesítik magukat.

Kérdések az MCP-csatlakozókról

Mindegyik: Starter, Pro és Enterprise, valamint a minden fiókhoz járó 30 napos Pro próbaidőszak. Az MCP-csatlakozók 2026 szeptembere óta a Starter csomag részei. A Starter csomagban a csatlakoztatott ügynök ugyanazokat a csomagszabályokat követi, mint az irányítópult, így nem hozhat létre Modular projekteket és nem duplikálhat projekteket.

Először a konfigurátort építi?

Így jut el egy projekt a 3D modelltől a választási lehetőségekig, a feltételes logikáig és az árazásig, még mielőtt egy ügynök egyáltalán elolvasná.

Szeretné, hogy az ügynök ellenőrizze az árait?

Az árblokkok és a képletszerkesztő, amelyet egy csatlakoztatott ügynök olvas és amely alapján számításokat végez.

Szeretné, hogy az AI a konfigurátort is elkészítse?

Az AI a termékleírás alapján, közvetlenül a(z) Simplio3D felületén elkészíti az opciók, szabályok, árak és űrlap beállításait.

ChatGPT-t használ?

A ChatGPT Bővítmények könyvtárában található Simplio3D bővítmény token helyett irányított bejelentkezéssel hozza létre Ön helyett ezt a kapcsolatot.

A blogból

Útmutatók, oktatóanyagok és hírek a Simplio3D csapatától.

Építsen, telepítsen és skálázzon 3D kereskedelmi megoldásokat.

Használjon saját 3D termékkonfigurátort az értékesítés ösztönzésére és árajánlatok közvetlen, webhelyéről történő készítésére

Kapcsolódó cikkek