# Яндекс Директ: Действие с ключевыми фразами — MCP-инструмент (tool)

**MCP-инструмент (tool) для Яндекс Директа:** Выполняет действие над ключевыми фразами по id: suspend, resume или delete.

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

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

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

Выполняет действие над ключевыми фразами по id: suspend, resume или delete.

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

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

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

- `action` — **обязательно**. Действие из перечня, указанного в описании инструмента.
- `ids` — **обязательно**. Id ключевых фраз, к которым применить действие.

## Что вернёт

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

## Что изменится в Яндекс Директе

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

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

> Выполнить действие с ключевыми фразами в Яндекс Директе. Если не хватает обязательных идентификаторов, сначала уточни их. Сначала покажи, какие данные изменятся, и дождись подтверждения.

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

Проверьте обязательные параметры, права токена и актуальные ограничения исходного API.

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

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

- [Добавить ключевые фразы](./add-keywords.md) — `add_keywords`
- [Список ключевых фраз](./list-keywords.md) — `list_keywords`
- [Задать ставки ключевых фраз](./set-keyword-bids.md) — `set_keyword_bids`

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

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