Яндекс Аудитории: Отозвать доступ к сегменту — MCP-инструмент (tool)

MCP-инструмент (tool) для Яндекс Аудиторий: Удаляет разрешение на управление сегментом у указанного пользователя.

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

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

Я хочу удалить разрешение на управление сегментом у указанного пользователя.

Удаляет разрешение на управление сегментом у указанного пользователя.

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

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

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

• segment_id — обязательно. Идентификатор сегмента (id из list_segments или из ответа создания).
• user_login — обязательно. Логин пользователя, у которого отзывается доступ.

Что вернёт

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

Что изменится в Яндекс Аудиториях

Исходный код помечает весь вызов «Отозвать доступ к сегменту» как опасный. Конкретное воздействие зависит от переданного действия и описано ниже; перед вызовом проверьте параметры и обратимость результата.

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

Удалить разрешение на управление сегментом у указанного пользователя в Яндекс Аудиториях. Если не хватает обязательных идентификаторов, сначала уточни их. Сначала покажи, какие данные изменятся, и дождись подтверждения.

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

Успешный ответ — {"success": true}.

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

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

• Выдать доступ к сегменту — add_segment_grant
• Список доступов к сегменту — list_segment_grants

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

• Воздействие: опасная операция
• Группа: Доступ к сегментам
• Источник описания: регистрация delete_segment_grant в src/tools/grants.ts
• Полный технический справочник
• Все MCP-возможности