Документація / 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 та вставте отриманий Client ID у клієнт.

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

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

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

Безпека

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