Подключение AI-агента к DVT

AI-агент может помогать собирать и проверять пайплайн, выбирать ноды, просматривать доступные источники и запускать проекты. Для подключения используется MCP — способ предоставить агенту инструменты DVT.

Перед подключением

Попросите администратора включить AI MCP для вашей установки DVT. По умолчанию эта возможность выключена. Администратор также должен сообщить публичный адрес DVT.

Создайте нужный проект и подключения в интерфейсе DVT заранее. Вы сможете ограничить доступ агента именно этими ресурсами.

Создайте MCP-токен

  1. Откройте настройки профиля и раздел «Ключи доступа».

  2. Перейдите на вкладку «MCP-токены» и нажмите «Новый токен».

  3. Укажите понятное название, например «Помощник по загрузке продаж».

  4. Выберите срок действия.

  5. В «Разрешённых проектах» и «Разрешённых подключениях» выберите «Только выбранные» и отметьте нужные ресурсы. Вариант «Все» используйте, только если агенту нужен такой доступ.

  6. Нажмите «Создать токен» и сохраните выданное значение: оно показывается один раз.

MCP-01

На примере выбран бессрочный токен с доступом к одному проекту и ко всем подключениям. Значение секретного токена ещё не создано.

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

Подключите агент

В приложении, где работает агент, добавьте MCP-сервер с такими параметрами:

Параметр

Значение

Адрес сервера

Публичный адрес DVT с /mcp в конце, например https://dvt.example.com/mcp

Способ подключения

Streamable HTTP

Авторизация

Bearer-токен, созданный на предыдущем шаге

Названия полей зависят от приложения. Вставляйте токен в предназначенное для авторизации поле или защищённую настройку подключения, а не в текст запроса агенту.

Проверьте доступ

Начните с запроса без изменения проекта:

Покажи доступные мне проекты DVT и перечисли ноды проекта «Загрузка продаж». Ничего не изменяй и не запускай.

Затем можно поручить конкретное действие:

В проекте «Загрузка продаж» добавь фильтр по колонке amount: оставить значения не меньше 1000. Проверь граф. Пока не запускай проект.

После проверки результата отдельно попросите выполнить проект и показать итоговый статус и ошибки, если они возникнут.

Что доступно

Агент может искать ноды, читать и менять граф разрешённого проекта, проверять его, просматривать каталог доступных SQL- и файловых подключений, получать ограниченный предпросмотр данных, запускать задачи и проверять их состояние.

В текущем варианте MCP нельзя создавать и удалять сами проекты, управлять расписаниями, создавать и редактировать подключения, записывать файлы или выполнять произвольные SQL-команды изменения данных напрямую. Эти действия выполняйте в интерфейсе DVT. Запущенный агентом пайплайн при этом может записывать данные, если в нём настроены соответствующие ноды.

Если подключиться не удалось

Ситуация

Что проверить

Адрес /mcp не найден

Включён ли AI MCP у администратора и верно ли указан адрес DVT

Доступ отклонён

Используется ли MCP-токен, не истёк ли срок, не отозван ли он

Проект или подключение не видны

Разрешён ли ресурс в токене и доступен ли вашему пользователю

Агент не может настроить расписание

Это ограничение текущего MCP; используйте интерфейс DVT

Если токен больше не нужен, отзовите его в списке MCP-токенов. Если значение потеряно, создайте новый токен и обновите настройки агента.