Документація / Розробникам / MCP-сервер для AI-агентів

MCP-сервер для AI-агентів

Підключіть AI-асистента (наприклад, Claude) до вашого акаунту Configo, щоб він міг зібрати та протестувати калькулятор виробу за вас.

Configo надає MCP-сервер, який дозволяє AI-асистенту працювати напряму з вашими конфігураторами — читати специфікацію продукту або таблицю, яку ви йому дасте, створювати матеріали та структуру контролів/розрахунків/деталей, потрібну конфігуратору, і запускати тестові розрахунки, щоб перевірити, що цифри сходяться, — і все це без того, щоб ви самі клацали у візуальному редакторі.

Що він вміє

Після підключення асистент може:

  • Отримувати список ваших проєктів і матеріалів, вже заведених у проєкті
  • Створювати нові матеріали (тканини, фурнітуру тощо) й оновлювати наявні — наприклад, актуалізувати ціни за новим прайсом постачальника
  • Створювати, дублювати й видаляти конфігуратори, задавати їхні контроли, розрахунки та деталі
  • Переглядати публічну вітрину й копіювати калькулятор із неї у свій проєкт
  • Запускати тестовий розрахунок для заданого набору значень (наприклад, комбінації ширини/висоти/тканини) і отримувати у відповідь ціну та специфікацію матеріалів, яку він би дав — без створення реального замовлення; один набір або одразу кілька одним запитом
  • Читати ваші замовлення, вироби в них і параметри, з якими вони збиралися, щоб звірити калькулятор із тим, що реально продано
  • Запускати аналітичні звіти (виручка, воронка, причини відмов, прогноз, продуктивність команди, низькі залишки)
  • Створювати замовлення за калькулятором і кількістю — справжнє замовлення і лише тоді, коли ви про це просите

Окрім створення нового замовлення, замовлення лише для читання, так само як вироби та звіти: асистент не може змінити, перевести за статусами чи видалити наявне замовлення, а також змінити виріб або залишок на складі.

Асистент завжди діє від вашого імені: він бачить і може змінювати рівно те, що доступно вам самим, у проєктах, де ви берете участь — не більше.

Підключення акаунту

Адреса сервера — https://mcp.configo.org/mcp. Додайте його як віддалений MCP-сервер у вашому асистенті — більшість клієнтів (включно з Claude) самі визначать, що потрібна авторизація, і проведуть вас через звичайний екран входу та згоди, так само як ви схвалювали б будь-який інший застосунок у розділі OAuth-застосунки.

На екрані згоди асистент позначений як неперевірена програма. Це нормально: MCP-клієнти реєструються в Configo самі й під тією назвою, яку обрали, тому Configo не може поручитися, хто за ним стоїть. Звірте адресу, на яку вас обіцяють повернути (для Claude це claude.ai), і підтверджуйте, лише якщо це той асистент, який ви підключаєте.

Якщо ваш клієнт не вміє реєструватися сам і просить вручну вказати OAuth Client ID, створіть його в розділі OAuth-застосунки: позначте Публічний клієнт, вкажіть redirect URI, який назве клієнт, надайте права projects, materials, configurators, products, orders і reports та вставте отриманий Client ID у клієнт.

Як користуватися

Попросіть асистента прочитати специфікацію продукту, прайс-лист або таблицю, яку ви йому дасте, і зібрати з неї конфігуратор. Гарний перший крок для асистента — викликати інструмент get_schema_reference, який пояснює формат контролів/розрахунків/деталей — варто згадати про це, якщо ви формулюєте завдання самі, а не даєте асистенту розібратися самостійно.

Перш ніж вважати конфігуратор готовим, попросіть асистента протестувати його: задайте кілька відомих комбінацій вхідних значень (конкретні розміри та вибір матеріалів) і нехай він прожене їх через інструмент розрахунку, щоб перевірити, що підсумкова ціна та специфікація матеріалів збігаються з очікуваними — так само, як ви б перевіряли формулу в таблиці.

Так само працює звірка калькулятора з реальними замовленнями: попросіть асистента взяти кілька останніх замовлень, зроблених із ним, перерахувати кожен рядок за значеннями, збереженими в замовленні, і сказати, де результат відрізняється від того, що заплатив клієнт. Розбіжність не завжди помилка — ціни змінюються з часом, — але рядок, пораховано сильно інакше, зазвичай заслуговує на увагу.

Щоб оформити замовлення, попросіть асистента спершу порахувати його й показати ціну, а замовлення створювати лише після вашої згоди. Ціну рахує сам Configo за калькулятором, тому асистент не може призначити свою; замовлення створюється без контакту й без відповідального, тож клієнта прив'яжіть у Configo самі.

Безпека

Підтверджуючи екран згоди, ви даєте асистенту шість областей — projects, materials, configurators, products, orders і reports — і жодних інших: клієнти й компанії, оплата, команда та ролі, файли і все інше лишаються недоступними. Що б не дозволяли області, асистент обмежений тим, що доступно вам самим: якщо за вашою роллю ви бачите лише свої замовлення, він побачить лише їх.

Два моменти, про які варто знати до підтвердження:

  • Звіти містять собівартість і прибуток. Звіти завжди охоплюють усі замовлення проєкту й містять закупівельні ціни та прибуток незалежно від того, що ви бачите у списку замовлень; єдине обмеження — право вашої ролі на звіти. Прочитане асистентом іде обраному вами AI-провайдеру, тож підключайте асистента до звітів проєкту, лише якщо вас це влаштовує.
  • Він може створити замовлення, але не змінити його. Створене замовлення — справжнє: воно з'являється в усієї команди, і спрацьовують автоматизації проєкту на нові замовлення — вони можуть надіслати листи чи вебхуки, створити завдання. До ваших контактів в асистента доступу немає, тому клієнта в замовленні не вказано. Наявні замовлення, вироби та звіти через це підключення змінити не можна.

Відкликати доступ можна в будь-який момент у Налаштування → Безпека: він з'явиться в розділі Активні сесії під тією назвою, з якою асистент зареєструвався (для Claude — просто «Claude»), так само як будь-який інший схвалений вами застосунок. Відкликання там спрацьовує миттєво.

Підключалися до появи замовлень, виробів і звітів?

Попереднє підключення зберігає ті права, що були надані: з матеріалами та конфігураторами асистент працює як раніше, а на запит замовлень, виробів чи звітів відповідає повідомленням із проханням перепідключитися. Вимкніть коннектор і додайте його знову — екран згоди запросить нові права, і від них, як і раніше, можна відмовитися.