VK Реклама MCP

VK Реклама MCP 将 AI 应用连接到 VK Ads 广告账户。您可以询问哪些广告系列在浪费预算却没有效果，比较广告组和广告，准备新的广告系列或修改出价。与手动浏览账户各版块不同，助手会在同一对话中关联广告系列、统计数据、余额和状态。

• 18 个工具。 广告系列、广告组、广告、统计数据、余额、API 限额、地区以及通用 API 请求。

• 实时广告。 出价、预算和消耗以广告账户的货币显示——无需换算微单位。

• 完整层级。 广告系列（ad_plan）→ 广告组（ad_group）→ 广告（banner）。

• 先分析。 列表、报告、余额和状态均为只读。

• 更改直接作用于真实账户。 创建、更新和状态操作会立即生效；VK Ads 没有沙箱环境。

从一个安全的请求开始：

显示我的 VK Реклама 账户中的广告系列，以及上周各广告组的消耗。

连接服务器 · 查看使用场景 · 打开技术文档

一分钟了解工作方式

Related MCP server: vk-ads-mcp

目录

• 快速开始

• 可以委托的任务

• VK Реклама 对象的结构

• 哪些操作会修改数据

• 如何获取令牌

• 配置

• 数据、限额与后台运行

• 技术文档

• 支持

快速开始

需要 Node.js 20 或更高版本以及 VK Ads 的 access 令牌。服务器通过 npx 启动，因此无需单独安装包。

1. 获取令牌 并将服务器添加到 AI 应用——下方有五个应用的说明。

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 Реклама 对象的结构

对象有三种不同的状态。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. 将其兑换为账户的 access 令牌：

   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 文档。

配置

数据、限额与后台运行

• 分页与大型账户。 列表单页最多包含 250 个对象。启用 autoPaginate 时，服务器最多返回 1 000 个对象，并用 _truncated 字段标记不完整的结果。

• API 限额。 get_throttling 工具显示当前剩余限额。批量操作前请先检查。

• 请求重试。 单次请求超时为 60 秒。服务器最多重试三次：任何方法在 429 时重试，读取操作在网络错误、超时和 5xx 时也会重试。延迟会考虑 Retry-After，且不超过 30 秒。

• 无后台监控。 服务器仅在 AI 应用调用时运行。如果应用支持定时任务，可以在其中配置定期请求统计数据或状态。

• 匿名遥测。 默认情况下，服务器会发送随机安装标识符、事件或工具名称、服务器版本、Node.js、操作系统和 AI 客户端版本。其中不包含令牌、账户数据、工具参数、您的消息和环境变量值。为 Ask Ads 的 MCP 服务器禁用遥测：ASKADS_TELEMETRY=0。

技术文档

• MCP 能力目录 — 按用户任务分类的每个工具页面。

• 所有工具和参数

• 开发文档

• npm 包

• VK Ads API 文档

支持

发现错误或缺少某个场景？创建 issue 或通过 Telegram 联系我们。