Преминете към съдържанието
Назад към блога
mcpaiintegrationstutorial

MCP за продуктов конфигуратор: Свържете Claude, Cursor и VS Code с Simplio3D

Simplio3D·
MCP за продуктов конфигуратор: Свържете Claude, Cursor и VS Code с Simplio3D

Попитайте AI асистент за вашия продуктов конфигуратор днес и той ще отговори според каквото поставите в чата: екранна снимка, списък с опции, цена, която сте изписали. MCP конекторите премахват тази стъпка. Конекторът предоставя на асистента директен достъп с разрешения до вашия акаунт в Simplio3D, така че той чете реалния проект (блоковете с опции, условните правила, формулата за ценообразуване, имената на частите в 3D модела) и отговаря въз основа на това.

Това ръководство обяснява какво представлява MCP конекторът, какво свързаният агент може и не може да прави в Simplio3D, как рисковите промени остават под ваш контрол и как да свържете Claude, Cursor или VS Code.

Какво представляват MCP конекторите?

Model Context Protocol (MCP) е отворен стандарт за свързване на AI асистенти с външни инструменти и данни. Той има две страни. MCP клиент е AI инструментът, който вече използвате, например Claude, Cursor или VS Code. MCP сървър е системата, към която асистентът се свързва: тя публикува списък с инструменти, всеки с описание и схема, които асистентът може да извиква, когато въпросът го изисква.

Конекторът е връзката между двете: адресът на сървъра плюс идентификационни данни, които указват кой се свързва и до какво има достъп. Claude го нарича персонализиран конектор; други клиенти го наричат запис за MCP сървър. За Simplio3D това винаги са следните две неща:

  • Крайната точка: https://app.simplio3d.ai/mcp
  • Идентификационни данни: OAuth влизане, което одобрявате на екран за съгласие на Simplio3D, или токен за връзка, който създавате в Табло за управление → Интеграции → AI връзки.

След свързването асистентът вижда инструментите на Simplio3D наред със собствените си и решава кога да ги използва според вашата заявка.

Диаграма: Claude, Cursor и VS Code се свързват към MCP сървъра на Simplio3D на app.simplio3d.ai/mcp. Всяко извикване преминава през четири проверки (потвърден акаунт, активен план или пробен период, роля в работното пространство, обхвати на връзката), преди да достигне до 123 инструмента (52 за четене, 68 за запис, 3 за работни процеси) и проектите на едно работно пространство. Промените с висок риск се превръщат в предложение, което изчаква в „Чакащи промени от AI“, докато не натиснете „Приложи“, след което се създава моментна снимка.
Всеки AI клиент преминава през една и съща крайна точка и същите четири проверки. Промяна с висок риск остава като предложение, докато не я приложите в таблото за управление.

Какво може да прави свързан агент в Simplio3D

MCP сървърът на Simplio3D предоставя 123 инструмента: 52 за четене, 68 за запис в модел на контролиран запис и 3 за изпълнение на агентски работни потоци. Те обхващат проекти, проверка на 3D модели, материали, блокове с опции, условна логика, ценообразуване, формуляри, заявки за оферта и връзки с магазини. На практика свързаният агент може да:

  • Чете реален проект: неговите модели, блокове с опции и варианти, материали, условни правила, блокове за ценообразуване и формула, както и полета на формуляри.
  • Проверява 3D модела в детайли: имената и йерархията на частите, за да провери дали всяка опция все още сочи към съществуваща мрежа.
  • Одитира конфигуратор: липсващи цели за части, изтрити материали, правила, които никога не могат да се задействат, и варианти без цена.
  • Обяснява логиката и определя цената на конфигурация: кое правило скрива дадена опция и колко струва определен набор от избори, изчислено на сървъра.
  • Създава и редактира: проекти, блокове с опции, варианти, материали, условни правила и полета на формуляри, както и да подрежда вече наличното.
  • Изпълнява агентски работни потоци: стартира многоетапна задача, като одит на проект или безопасна поправка, отговаря на въпросите ѝ и следи напредъка ѝ. Работните потоци спират за вашето одобрение и никога не публикуват.
  • Обобщава потенциални клиенти: чете получените заявки за оферта и вижда какво е конфигурирал всеки клиент.
  • Отговаря на въпроси за продукта въз основа на документацията: търси в официалната документация на Simplio3D и посочва страницата, вместо да отговаря по памет.

Всеки инструмент, с необходимия му обхват и обозначение дали чете или записва, е описан в справочника за MCP инструменти.

Какво не може да прави

Някои действия остават недостъпни независимо какви обхвати предоставяте. Свързаният агент не може да публикува проект, да създава връзка за споделяне или да променя настройките за вграждане. Не може да качва файлове или да изтрива проект. Не може да свързва или прекъсва връзка с магазин в Shopify или WooCommerce, нито да чете идентификационните данни на този магазин. Освен това никога не получава достъп до база данни, ключове за API, тайни за webhook или пароли за споделен изглед: инструментите връщат подбрани обобщения, а не необработени записи.

Обхвати: предоставяйте на всяка връзка само необходимото

Една връзка може да вижда и извиква само инструментите, които нейните обхвати покриват. Започнете с достъп само за четене и добавяйте по един обхват за запис, когато задачата го изисква.

Обхвати на връзката с Simplio3D MCP
ОбхватКакво позволяваПредоставете го, когато агентът трябва да
Работно пространство (четене)Обобщение на работното ви пространство, плана и използванетоПоказва кой план използвате и каква част от него сте използвали
Проекти (четене / запис)Изброяване и преглед на проекти; създаване, преименуване, дублиране и промяна на безопасни настройкиПолучавайте информация за проектите си или създавайте нови
Ресурси (четене)Изброяване на ресурси и преглед на имената и йерархията на частите в моделОбсъждайте мрежите в моделите си
Материали (четене / запис)Преглеждайте библиотеката; създавайте и редактирайте материали и ги присвоявайте към вариантиСъздайте или подредете библиотеката си с материали
Конфигуратор (четене / запис)Преглеждайте и създавайте блокове с опции, варианти и условни правилаСъздайте или преструктурирайте опциите, които клиентите виждат
Ценообразуване (четене / запис)Преглеждайте цени и формули; предлагайте промени в цените, SKU и формулитеРаботете по ценообразуването. Всяко записване на цени е предложение, което одобрявате.
Формуляри (четене / запис)Преглеждайте и създавайте полета за формуляри за оферти и плащанеСъздайте или коригирайте формуляра си за запитвания
Оферти (четене)Изпратени заявки за оферта, включително данни за клиентитеОбобщавайте входящите запитвания. Това са клиентски данни, затова предоставяйте достъп съзнателно.
Търговия (четене / запис)Дали даден магазин е свързан, неговите продукти и предложения за свързване на продукт или задаване на режим на плащанеСвържете проект с продукт от магазина. Това никога не предоставя идентификационните данни на магазина.
Работни потоци (четене / запис)Следвайте работните потоци на агента; стартирайте ги, отговаряйте на въпросите им, поставяйте ги на пауза или ги отменяйтеСтартирайте или наблюдавайте по-дълга задача, като например одит на проект
Документация (четене)Официалната документация на Simplio3D, без данни от работното пространствоОтговаряйте на въпроси за продукта с източник

Няколко малки връзки са по-безопасни от една, която може да прави всичко. Дайте на асистента, който преглежда ценообразуването, собствена връзка с обхвати за четене плюс запис за ценообразуване, а на този, който създава проекти — друга. Така отнемането на една връзка никога не прекъсва другата.

Как промените остават под ваш контрол

Позволяването на AI да редактира действащ конфигуратор работи само ако грешна редакция не може да достигне до вашите клиенти. Simplio3D обработва всеки запис в три стъпки: предложение, потвърждение, моментна снимка.

  • Нискорисковите редакции се извършват без изчакване на вашето одобрение, например преименуване на блок или добавяне на вариант.
  • Високорисковите промени винаги създават само предложение: ценообразуване, SKU, изтривания, групови редакции, споделени материали и връзки към продукти в магазина. Предложението изчаква в Чакащи AI промени на страницата AI връзки и изброява всяка промяна, която би направило. Натискате Приложи или го отхвърляте. Никой агент не може да одобри собственото си предложение и това правило не може да бъде изключено.
  • За всяка приложена промяна се създава моментна снимка, така че тя може да бъде отменена, след което да бъде валидирана отново и записана в журнал за одит.

Предложенията са с кратък срок на валидност. Ако проектът е променен, откакто агентът е предложил нещо, старото предложение се отказва, вместо да презапише по-новите ви редакции; попитайте агента отново.

Освен това извикването на инструмент е успешно само когато преминат и четирите проверки: имейл адресът на акаунта е потвърден, планът на собственика на работното пространство е активен, ролята на мястото позволява действието и връзката притежава необходимия обхват. Прилага се най-ограничаващото условие. Например място с роля Viewer никога не може да прави или потвърждава промяна, независимо какви обхвати има неговата връзка.

Как да настроите MCP конектори за Simplio3D

Маршрутът с токен работи във всеки клиент. Използвате Claude? OAuth маршрутът по-долу премахва нуждата от токен.

  1. Open AI Connections

    В Simplio3D отидете на Dashboard → Integrations → AI Connections и копирайте MCP крайна точка, показана в горната част на страницата.

  2. Създайте по една връзка за всеки инструмент

    Щракнете върху Create connection и я наименувайте според инструмента, който ще я използва, например „Claude Desktop“ или „Cursor“. По една връзка за всеки инструмент улеснява разпознаването коя да отмените по-късно.

  3. Изберете работното пространство

    Връзката е трайно обвързана с работното пространство, което изберете тук. За да работите в две работни пространства, създайте връзка от всяко от тях.

  4. Отбележете само необходимите обхвати

    Започнете с достъп само за четене и добавяйте обхвати за запис един по един. Предоставете достъп до Quotes само когато агентът трябва да вижда данни за клиентите.

  5. Копирайте токена и го добавете към инструмента си

    Токенът започва с smcp_ и се показва само веднъж, никога повече. Поставете го във вашия AI инструмент заедно с крайната точка, както е показано в таблицата по-долу. Отнасяйте се към него като към парола: валиден е 90 дни и можете да го подмените или отмените по всяко време.

  6. Проверете връзката

    Задайте въпрос, на който само вашият акаунт може да отговори: „Избройте моите проекти в Simplio3D и ми кажете кои от тях са публикувани.“ Ако отговорът посочва реалните ви проекти, конекторът работи.

Свързване на Claude без токен. Simplio3D е включен в каталога с конектори на Claude. В Claude отворете Персонализиране → Конектори, потърсете Simplio3D и кликнете върху Свързване, или изберете Добавяне на персонализиран конектор и поставете https://app.simplio3d.ai/mcp. И в двата случая Claude отваря страницата за вход на Simplio3D и екран за съгласие, където избирате работното пространство и обхватите, като достъпът само за четене е предварително отметнат. След това връзката се появява в същия списък с AI връзки, обозначена като OAuth app, и можете да я подновите или отмените оттам, както всяка друга.

Къде всеки AI клиент приема конектора Simplio3D
AI клиентКъде да го добавитеКакво да добавите
Claude (OAuth)Персонализиране → Конектори: потърсете Simplio3D или изберете „Добавяне на персонализиран конектор“Нищо от директорията; използвайте URL адреса на крайната точка за персонализиран конектор. Без токен: вместо това одобрявате екрана за съгласие на Simplio3D.
Claude DesktopНастройки → Разработчик → Редактиране на конфигурацията (claude_desktop_config.json)Сървър „simplio3d“ от тип http с URL адреса на крайната точка и заглавка Authorization: Bearer smcp_…
Claude CodeВашият терминалclaude mcp add --transport http simplio3d https://app.simplio3d.ai/mcp --header "Authorization: Bearer smcp_…"
Cursor~/.cursor/mcp.json или .cursor/mcp.json за един проектСървър „simplio3d“ с URL адреса на крайната точка и заглавката Authorization
VS Code (GitHub Copilot).vscode/mcp.jsonHTTP сървър с URL адрес на крайна точка, който чете токена от подкана за парола, вместо да го съхранява във файла
ChatGPT и CodexChatGPT → Plugins: потърсете Simplio3D, след това инсталирайте плъгина и свържете Simplio3DНищо: плъгинът включва конектора. Не е нужен токен: влизате в Simplio3D и одобрявате достъпа

Подкани, които да изпробвате първо

Посочете името на проекта и поискайте доказателство: „кое правило го скрива?“ дава по-точен отговор от „защо е скрито?“.

Примерни подкани за MCP конектор Simplio3D
ПопитайтеКакво проверява агентътКакво получавате в отговор
„Проверете моя конфигуратор Oak Dining Table и избройте всичко, което не работи.“Намира проекта, след което го валидира, включително имената на частите в 3D моделаКонстатации по сериозност: липсващи целеви части, изтрити материали, правила, които никога не могат да се задействат, варианти без цена
„Защо покритието Walnut е скрито, когато избера малкия плот?“Блоковете с опции и условните правила, след което ги оценяваПравилото, което го скрива, и условието, което е изпълнено
„Всеки вариант в този конфигуратор има ли цена?“Блоковете за ценообразуване, след което проверка за валидностВариантите без цена по име, заедно с блока за ценообразуване, към който принадлежи всеки
„Кои опции са насочени към части, които вече не съществуват в модела?“Целите, които сте създали спрямо реалната геометрияНеактуалните цели, изброени
„Колко би струвал дъбът в големия размер?“Блоковете с опции, следвани от изчисляване на цената от страна на сървъраБазовата цена, всяка корекция, данъкът и общата сума във валутата на проекта
„Обобщете заявките за оферта, които получихме тази седмица.“Заявките за оферта и всяка конфигурацияДанни за контакт, какво е конфигурирал всеки клиент и цената към съответния момент

Ограничения, които е добре да знаете, преди да разчитате на него

  • Агентите четат запазените данни. Редакторът записва автоматично няколко секунди след всяка промяна, така че редакция, направена преди миг, може все още да не е видима. Запазете и попитайте отново.
  • Цените и логиката от страна на сървъра имат ограничения. Изчисляването на цените и оценяването на правилата обхващат често срещаните случаи, но не всяко поведение на публикувания конфигуратор, например ценообразуване за единица при Number Input. Всеки резултат посочва какво не е оценено, а предварителният преглед и публикуваният изглед за споделяне остават окончателният източник на информация.
  • Ограничения на заявките. Всяка връзка може да изпраща 300 заявки на всеки пет минути. Работното пространство приема 30 приложени AI промени на всеки десет минути, споделени между всички свързани агенти и вградения асистент.
  • Големите отговори се съкращават и това се обозначава. Резултат над приблизително 60 KB се обобщава и маркира като съкратен, така че агентът да не обърка част от списък с целия списък.
  • Това, което агентът чете, се изпраща до вашия доставчик на AI. Заявките за оферти включват имена и данни за контакт на клиенти, затова предоставяйте обхвата Quotes съзнателно.
  • Токените изтичат след 90 дни. Сменете такъв незабавно, ако е бил поставен в чат, заявка за поддръжка или споделен екран. Смяната незабавно деактивира стария токен.

Единен слой с инструменти зад всяка AI среда

MCP сървърът не е отделен продукт, добавен допълнително. Вграденият AI асистент на Simplio3D, удостоверената крайна точка за инструменти REST за вашите собствени автоматизации и външните MCP клиенти използват един и същ регистър с инструменти, зад едно и също удостоверяване, разрешения и журнал за одит. Възможностите се държат по един и същ начин, независимо откъде ги извиквате, а обхват или роля, които ги блокират на едно място, ги блокират навсякъде.

Това е и разликата между MCP и REST API и SDK. SDK е типизиран клиент за вашия собствен код, удостоверяван с ключ API, и този ключ никога не се приема в крайната точка на MCP. MCP е предназначен за AI агенти, удостоверявани чрез връзка, за която задавате обхват за всеки инструмент.

Въпроси за MCP конектора

Всички: Starter, Pro и Enterprise, както и 30-дневният пробен период на Pro, с който започва всеки акаунт. MCP конекторите са включени в Starter от септември 2026 г. При Starter свързаният агент следва същите правила на плана като таблото за управление, така че не може да създава Modular проекти или да дублира проект.

Първо изграждате конфигуратора?

Как един проект преминава от 3D модел към опции, условна логика и ценообразуване, преди агентът изобщо да го прегледа.

Искате ли агентът да проверява вашите цени?

Ценовите блокове и редакторът на формули, които свързаният агент чете и използва за изчисления.

Искате ли AI да създаде и конфигуратора?

Генерирайте с AI опциите, правилата, цената и формуляра от описание на продукта в Simplio3D.

Използвате ChatGPT?

Плъгинът Simplio3D в директорията Plugins на ChatGPT осъществява тази връзка вместо вас, с насочено влизане вместо токен.

От блога

Ръководства, уроци и новини от екипа на Simplio3D.

Изграждайте, разгръщайте и мащабирайте 3D търговия.

Притежавайте собствен 3D конфигуратор на продукти, за да увеличите продажбите и генерирайте предложения директно от вашия уебсайт

Свързани статии

Приложението Simplio3D Shopify вече е в Shopify App Store

Приложението Simplio3D Shopify вече е в Shopify App Store

Simplio3D вече е в Shopify App Store. Инсталирайте приложението, добавете 3D конфигуратор към темата си чрез блокове и позволете на количката да начислява цената, изчислена от вашия конфигуратор.

Плъгинът Simplio3D за ChatGPT: урок стъпка по стъпка

Плъгинът Simplio3D за ChatGPT: урок стъпка по стъпка

Simplio3D вече има официален плъгин в директорията с плъгини на ChatGPT. Инсталирайте го, свържете работното си пространство и помолете ChatGPT да анализира, ценообразува, създава и управлява вашите 3D конфигуратори.