Přejít na obsah
Zpět na blog
mcpaiintegrationstutorial

MCP konfigurátoru produktů: Připojte Claude, Cursor a VS Code k Simplio3D

Simplio3D·
MCP konfigurátoru produktů: Připojte Claude, Cursor a VS Code k Simplio3D

Zeptejte se dnes AI asistenta na svůj produktový konfigurátor a odpoví podle všeho, co vložíte do chatu: snímku obrazovky, seznamu možností nebo ručně zadané ceny. Konektory MCP tento krok odstraňují. Konektor poskytne asistentovi přímý přístup s oprávněními k vašemu účtu Simplio3D, takže načte skutečný projekt (bloky možností, podmíněná pravidla, cenový vzorec i názvy dílů uvnitř 3D modelu) a odpovídá na jeho základě.

Tento průvodce vysvětluje, co je konektor MCP, co připojený agent v Simplio3D může a nemůže dělat, jak zůstávají rizikové změny pod vaší kontrolou a jak připojit Claude, Cursor nebo VS Code.

Co jsou konektory MCP?

Model Context Protocol (MCP) je otevřený standard pro připojování AI asistentů k externím nástrojům a datům. Má dvě strany. Klient MCP je AI nástroj, který již používáte, například Claude, Cursor nebo VS Code. Server MCP je systém, ke kterému se asistent připojuje: zveřejňuje seznam nástrojů, každý s popisem a schématem, které může asistent volat, když je pro odpověď potřebuje.

Konektor je spojení mezi nimi: adresa serveru a přihlašovací údaj určující, kdo se připojuje a k čemu má přístup. Claude jej nazývá vlastní konektor; ostatní klienti jej označují jako záznam serveru MCP. Pro Simplio3D jde vždy o stejné dvě věci:

  • Koncový bod: https://app.simplio3d.ai/mcp
  • Přihlašovací údaj: přihlášení OAuth, které schválíte na obrazovce souhlasu Simplio3D, nebo připojovací token, který vytvoříte v části Dashboard → Integrace → Připojení AI.

Po připojení asistent uvidí nástroje Simplio3D vedle svých vlastních a podle vašeho požadavku rozhodne, kdy je použít.

Schéma: Claude, Cursor a VS Code se připojují k MCP serveru Simplio3D na adrese app.simplio3d.ai/mcp. Každé volání prochází čtyřmi kontrolami (ověřený účet, aktivní tarif nebo zkušební verze, role v pracovním prostoru, oprávnění připojení), než získá přístup ke 123 nástrojům (52 pro čtení, 68 pro zápis, 3 pro workflow) a projektům jednoho pracovního prostoru. Vysoce rizikové změny se změní na návrh, který čeká v části Čekající změny AI, dokud nestisknete Použít; poté se vytvoří snímek.
Každý klient AI prochází stejným koncovým bodem a stejnými čtyřmi kontrolami. Vysoce riziková změna se zastaví jako návrh, dokud ji nepoužijete v ovládacím panelu.

Co může připojený agent dělat v Simplio3D

Server MCP Simplio3D nabízí 123 nástrojů: 52 pro čtení, 68 pro zápis v rámci modelu řízeného zápisu a 3 pro spouštění pracovních postupů agenta. Společně pokrývají projekty, kontrolu 3D modelů, materiály, bloky možností, podmíněnou logiku, ceny, formuláře, žádosti o cenovou nabídku a propojení s obchody. V praxi připojený agent dokáže:

  • Číst skutečný projekt: jeho modely, bloky možností a varianty, materiály, podmíněná pravidla, cenové bloky a vzorce i pole formulářů.
  • Nahlédnout do 3D modelu: názvy a hierarchii dílů, aby mohl ověřit, že každá možnost stále cílí na existující síť.
  • Provést audit konfigurátoru: chybějící cíle dílů, smazané materiály, pravidla, která se nikdy nemohou spustit, a varianty bez ceny.
  • Vysvětlit logiku a nacenit konfiguraci: které pravidlo skrývá možnost a kolik stojí daná sada výběrů, vypočteno na serveru.
  • Vytvářet a upravovat: vytvářet projekty, bloky možností, varianty, materiály, podmíněná pravidla a pole formulářů a upravovat to, co již existuje.
  • Spouštět pracovní postupy agenta: zahájit vícekrokovou úlohu, například audit projektu nebo bezpečnou opravu, odpovídat na její otázky a sledovat její průběh. Pracovní postupy se pozastaví, dokud je neschválíte, a nikdy nic nepublikují.
  • Shrnovat potenciální zákazníky: číst přijaté žádosti o cenovou nabídku a zjistit, co si každý zákazník nakonfiguroval.
  • Odpovídat na otázky o produktu na základě dokumentace: vyhledávat v oficiální dokumentaci Simplio3D a citovat stránku namísto odpovědi zpaměti.

Každý nástroj včetně potřebného rozsahu a informace, zda slouží ke čtení nebo zápisu, je uveden v referenci nástrojů MCP.

Co nedokáže

Některé akce zůstávají nedostupné bez ohledu na udělené rozsahy. Připojený agent nemůže publikovat projekt, vytvořit odkaz pro sdílení ani změnit nastavení vložení. Nemůže nahrávat soubory ani odstranit projekt. Nemůže připojit ani odpojit obchod Shopify nebo WooCommerce ani číst přihlašovací údaje tohoto obchodu. A nikdy nezíská přístup k databázi, klíčům API, tajným údajům webhooků ani heslům pro sdílené zobrazení: nástroje vracejí vybraná shrnutí, nikoli nezpracované záznamy.

Rozsahy oprávnění: každému připojení dejte jen to, co potřebuje

Připojení může zobrazit a volat pouze nástroje, které pokrývají jeho rozsahy oprávnění. Začněte s přístupem pouze pro čtení a podle potřeby přidávejte vždy jeden rozsah zápisu.

Oprávnění připojení Simplio3D MCP
OprávněníCo umožňujeUdělujte je, když má agent
Pracovní prostor (čtení)Souhrn vašeho pracovního prostoru, tarifu a využitíZjistíte, jaký tarif používáte a do jaké míry ho využíváte
Projekty (čtení / zápis)Vypisujte a kontrolujte projekty; vytvářejte je, přejmenovávejte, duplikujte a měňte bezpečná nastaveníVytvářejte přehledy o svých projektech nebo zakládejte nové
Zdroje (čtení)Vypisujte zdroje a kontrolujte názvy částí a hierarchii modeluKomunikujte o sítích uvnitř svých modelů
Materiály (čtení / zápis)Procházejte knihovnu; vytvářejte a upravujte materiály a přiřazujte je variantámVytvořte nebo uspořádejte svou knihovnu materiálů
Konfigurátor (čtení / zápis)Procházejte a vytvářejte bloky možností, varianty a podmíněná pravidlaVytvořte nebo restrukturalizujte možnosti, které zákazníci uvidí
Ceny (čtení / zápis)Procházejte ceny a vzorce; navrhujte změny cen, SKU a vzorcůPracujte s cenotvorbou. Každá úprava cenotvorby je návrh, který schvalujete.
Formuláře (čtení / zápis)Zobrazujte a vytvářejte pole formulářů pro nabídky a dokončení objednávkyVytvořte nebo upravte formulář pro získávání kontaktů
Nabídky (čtení)Odeslané žádosti o cenovou nabídku včetně údajů o zákaznícíchShrnujte příchozí kontakty. Jde o údaje zákazníků, proto přístup udělujte uvážlivě.
E-commerce (čtení / zápis)Zda je obchod připojen, jeho produkty a návrhy na propojení produktu nebo nastavení režimu pokladnyPropojte projekt s produktem v obchodě. Nikdy neuděluje přístupové údaje k obchodu.
Pracovní postupy (čtení / zápis)Sledujte pracovní postupy agenta; spouštějte je, odpovídejte na jejich otázky, pozastavujte je nebo rušteSpusťte nebo sledujte delší úlohu, například audit projektu
Dokumentace (čtení)Oficiální dokumentace Simplio3D bez dat pracovního prostoruOdpovídejte na otázky týkající se produktu s uvedením zdroje

Několik menších připojení je bezpečnějších než jedno, které dokáže vše. Asistentovi, který kontroluje ceny, dejte vlastní připojení s oprávněními pro čtení a zápis cen; asistentovi pro vytváření projektů pak jiné. Zrušení jednoho připojení tak nikdy nepřeruší druhé.

Jak změny zůstávají pod vaší kontrolou

Umožnit AI upravovat aktivní konfigurátor funguje pouze tehdy, když se chybná úprava nemůže dostat k vašim zákazníkům. Simplio3D zpracovává každý zápis ve třech krocích: navrhnout, potvrdit, vytvořit snímek.

  • Nízce rizikové úpravy proběhnou bez čekání na vás, například přejmenování bloku nebo přidání varianty.
  • Vysoce rizikové změny vždy vytvoří pouze návrh: ceny, SKU, mazání, hromadné úpravy, sdílené materiály a odkazy na produkty v obchodu. Návrh čeká v části Čekající změny AI na stránce Připojení AI a uvádí všechny změny, které by provedl. Kliknete na Použít, nebo jej zamítnete. Žádný agent nemůže schválit vlastní návrh a toto pravidlo nelze vypnout.
  • U každé použité změny se vytvoří snímek, takže ji lze vrátit zpět, znovu ověřit a zaznamenat do protokolu auditu.

Návrhy mají omezenou platnost. Pokud se projekt od chvíle, kdy agent něco navrhl, změnil, starý návrh se odmítne namísto přepsání vašich novějších úprav; požádejte agenta znovu.

Navíc se volání nástroje úspěšně provede jen tehdy, pokud projdou všechny čtyři kontroly: e-mailová adresa účtu je ověřená, tarif vlastníka pracovního prostoru je aktivní, role uživatele umožňuje danou akci a připojení má potřebný rozsah oprávnění. Rozhoduje nejužší omezení. Uživatel s rolí Viewer například nikdy nemůže provést ani potvrdit změnu, bez ohledu na rozsahy oprávnění svého připojení.

Jak nastavit konektory MCP pro Simplio3D

Trasa s tokenem funguje v každém klientovi. Používáte Claude? Níže uvedená trasa OAuth token nevyžaduje.

  1. Otevřít připojení AI

    V Simplio3D přejděte do nabídky Dashboard → Integrations → AI Connections a zkopírujte koncový bod MCP zobrazený v horní části stránky.

  2. Vytvořte jedno připojení pro každý nástroj

    Klikněte na Create connection a pojmenujte ho podle nástroje, který jej bude používat, například „Claude Desktop“ nebo „Cursor“. Jedno připojení pro každý nástroj usnadňuje pozdější určení, které z nich zrušit.

  3. Vyberte pracovní prostor

    Připojení je trvale svázáno s pracovním prostorem, který zde vyberete. Chcete-li pracovat ve dvou pracovních prostorech, vytvořte připojení v každém z nich.

  4. Zaškrtněte pouze oprávnění, která potřebuje

    Začněte s oprávněním pouze ke čtení a oprávnění k zápisu přidávejte postupně, jedno po druhém. Přístup k Nabídkám udělte pouze tehdy, když má agent vidět údaje o zákaznících.

  5. Zkopírujte token a přidejte jej do svého nástroje

    Token začíná na smcp_ a zobrazí se pouze jednou, nikdy více. Vložte jej do svého nástroje AI spolu s koncovým bodem, jak je uvedeno v tabulce níže. Zacházejte s ním jako s heslem: platí 90 dní a kdykoli jej můžete obnovit nebo zrušit.

  6. Ověřte připojení

    Položte otázku, na kterou může odpovědět pouze váš účet: „Vypiš moje projekty Simplio3D a řekni mi, které z nich jsou publikované.“ Pokud odpověď uvede vaše skutečné projekty, konektor funguje.

Připojení Claude bez tokenu. Simplio3D je uveden v adresáři konektorů Claude. V Claude otevřete Přizpůsobit → Konektory, vyhledejte Simplio3D a klikněte na Připojit, případně zvolte Přidat vlastní konektor a vložte https://app.simplio3d.ai/mcp. V obou případech Claude otevře přihlášení do Simplio3D a obrazovku souhlasu, kde zvolíte pracovní prostor a rozsahy oprávnění; přístup pouze pro čtení je již předem zaškrtnutý. Připojení se poté zobrazí ve stejném seznamu Připojení AI s označením aplikace OAuth a můžete jej tam stejně jako ostatní obnovit nebo odvolat.

Kam jednotliví klienti AI přidávají konektor Simplio3D
AI klientKam jej přidatCo přidat
Claude (OAuth)Přizpůsobit → Konektory: vyhledejte Simplio3D nebo vyberte Přidat vlastní konektorNic z adresáře; URL koncového bodu pro vlastní konektor. Bez tokenu: místo toho schválíte obrazovku souhlasu Simplio3D.
Claude DesktopNastavení → Vývojář → Upravit konfiguraci (claude_desktop_config.json)Server „simplio3d“ typu http s URL koncového bodu a hlavičkou Authorization: Bearer smcp_…
Claude CodeVáš terminálclaude mcp add --transport http simplio3d https://app.simplio3d.ai/mcp --header "Authorization: Bearer smcp_…"
Cursor~/.cursor/mcp.json nebo .cursor/mcp.json pro jeden projektServer „simplio3d“ s URL koncového bodu a hlavičkou Authorization
VS Code (GitHub Copilot).vscode/mcp.jsonHTTP server s URL koncového bodu, který načítá token z výzvy k zadání hesla namísto jeho ukládání do souboru
ChatGPT a CodexChatGPT → Pluginy: vyhledejte Simplio3D, poté nainstalujte plugin a připojte Simplio3DNic: plugin obsahuje konektor. Žádný token: přihlásíte se na Simplio3D a schválíte přístup

Výzvy, které můžete vyzkoušet jako první

Uveďte název projektu a požadujte důkaz: „které pravidlo to skrývá?“ přinese přesnější odpověď než „proč je to skryté?“

Příklady výzev pro konektor MCP Simplio3D
PožadavekCo agent kontrolujeCo získáte zpět
„Zkontrolujte můj konfigurátor Oak Dining Table a uveďte vše, co nefunguje.“Najde projekt a poté jej ověří, včetně názvů částí ve 3D modeluNálezy podle závažnosti: chybějící cíle dílů, odstraněné materiály, pravidla, která se nikdy nemohou spustit, varianty bez ceny
„Proč je povrchová úprava Walnut skrytá, když vyberu malou horní desku?“Bloky možností a podmíněná pravidla, poté je vyhodnotíPravidlo, které ji skrývá, a podmínka, která se shodovala
„Má každá varianta v tomto konfigurátoru cenu?“Cenové bloky, poté validační kontrolaVarianty bez ceny podle názvu spolu s cenovým blokem, do kterého každá patří
„Které možnosti cílí na díly, které už v modelu neexistují?“Cíle, které jste vytvořili podle skutečné geometrieUvedené neaktuální cíle
„Kolik by stál dub ve velkém rozměru?“Bloky voleb a následný výpočet ceny na straně serveruZákladní cena, každá úprava, daň a celková částka v měně projektu
„Shrňte poptávky, které jsme obdrželi tento týden.“Poptávky a každá konfiguraceKontaktní údaje, konfigurace každého zákazníka a cena v daném okamžiku

Omezení, která je dobré znát, než se na něj spolehnete

  • Agenti čtou uložená data. Editor se několik sekund po každé změně automaticky ukládá, takže úprava provedená před chvílí ještě nemusí být viditelná. Uložte ji a poté se zeptejte znovu.
  • Ceny a logika na straně serveru mají svá omezení. Výpočet ceny a vyhodnocování pravidel pokrývají běžné případy, nikoli každé chování publikovaného konfigurátoru, například oceňování Number Input za jednotku. Každý výsledek uvádí, co nebylo vyhodnoceno, a náhled i publikované sdílené zobrazení zůstávají konečným rozhodnutím.
  • Limity požadavků. Každé připojení může provést 300 požadavků každých pět minut. Pracovní prostor přijme 30 aplikovaných změn AI každých deset minut, sdílených mezi všemi připojenými agenty a integrovaným asistentem.
  • Rozsáhlé odpovědi se zkracují a je to uvedeno. Výsledek přesahující přibližně 60 KB je shrnut a označen jako zkrácený, takže agent nemůže zaměnit část seznamu za celý seznam.
  • To, co agent čte, se odesílá vašemu poskytovateli AI. Žádosti o cenovou nabídku obsahují jména zákazníků a kontaktní údaje, proto oprávnění Quotes udělujte uvážlivě.
  • Tokeny vyprší po 90 dnech. Pokud byl token vložen do chatu, tiketu podpory nebo sdílení obrazovky, ihned jej obnovte. Obnovením se starý token okamžitě deaktivuje.

Jedna vrstva nástrojů pro každé rozhraní AI

Server MCP není samostatný dodatečně připojený produkt. Integrovaný AI asistent Simplio3D, ověřený koncový bod nástroje REST pro vaše vlastní automatizace i externí klienti MCP volají stejný registr nástrojů, se stejným ověřováním, oprávněními a protokolem auditu. Funkce se chová stejně bez ohledu na to, odkud ji voláte, a rozsah oprávnění nebo role, která ji zablokuje na jednom místě, ji zablokuje všude.

V tom se MCP liší také od REST API a SDK. SDK je typovaný klient pro váš vlastní kód, ověřovaný pomocí klíče API, a tento klíč není nikdy přijímán koncovým bodem MCP. MCP je určen pro AI agenty, ověřované pomocí připojení, jehož rozsah nastavíte pro každý nástroj.

Otázky k připojení MCP

Všechny: Starter, Pro a Enterprise i 30denní zkušební verze Pro, kterou každý účet začíná. Konektory MCP jsou součástí tarifu Starter od září 2026. V tarifu Starter se připojený agent řídí stejnými pravidly tarifu jako dashboard, takže nemůže vytvářet modulární projekty ani duplikovat projekt.

Nejprve vytvořit konfigurátor?

Jak projekt přechází od 3D modelu k volbám, podmíněné logice a cenotvorbě ještě předtím, než si jej přečte agent.

Chcete, aby agent kontroloval vaše ceny?

Cenové bloky a editor vzorců, které připojený agent čte a podle nich provádí výpočty.

Chcete, aby AI také vytvořila návrh konfigurátoru?

Vytvářejte pomocí AI možnosti, pravidla, ceny a formulář z popisu produktu přímo v Simplio3D.

Používáte ChatGPT?

Plugin Simplio3D v adresáři pluginů ChatGPT toto připojení nastaví za vás díky průvodci přihlášením namísto tokenu.

Z blogu

Příručky, návody a novinky od týmu Simplio3D.

Vytvářejte, nasazujte a škálujte 3D obchod.

Vlastněte 3D konfigurátor produktů, který zvyšuje prodej a generuje nabídky přímo z vašeho webu

Související články

Plugin Simplio3D pro ChatGPT: návod krok za krokem

Plugin Simplio3D pro ChatGPT: návod krok za krokem

Simplio3D nyní nabízí oficiální plugin v adresáři pluginů ChatGPT. Nainstalujte jej, připojte svůj pracovní prostor a požádejte ChatGPT o audit, ocenění, vytvoření a správu vašich 3D konfigurátorů.