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

Подключались до появления заказов, изделий и отчётов?

Прежнее подключение сохраняет те права, что были выданы: с материалами и конфигураторами ассистент работает как раньше, а на запрос заказов, изделий или отчётов отвечает сообщением с просьбой переподключиться. Отключите коннектор и добавьте его заново — экран согласия запросит новые права, и от них по-прежнему можно отказаться.