VK Ads MCP

Name: VK Ads MCP
Author: askads

作者：askadsバージョン 1.8.3i★ –iパソコンで動く

レジストリ名io.github.askads/mcp-vk-ads

インストール

概要

作者による説明（英語の原文）

MCP server for VK Ads (VK Реклама) API: manage ad plans, ad groups, banners, and statistics.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i未計測★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: マーケティング・SNS
入力が必要なもの：VK_ADS_TOKEN

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： VK_ADS_TOKEN, VK_ADS_LANG, VK_ADS_TIMEOUT_MS, VK_ADS_MAX_RETRIES, VK_ADS_API_BASE

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

npmNode.jsのインストール（npxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "vk-ads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-vk-ads"
      ],
      "env": {
        "VK_ADS_TOKEN": "your-value",
        "VK_ADS_LANG": "your-value",
        "VK_ADS_TIMEOUT_MS": "your-value",
        "VK_ADS_MAX_RETRIES": "your-value",
        "VK_ADS_API_BASE": "your-value"
      }
    }
  }
}

ターミナルでこれを実行します

claude mcp add vk-ads --env VK_ADS_TOKEN=your-value --env VK_ADS_LANG=your-value --env VK_ADS_TIMEOUT_MS=your-value --env VK_ADS_MAX_RETRIES=your-value --env VK_ADS_API_BASE=your-value -- npx -y mcp-vk-ads

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "vk-ads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-vk-ads"
      ],
      "env": {
        "VK_ADS_TOKEN": "your-value",
        "VK_ADS_LANG": "your-value",
        "VK_ADS_TIMEOUT_MS": "your-value",
        "VK_ADS_MAX_RETRIES": "your-value",
        "VK_ADS_API_BASE": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "vk-ads": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-vk-ads"
      ],
      "env": {
        "VK_ADS_TOKEN": "your-value",
        "VK_ADS_LANG": "your-value",
        "VK_ADS_TIMEOUT_MS": "your-value",
        "VK_ADS_MAX_RETRIES": "your-value",
        "VK_ADS_API_BASE": "your-value"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

VK_ADS_TOKEN 秘密 env
Optional ready-made VK Ads OAuth2 access token (Bearer) for CI and unattended installs — full account access, treat it as a secret. Without it the server connects from the chat via start_login/finish…
VK_ADS_LANG env
Language for API responses (Accept-Language header), e.g. ru, en.
VK_ADS_TIMEOUT_MS env
Per-request timeout in milliseconds.
VK_ADS_MAX_RETRIES env
Max retries for transient errors (429 rate limit, 5xx on GET, network errors on GET).
VK_ADS_API_BASE env
API root without a version segment. Defaults to https://ads.vk.com/api.

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント askads で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

マーケティング・SNSのほかのサーバーとの比較i

このカテゴリのほかの3559件のうち0%よりスターが多い
このカテゴリのほかの3559件のうち83%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの3559件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

VK Ads MCPは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：VK_ADS_TOKEN

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（1.8.3）がレジストリに届いたのは6 日前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは？

同じカテゴリには：MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

MCP YouTube Transcript

作者：jkawamoto

An MCP server retrieving transcripts of YouTube videos

パソコンで動く★ 495MIT10 日前更新

インストール

Google Analytics MCP

作者：surendranb

GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.

パソコンで動く★ 244MIT10 日前更新

インストール

BibiGPT YouTube Video Summarizer

作者：JimmyLv

AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.

クラウドで動く★ 137MIT10 日前更新

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

VK Реклама MCP

VK Реклама MCP подключает AI-приложение к рекламному кабинету VK Ads. Можно спросить, какие кампании тратят бюджет без результата, сравнить группы и объявления, подготовить новую кампанию или изменить ставку. В отличие от ручного перехода по разделам кабинета, ассистент сопоставляет кампании, статистику, баланс и статусы в одном диалоге.

22 инструмента. Кампании, группы, объявления, статистика, баланс, лимиты API, регионы, подключение кабинета и универсальный запрос к API.
Подключение из диалога. Скажите «подключи ВК Рекламу» — сервер объяснит, где взять client_id и client_secret, получит токен и дальше продлевает его сам.
Живая реклама. Ставки, бюджеты и расход отображаются в валюте рекламного кабинета — без пересчёта микроединиц.
Полная иерархия. Кампания (ad_plan) → группа (ad_group) → объявление (banner).
Сначала анализ. Списки, отчёты, баланс и статусы доступны только на чтение.
Изменения — в боевом кабинете. Создание, обновление и действия со статусами применяются сразу; у VK Ads нет песочницы.

Начните с безопасного запроса:

Покажи кампании моего аккаунта VK Рекламы и расход за прошлую неделю по группам объявлений.

Подключить сервер · Посмотреть сценарии · Открыть техническую документацию

Увидеть работу за минуту

Содержание

Быстрый старт
Что можно поручить
Как устроены объекты VK Рекламы
Что может изменить данные
Подключение кабинета
Настройка
Данные, лимиты и работа в фоне
Техническая документация
Поддержка

Быстрый старт

Нужен Node.js 20 или новее. Сервер запускается через npx, поэтому отдельно устанавливать пакет не требуется; токен при установке не нужен.

Добавьте сервер в AI-приложение — инструкции для пяти приложений ниже.
Скажите: «Подключи ВК Рекламу» — сервер проведёт подключение прямо в диалоге.
Спросите: «Покажи кампании моего аккаунта VK Рекламы и расход за прошлую неделю по группам объявлений».

Codex

Через интерфейс приложения:

Откройте Settings → Plugins → MCP servers.
Нажмите Add server.
Добавьте команду запуска npx -y mcp-vk-ads@latest. Переменные окружения не нужны: кабинет подключается в диалоге.

Через командную строку:

codex mcp add vk-ads -- npx -y mcp-vk-ads@latest

Проверьте подключение:

codex mcp list

Официальная инструкция Codex

Claude Code

claude mcp add \

--transport stdio \ --scope user \ vk-ads \ -- npx -y mcp-vk-ads@latest

Проверьте сервер:

claude mcp list

Документация Claude Code

Claude Desktop

Откройте Settings → Developer → Edit Config и добавьте сервер в claude_desktop_config.json:

"mcpServers": { "vk-ads": { "command": "npx", "args": ["-y", "mcp-vk-ads@latest"] } } }

Если Edit Config недоступна, отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows.

Cursor

Для всех проектов создайте ~/.cursor/mcp.json; только для текущего проекта — .cursor/mcp.json:

"mcpServers": { "vk-ads": { "command": "npx", "args": ["-y", "mcp-vk-ads@latest"] } } }

Документация Cursor

VS Code

Откройте палитру команд и выполните MCP: Open User Configuration. Добавьте в mcp.json:

"servers": { "vk-ads": { "type": "stdio", "command": "npx", "args": ["-y", "mcp-vk-ads@latest"] } } }

Проверьте запуск командой MCP: List Servers.

Документация VS Code

Что можно поручить

Разобраться с расходом и результатом

«Покажи расход, показы, клики и CTR по кампаниям за последние 7 дней».
«Какие объявления тратят больше всего и не приносят результата?»
«Сравни группы объявлений внутри этой кампании по расходу и кликам».

Понять, почему реклама не показывается

«Покажи статус, доставку и модерацию всех объявлений этой группы».
«Какие кампании сейчас остановлены?»
«Найди объявления, которые не прошли модерацию».

Подготовить изменения в рекламе

«Создай текстовую кампанию с дневным бюджетом 5 000 рублей».
«Измени дневной бюджет этой группы на 1 500 рублей».
«Останови объявление 12345».

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

Найти данные для настройки

«Покажи баланс и валюту моего кабинета».
«Сколько запросов к API осталось?»
«Найди ID региона Москва для таргетинга».

Как устроены объекты VK Рекламы

Объект	Роль
Кампания (`ad_plan`)	Верхний уровень: название, бюджет, ставка и период работы.
Группа (`ad_group`)	Настройки аудитории и размещения, собственные бюджет и ставка.
Объявление (`banner`)	Тексты, ссылки и креатив внутри группы.
Статистика	Отчёт по кампаниям, группам или объявлениям за период.

У объекта есть три разных состояния. status можно менять: active, blocked или deleted. delivery и moderation_status только объясняют, почему объект показывается или нет; напрямую их изменить нельзя.

Что может изменить данные

Действие	Что происходит
Списки, статистика, баланс, лимиты и регионы	Только чтение.
Создание и обновление кампаний, групп и объявлений	Сразу создаёт или меняет объект в боевом рекламном кабинете.
Действие со статусом	Активирует, останавливает или удаляет объект в живом кабинете.
`raw_request`	`GET` читает данные; `POST` и `DELETE` меняют их и требуют `confirmWrite=true`.

У типизированных инструментов создания, обновления и смены статуса нет внутреннего параметра confirmWrite. Как AI-приложение запрашивает подтверждение, зависит от его настроек. После сетевой ошибки или 5xx не повторяйте создание вслепую: операция могла успеть примениться, сначала проверьте список объектов.

Подключение кабинета

Скажите ассистенту:

Подключи ВК Рекламу

Он покажет, что сделать: в ads.vk.com открыть Настройки → Доступ к API, создать приложение и прислать в чат client_id и client_secret. Дальше сервер сам получит токен и проверит, в какой кабинет попал. Перезапускать AI-приложение и править его конфигурацию не нужно. Если раздел «Доступ к API» недоступен, запросите доступ у поддержки VK Рекламы.

Дальше подключение живёт само: токен VK действует около суток и продлевается автоматически по refresh_token. Проверить состояние — «покажи статус подключения», отключить — «отключи ВК Рекламу».

client_id и client_secret дают полный доступ к рекламному кабинету, включая трату бюджета. Сервер хранит их в ~/.config/mcp-vk-ads/credentials.json с правами только для владельца (0600) — client_secret нужен потому, что VK требует его при каждом продлении токена. Ни один инструмент их не возвращает.

Браузерного «войти и подтвердить» у VK Рекламы для сторонних серверов нет: сценарий authorization_code VK выдаёт только партнёрам с согласованным redirect_uri, поэтому подключение идёт через приложение самого пользователя. Кабинеты клиентов агентства требуют гранта agency_client_credentials — для них нужен готовый токен в VK_ADS_TOKEN (см. документацию VK Ads API).

Настройка

Настраивать нечего: всё нужное сервер спрашивает в диалоге. Переменные окружения пригодятся только для CI и автоматических установок, где диалога нет. Все они необязательные — сервер работает без единой из них.

Переменная	Назначение
`VK_ADS_TOKEN`	Готовый OAuth2 access-токен VK Ads. Имеет приоритет над входом из чата; такой токен сервер не продлевает и не удаляет.
`VK_ADS_LANG`	Язык ответов API; по умолчанию `ru`.
`VK_ADS_TIMEOUT_MS`	Таймаут одного запроса; по умолчанию 60 000 мс.
`VK_ADS_MAX_RETRIES`	Число повторов при временных ошибках; по умолчанию 3.
`VK_ADS_API_BASE`	Базовый адрес API; по умолчанию `https://ads.vk.com/api`.

Как выпустить токен для VK_ADS_TOKEN вручную

curl -X POST https://ads.vk.com/api/v2/oauth2/token.json \

-d grant_type=client_credentials \ -d client_id=ВАШ_CLIENT_ID \ -d client_secret=ВАШ_CLIENT_SECRET

Из ответа возьмите access_token. Он живёт около суток и сам не продлевается: при invalid_token выпустите новый. У одного пользователя не больше 5 активных токенов на приложение; старые отзываются запросом POST /api/v2/oauth2/token/delete.json — он удаляет все токены этого пользователя для данного client_id.

Данные, лимиты и работа в фоне

Страницы и большие кабинеты. Одна страница списка содержит до 250 объектов. При autoPaginate сервер возвращает не более 1 000 объектов и помечает неполный результат полем _truncated.
Лимиты API. Инструмент get_throttling показывает текущий остаток лимитов. Проверяйте его перед массовыми операциями.
Повторы запросов. Таймаут одного запроса — 60 секунд. Сервер делает до трёх повторов: для любого метода при 429, а для чтения ещё при сетевой ошибке, тайм-ауте и 5xx. Задержка учитывает Retry-After и не превышает 30 секунд.
Нет фонового наблюдения. Сервер работает, когда его вызывает AI-приложение. Если приложение поддерживает задания по расписанию, в нём можно настроить периодический запрос статистики или статусов.
Анонимная телеметрия. По умолчанию сервер отправляет случайный идентификатор установки, имя события или инструмента, версии сервера, Node.js, ОС и AI-клиента. При вызове инструмента сервер также отправляет его исход, а при ошибке - фрагмент её текста: код и сообщение, в которых e-mail, адреса, токены, числа от 4 цифр и текст в кавычках заменены на «#». Если в тексте ошибки есть значение из запроса, оно тоже может попасть во фрагмент. В неё не попадают токен, данные кабинета, аргументы инструментов, ваши сообщения и значения переменных окружения. Отключить её для MCP-серверов Ask Ads: ASKADS_TELEMETRY=0.

Техническая документация

Каталог MCP-возможностей — страницы по пользовательским задачам для каждого инструмента.
Все инструменты и параметры
Документация по разработке
Пакет в npm
Документация VK Ads API

Поддержка

Нашли ошибку или не хватает сценария? Создайте issue или напишите в Telegram.

VK Ads MCP

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

マーケティング・SNSのほかのサーバーとの比較i

よくある質問

代わりの候補

MCP YouTube Transcript

Google Analytics MCP

BibiGPT YouTube Video Summarizer

作者のREADME

VK Реклама MCP

Увидеть работу за минуту

Содержание

Быстрый старт

Что можно поручить

Разобраться с расходом и результатом

Понять, почему реклама не показывается

Подготовить изменения в рекламе

Найти данные для настройки

Как устроены объекты VK Рекламы

Что может изменить данные

Подключение кабинета

Настройка

Данные, лимиты и работа в фоне

Техническая документация

Поддержка