VK広告 MCP

VK広告 MCP は、AIアプリケーションをVK Adsの広告アカウントに接続します。予算を費やしても成果の出ないキャンペーンを尋ねたり、グループや広告を比較したり、新しいキャンペーンを準備したり、入札額を変更したりできます。アカウントの各セクションを手動で移動するのとは異なり、アシスタントはキャンペーン、統計、残高、ステータスを1つのダイアログで照合します。

• 18のツール。 キャンペーン、グループ、広告、統計、残高、API制限、地域、およびAPIへの汎用リクエスト。

• リアルタイム広告。 入札額、予算、支出は広告アカウントの通貨で表示されます。マイクロ単位の換算は不要です。

• 完全な階層。 キャンペーン（ad_plan）→ グループ（ad_group）→ 広告（banner）。

• まず分析。 リスト、レポート、残高、ステータスは読み取り専用です。

• 変更は本番アカウントに反映。 作成、更新、ステータス操作は即座に適用されます。VK Adsにはサンドボックスはありません。

安全なリクエストから始めましょう：

私のVK広告アカウントのキャンペーンと、先週の広告グループ別の支出を表示してください。

サーバーを接続 · シナリオを見る · 技術ドキュメントを開く

1分で動作を確認

Related MCP server: vk-ads-mcp

目次

• クイックスタート

• 任せられること

• VK広告オブジェクトの構造

• データを変更できる操作

• トークンの取得方法

• 設定

• データ、制限、バックグラウンド動作

• 技術ドキュメント

• サポート

クイックスタート

Node.js 20以上とVK Adsのアクセストークンが必要です。サーバーは npx で起動するため、パッケージを個別にインストールする必要はありません。

1. トークンを取得し、AIアプリケーションにサーバーを追加します。手順は以下の5つのアプリケーションについて説明します。

2. 次のように尋ねます：「私のVK広告アカウントのキャンペーンと、先週の広告グループ別の支出を表示してください」。

アプリケーションのインターフェースから：

1. Settings → Plugins → MCP servers を開きます。

2. Add server をクリックします。

3. 起動コマンド npx -y mcp-vk-ads@latest と、自分のトークンを設定した環境変数 VK_ADS_TOKEN を追加します。

コマンドラインから：

codex mcp add vk-ads \
  --env VK_ADS_TOKEN=ваш_токен \
  -- npx -y mcp-vk-ads@latest

接続を確認します：

codex mcp list

Codex公式ドキュメント

claude mcp add \
  --env VK_ADS_TOKEN=ваш_токен \
  --transport stdio \
  --scope user \
  vk-ads \
  -- npx -y mcp-vk-ads@latest

サーバーを確認します：

claude mcp list

Claude Codeドキュメント

Settings → Developer → Edit Config を開き、claude_desktop_config.json にサーバーを追加します：

{
  "mcpServers": {
    "vk-ads": {
      "command": "npx",
      "args": ["-y", "mcp-vk-ads@latest"],
      "env": {
        "VK_ADS_TOKEN": "ваш_токен"
      }
    }
  }
}

Edit Config が利用できない場合は、macOSでは ~/Library/Application Support/Claude/claude_desktop_config.json、Windowsでは %APPDATA%\Claude\claude_desktop_config.json を編集します。

すべてのプロジェクトに適用するには ~/.cursor/mcp.json を作成し、現在のプロジェクトのみに適用するには .cursor/mcp.json を作成します：

{
  "mcpServers": {
    "vk-ads": {
      "command": "npx",
      "args": ["-y", "mcp-vk-ads@latest"],
      "env": {
        "VK_ADS_TOKEN": "ваш_токен"
      }
    }
  }
}

Cursorドキュメント

コマンドパレットを開き、MCP: Open User Configuration を実行します。mcp.json に追加します：

{
  "servers": {
    "vk-ads": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-vk-ads@latest"],
      "env": {
        "VK_ADS_TOKEN": "${input:vk_ads_token}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "vk_ads_token",
      "description": "Access-токен VK Ads",
      "password": true
    }
  ]
}

MCP: List Servers コマンドで起動を確認します。

VS Codeドキュメント

任せられること

支出と成果の分析

• 「過去7日間のキャンペーン別の支出、インプレッション、クリック数、CTRを表示して」。

• 「最も多く費やしていて成果の出ていない広告はどれ？」

• 「このキャンペーン内の広告グループを支出とクリック数で比較して」。

広告が表示されない理由を理解する

• 「このグループのすべての広告のステータス、配信状況、モデレーションを表示して」。

• 「現在停止中のキャンペーンはどれ？」

• 「モデレーションに合格しなかった広告を探して」。

広告の変更を準備する

• 「日予算5,000ルーブルのテキストキャンペーンを作成して」。

• 「このグループの日予算を1,500ルーブルに変更して」。

• 「広告12345を停止して」。

これらのコマンドは本番アカウントを変更します。呼び出し前に、アシスタントがキャンペーン、グループ、広告、金額を正しく特定していることを確認してください。

設定用のデータを探す

• 「アカウントの残高と通貨を表示して」。

• 「APIへのリクエストはあと何回残っている？」

• 「ターゲティング用のモスクワ地域のIDを探して」。

VK広告オブジェクトの構造

オブジェクトには3つの異なる状態があります。status は変更可能です：active、blocked、deleted。delivery と moderation_status は、オブジェクトが表示されているかどうかの理由を説明するだけで、直接変更することはできません。

データを変更できる操作

型付きの作成・更新・ステータス変更ツールには、内部パラメータ confirmWrite はありません。AIアプリケーションが確認をどのように求めるかは、その設定によって異なります。ネットワークエラーや 5xx の後は、盲目的に作成を繰り返さないでください。操作が適用されている可能性があるため、まずオブジェクトのリストを確認してください。

トークンの取得方法

トークンはVK Adsアカウントが発行します：

1. ads.vk.com で 設定 → APIアクセス を開き、アプリケーションを作成します。client_id と client_secret を保存します。セクションが利用できない場合は、VK AdsサポートにAPIアクセスをリクエストしてください。

2. それらをアカウントのアクセストークンと交換します：

   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

3. レスポンスから access_token を取得し、VK_ADS_TOKEN として保存します。

トークンは広告アカウントへのアクセスを提供し、予算の使用も可能にし、MCPクライアントの設定に平文で保存されます。パスワードと同様に扱ってください。APIが invalid_token を返す場合は、新しいトークンを発行して指定してください。

クライアントのアカウントを管理する代理店には、authorization_code シナリオが必要です。詳細は VK Ads APIドキュメント を参照してください。

設定

データ、制限、バックグラウンド動作

• ページングと大規模アカウント。 リストの1ページには最大250オブジェクトが含まれます。autoPaginate 時、サーバーは最大1,000オブジェクトを返し、不完全な結果には _truncated フィールドを付けます。

• API制限。 get_throttling ツールは現在の制限の残量を表示します。大量操作の前に確認してください。

• リクエストの再試行。 1リクエストのタイムアウトは60秒です。サーバーは最大3回再試行します：429 の場合はすべてのメソッドで、読み取りの場合はネットワークエラー、タイムアウト、5xx でも再試行します。遅延は Retry-After を考慮し、30秒を超えません。

• バックグラウンド監視なし。 サーバーはAIアプリケーションが呼び出したときに動作します。アプリケーションがスケジュールジョブをサポートしている場合は、統計やステータスの定期的なリクエストを設定できます。

• 匿名テレメトリ。 デフォルトで、サーバーはランダムなインストールID、イベント名またはツール名、サーバー・Node.js・OS・AIクライアントのバージョンを送信します。トークン、アカウントデータ、ツール引数、メッセージ、環境変数の値は含まれません。Ask AdsのMCPサーバーで無効にするには：ASKADS_TELEMETRY=0。

技術ドキュメント

• MCP機能カタログ — 各ツールのユーザータスク別ページ。

• 全ツールとパラメータ

• 開発ドキュメント

• npmパッケージ

• VK Ads APIドキュメント

サポート

バグを見つけた、またはシナリオが不足している？ issueを作成 するか、Telegram でお問い合わせください。