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

Отвечает на вопрос: Как дать ИИ-агенту доступ к парку?

## Ключ агента

Раздел «Агенты» выпускает ключи для машинных клиентов. Ключ открывает интерфейс MCP по адресу сервера Wyrd, путь `/mcp`. Панель управления он не открывает, а вход администратора не открывает интерфейс MCP.

![Ключи агентов](https://docs.wyrd.link/assets/img/ru/console-agents.png)

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

Отметка «Полный доступ без срока» выдаёт ключ, который делает всё, что делает администратор в панели.

Ключ показывается один раз. Отзывается он кнопкой в списке.

Если сервер Wyrd установлен у вас, первый ключ выпускается и на самой машине – тогда агенту не нужен пароль администратора:

```
sudo -u wyrd wyrd -c /etc/wyrd/wyrd.toml --issue-key assistant
```

Останавливать сервер для этого не требуется. Без `--key-classes` и `--key-days` ключ получает полный доступ без срока.

## Что агенту доступно

Агенту доступно всё, чем администратор распоряжается в панели: парк и карточки устройств, политики, группы, зоны и геозоны, программы, настройки приложений на каждом аппарате, правила оповещений, учётные записи, ключи агентов, экраны киоска, лицензии, обновления и команды на аппараты. Приложение загружается тем же вызовом – файл передаётся в теле.

Журналы агент читает выборкой: устройство, поток и число последних строк.

## Настройка агента

Агент обращается к `/mcp` методом POST и предъявляет ключ заголовком:

```
Authorization: Bearer wyrd_mcp_…
```

Ключ выполняет не больше десяти необратимых действий в час.

## Журнал обращений

Обращения агентов записываются в разделе «Агенты»: время, ключ, инструмент, устройство и итог. Отказы попадают в журнал наравне с выполненным.

## Ознакомление и демонстрация

Отдельный интерфейс отвечает на wyrd.link/mcp без ключа: он рассказывает о продукте и выдаёт демонстрационный стенд. Стенд, выданный агенту, телефоны не принимает. Стенд, взятый человеком на demo.wyrd.link, телефон принимает.

Стенд живёт до конца аренды, а закончить его можно раньше – кнопкой на странице или вызовом из интерфейса агентов. Сервер, его база и всё, что на нём завели, стираются безвозвратно, пароль перестаёт работать.

## Путь без браузера

Через wyrd.link/mcp агент проходит дорогу от учётной записи до оплаченной лицензии.

1. Заводит учётную запись. Идентификатор, пароль и ключ кабинета возвращаются один раз, и первым делом агент отдаёт их человеку.
2. Выбирает тариф и запрашивает оплату. Её подтверждает менеджер, его контакт приходит в ответе на заявку. Ключ лицензии выпускается после подтверждения.
3. Пишет в поддержку и читает ответ.
4. Если нужен сервер на вашей машине, оформляет заявку на On-Premise. После согласования берёт план установки.

Ключ кабинета и ключ агента – разные вещи. Первый открывает wyrd.link/mcp и касается учётной записи; второй открывает MCP сервера Wyrd и касается парка.