ДокументацияЭксплуатацияАгенты и MCP

Агенты и MCP

Панель умеет работать не только через браузер, но и через ИИ-ассистента. Вы подключаете панель один раз — и дальше управляете инфраструктурой обычным языком: «покажи, почему упал деплой», «перезапусти сервис», «сделай бэкап перед обновлением».

Подключение работает по открытому стандарту MCP (Model Context Protocol), который поддерживают современные ИИ-ассистенты и редакторы кода.

Что умеет агент#

FieldDescription
НаблюдениеСписок сервисов и проектов, статусы, история деплоев, логи сборки и приложения, метрики CPU и памяти, домены.
Переменные окруженияПросмотр, добавление, изменение и удаление переменных.
Базы данныхПолучение параметров подключения к управляемым базам.
УправлениеЗапуск, остановка, перезапуск и передеплой, смена типа сборки и порта, загрузка нового архива.
СозданиеНовые сервисы и базы данных, хранилища, расписания бэкапов, задачи по расписанию.
ВосстановлениеСписок точек отката и откат сервиса на выбранную сборку.
УдалениеУдаление сервисов, хранилищ, расписаний и задач.

Агент видит только ваши сервисы и действует строго от вашего имени.

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

  1. 1
    Настройте права

    В панели console.muerte.cloud откройте Настройки → раздел MCP и включите только те группы прав, которые вам действительно нужны.

  2. 2
    Добавьте MCP-сервер

    В настройках ассистента добавьте новый MCP-сервер с адресом https://console.muerte.cloud/mcp. Большинство клиентов понимают конфигурацию ниже; в ассистентах с графическим интерфейсом обычно достаточно пункта Add connector / Add MCP server и того же адреса.

  3. 3
    Подтвердите вход
    При первом обращении ассистент откроет страницу входа в панель. Войдите в аккаунт, проверьте название приложения, которое запрашивает доступ, и нажмите Разрешить. Ассистент получает ограниченный по правам доступ от вашего имени, пароль ему не передаётся.
  4. 4
    Проверьте связку
    Попросите ассистента: «Покажи список моих сервисов». В ответ должны прийти имена, статусы и адреса. Если список пуст, а сервисы есть — проверьте, что вход выполнен под тем же аккаунтом.
mcp.json
json
{
  "mcpServers": {
    "muerte-cloud": {
      "type": "http",
      "url": "https://console.muerte.cloud/mcp"
    }
  }
}

Доступные права

FieldDescription
ЧтениеСписок сервисов и проектов, статусы, деплои, логи, метрики, домены. Всегда включено.
Чтение переменныхПросмотр значений переменных окружения.
Изменение переменныхДобавление, изменение и удаление переменных.
Доступы к базам данныхХост, порт, пользователь, пароль и строка подключения.
Управление и деплойЗапуск, остановка, перезапуск, передеплой, тип сборки, порт, загрузка архива.
Создание сервисов и базСоздание новых ресурсов.
УдалениеУдаление сервисов и связанных ресурсов.

Если право выключено, соответствующее действие завершится ответом forbidden — сервисы при этом остаются нетронутыми. Права можно менять в любой момент, переподключение не требуется.

Рекомендуемый минимум
Чтение + Управление и деплой. Права на удаление и доступы к базам включайте только на время, когда они действительно нужны.

Управление сессиями#

Все активные подключения ассистентов видны в Настройки Сессии. Здесь можно отозвать доступ для отдельного подключения или для всех сразу. После отзыва ассистент перестаёт работать с панелью до повторного входа. Отзывайте доступ, если подключали ассистента на чужом или временном устройстве, инструмент больше не используется или есть любые сомнения в безопасности.

Примеры запросов#

  • «Какие сервисы сейчас не работают?»
  • «Покажи последние 200 строк логов сервиса api.»
  • «Почему упал последний деплой сайта?»
  • «Добавь переменную LOG_LEVEL=debug в сервис worker и передеплой его.»
  • «Сделай резервную копию хранилища перед обновлением.»
  • «Откати сервис на предыдущую успешную сборку.»
  • «Создай задачу по расписанию: очистка кэша каждую ночь в 04:00.»

Безопасность#

  • Агент действует только в границах выданных прав — они проверяются на стороне панели при каждом действии, а не в ассистенте.
  • Секреты и пароли не попадают в переписку с моделью, если не включено право на их чтение.
  • Доступ можно в любой момент сузить в разделе MCP или полностью отозвать в разделе Сессии.
  • Перед необратимыми операциями (удаление, откат) просите ассистента показать план действий — и подтверждайте осознанно.

Частые вопросы#

Нужно ли что-то устанавливать?

Нет. Подключение выполняется по адресу панели, локальные компоненты не требуются.

Можно ли подключить несколько ассистентов?

Да. Каждое подключение отображается в разделе Сессии отдельно и отзывается независимо.

Агент увидит чужие проекты?

Нет. Доступ ограничен вашим аккаунтом.

Что делать, если ассистент отвечает «forbidden»?

Нужное право выключено. Включите его в Настройки MCP и повторите запрос.

Что делать, если ассистент отвечает «unavailable»?

Действие временно недоступно: например, сервис остановлен и логов за текущий запуск нет. Проверьте состояние сервиса в панели и повторите.