# VK Ads MCP

Подключает ИИ к VK Ads: помогает смотреть кампании и статистику, а также менять бюджеты и статусы.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11
- Автор: askads
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/askads/mcp-vk-ads
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/mcp/vk-ads-mcp

## Что делает

VK Ads MCP связывает ИИ-приложение с рекламным кабинетом VK Ads. Через диалог можно просматривать кампании, группы и объявления, сравнивать расход и клики, проверять баланс, лимиты, регионы и статусы модерации. Иерархия объектов такая: кампания `ad_plan`, группа `ad_group`, объявление `banner`.

Списки, отчёты, баланс и лимиты работают только на чтение. Создание и изменение кампаний, групп и объявлений, а также действия со статусами применяются сразу в боевом кабинете. У VK Ads нет песочницы, поэтому перед изменением бюджета или статуса нужно проверить выбранный объект.

Для запуска нужен Node.js 20 или новее и переменная `VK_ADS_TOKEN`; дополнительные параметры задаются через `VK_ADS_LANG`, `VK_ADS_TIMEOUT_MS`, `VK_ADS_MAX_RETRIES` и `VK_ADS_API_BASE`. Сервер запускается командой `npx -y mcp-vk-ads`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `VK_ADS_TOKEN`, `VK_ADS_LANG`, `VK_ADS_TIMEOUT_MS`, `VK_ADS_MAX_RETRIES`, `VK_ADS_API_BASE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env VK_ADS_TOKEN=<VK_ADS_TOKEN> --env VK_ADS_LANG=<VK_ADS_LANG> --env VK_ADS_TIMEOUT_MS=<VK_ADS_TIMEOUT_MS> --env VK_ADS_MAX_RETRIES=<VK_ADS_MAX_RETRIES> --env VK_ADS_API_BASE=<VK_ADS_API_BASE> --transport stdio vk-ads-mcp -- npx -y mcp-vk-ads
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add vk-ads-mcp --env VK_ADS_TOKEN=<VK_ADS_TOKEN> --env VK_ADS_LANG=<VK_ADS_LANG> --env VK_ADS_TIMEOUT_MS=<VK_ADS_TIMEOUT_MS> --env VK_ADS_MAX_RETRIES=<VK_ADS_MAX_RETRIES> --env VK_ADS_API_BASE=<VK_ADS_API_BASE> -- npx -y mcp-vk-ads
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "vk-ads-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-vk-ads"
            ],
            "env": {
                "VK_ADS_TOKEN": "<VK_ADS_TOKEN>",
                "VK_ADS_LANG": "<VK_ADS_LANG>",
                "VK_ADS_TIMEOUT_MS": "<VK_ADS_TIMEOUT_MS>",
                "VK_ADS_MAX_RETRIES": "<VK_ADS_MAX_RETRIES>",
                "VK_ADS_API_BASE": "<VK_ADS_API_BASE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "vk-ads-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mcp-vk-ads"
            ],
            "env": {
                "VK_ADS_TOKEN": "<VK_ADS_TOKEN>",
                "VK_ADS_LANG": "<VK_ADS_LANG>",
                "VK_ADS_TIMEOUT_MS": "<VK_ADS_TIMEOUT_MS>",
                "VK_ADS_MAX_RETRIES": "<VK_ADS_MAX_RETRIES>",
                "VK_ADS_API_BASE": "<VK_ADS_API_BASE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e VK_ADS_TOKEN=<VK_ADS_TOKEN> -e VK_ADS_LANG=<VK_ADS_LANG> -e VK_ADS_TIMEOUT_MS=<VK_ADS_TIMEOUT_MS> -e VK_ADS_MAX_RETRIES=<VK_ADS_MAX_RETRIES> -e VK_ADS_API_BASE=<VK_ADS_API_BASE> vk-ads-mcp npx -y mcp-vk-ads
```
Вместо <…> подставьте свои значения

## Когда брать
- показать расход кампаний за период
- сравнить группы по кликам и расходу
- найти объявления без показа или модерации
- изменить бюджет рекламной группы
- остановить объявление по его ID

## Примеры запросов агенту
- Покажи кампании VK Ads и расход по группам за прошлую неделю.
- Сравни группы этой кампании по кликам, расходу и статусу.
- Измени дневной бюджет выбранной группы и сначала проверь её ID.

## Похожие
- [Google Ads](https://affpapa.org/nevibecode/mcp/google-ads.md) — MCP-сервер
- [LinkedIn Ads](https://affpapa.org/nevibecode/mcp/linkedin-ads.md) — MCP-сервер
- [Meta Ads MCP Server](https://affpapa.org/nevibecode/mcp/meta-ads-mcp-server.md) — MCP-сервер · ★ 8
- [ads-meta](https://affpapa.org/nevibecode/skills/ads-meta.md) — скилл · 4800 установок
- [google-ads-report](https://affpapa.org/nevibecode/skills/google-ads-report.md) — скилл · 476 установок
- [KonQuest Meta Ads MCP](https://affpapa.org/nevibecode/mcp/konquest-meta-ads-mcp.md) — MCP-сервер · ★ 44

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md