# Авито Реклама: Пользователи аккаунта — MCP-инструмент (tool)

**MCP-инструмент (tool) для Авито Рекламы:** Перечисляет пользователей с доступом к рекламному аккаунту — по одной записи {id, role, hasLoggedIn} на пользователя, где role это admin или viewer, а hasLoggedIn показывает, входил ли приглашённый хоть раз.

Техническое имя: `list_users`

## Какую задачу решает

> Я хочу посмотреть пользователей аккаунта.

Перечисляет пользователей с доступом к рекламному аккаунту — по одной записи {id, role, hasLoggedIn} на пользователя, где role это admin или viewer, а hasLoggedIn показывает, входил ли приглашённый хоть раз.

## Когда использовать

Используйте эту возможность, когда нужен результат «Пользователи аккаунта» без ручной работы в интерфейсе Авито Рекламы. Операция выполняется только по вызову из AI-приложения.

## Что нужно передать

Параметры не нужны.

## Что вернёт

Возвращает компактный JSON-ответ исходного API или понятную ошибку MCP-инструмента. Точный состав полей зависит от операции и описан в техническом справочнике.

## Что изменится в Авито Рекламе

Инструмент только читает данные или состояние подключения и не изменяет их.

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

> Посмотреть пользователей аккаунта в Авито Рекламе. Если не хватает обязательных идентификаторов, сначала уточни их.

## Возможные ошибки и ограничения

Эти id принимают set_user_role и delete_user. Работает в пределах настроенного аккаунта: пользователей дочернего аккаунта не покажет. Вместе с данными возвращает apiPointBalance (остаток недельных баллов).

Доступ также зависит от прав токена, квот и ограничений исходного API.

## Связанные MCP-инструменты

- [Выдать пользователю доступ](./add-user.md) — `add_user`
- [Отозвать доступ пользователя](./delete-user.md) — `delete_user`
- [Изменить роль пользователя](./set-user-role.md) — `set_user_role`

## Технические сведения

- **Воздействие:** только чтение
- **Группа:** Пользователи
- **Источник описания:** регистрация `list_users` в `src/tools/users.ts`
- [Полный технический справочник](../TOOLS.md)
- [Все MCP-возможности](./index.md)