Документация / 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»), точно так же, как любое другое одобренное вами приложение. Отзыв там срабатывает мгновенно.