VK Ads MCP

VK Ads MCP conecta una aplicación de IA con la cuenta publicitaria de VK Ads. Puedes preguntar qué campañas gastan presupuesto sin resultados, comparar grupos y anuncios, preparar una nueva campaña o cambiar una puja. A diferencia de navegar manualmente por las secciones de la cuenta, el asistente cruza campañas, estadísticas, saldo y estados en un mismo diálogo.

• 18 herramientas. Campañas, grupos, anuncios, estadísticas, saldo, límites de API, regiones y una consulta universal a la API.

• Publicidad en vivo. Las pujas, los presupuestos y el gasto se muestran en la moneda de la cuenta publicitaria, sin recalcular microunidades.

• Jerarquía completa. Campaña (ad_plan) → grupo (ad_group) → anuncio (banner).

• Primero el análisis. Las listas, los informes, el saldo y los estados son de solo lectura.

• Los cambios se aplican en la cuenta real. La creación, la actualización y las acciones sobre estados se aplican de inmediato; VK Ads no tiene sandbox.

Empieza con una consulta segura:

Muestra las campañas de mi cuenta de VK Ads y el gasto de la semana pasada por grupos de anuncios.

Conectar el servidor · Ver escenarios · Abrir la documentación técnica

Ver el funcionamiento en un minuto

Related MCP server: vk-ads-mcp

Contenido

• Inicio rápido

• Qué se puede encomendar

• Cómo están estructurados los objetos de VK Ads

• Qué puede modificar los datos

• Cómo obtener un token

• Configuración

• Datos, límites y trabajo en segundo plano

• Documentación técnica

• Soporte

Inicio rápido

Se necesitan Node.js 20 o superior y un access token de VK Ads. El servidor se ejecuta mediante npx, por lo que no hace falta instalar el paquete por separado.

1. Obtén un token y añade el servidor a la aplicación de IA; las instrucciones para cinco aplicaciones están más abajo.

2. Pregunta: «Muestra las campañas de mi cuenta de VK Ads y el gasto de la semana pasada por grupos de anuncios».

A través de la interfaz de la aplicación:

1. Abra Settings → Plugins → MCP servers.

2. Pulse Add server.

3. Añada el comando de arranque npx -y mcp-vk-ads@latest y la variable de entorno VK_ADS_TOKEN con su token.

A través de la línea de comandos:

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

Compruebe la conexión:

codex mcp list

Instrucciones oficiales de Codex

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

Compruebe el servidor:

claude mcp list

Documentación de Claude Code

Abra Settings → Developer → Edit Config y añada el servidor a claude_desktop_config.json:

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

Si Edit Config no está disponible, edite ~/Library/Application Support/Claude/claude_desktop_config.json en macOS o %APPDATA%\Claude\claude_desktop_config.json en Windows.

Para todos los proyectos, cree ~/.cursor/mcp.json; solo para el proyecto actual, .cursor/mcp.json:

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

Documentación de Cursor

Abra la paleta de comandos y ejecute MCP: Open User Configuration. Añada a 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
    }
  ]
}

Compruebe el arranque con el comando MCP: List Servers.

Documentación de VS Code

Qué se puede encomendar

Analizar el gasto y los resultados

• «Muestra el gasto, las impresiones, los clics y el CTR por campañas de los últimos 7 días».

• «¿Qué anuncios gastan más y no aportan resultados?»

• «Compara los grupos de anuncios dentro de esta campaña por gasto y clics».

Entender por qué la publicidad no se muestra

• «Muestra el estado, la entrega y la moderación de todos los anuncios de este grupo».

• «¿Qué campañas están pausadas ahora?»

• «Busca anuncios que no hayan pasado la moderación».

Preparar cambios en la publicidad

• «Crea una campaña de texto con un presupuesto diario de 5 000 rublos».

• «Cambia el presupuesto diario de este grupo a 1 500 rublos».

• «Pausa el anuncio 12345».

Estos comandos modifican la cuenta real. Antes de ejecutarlos, asegúrese de que el asistente haya identificado correctamente la campaña, el grupo, el anuncio y el importe.

Encontrar datos para la configuración

• «Muestra el saldo y la moneda de mi cuenta».

• «¿Cuántas solicitudes a la API quedan?»

• «Busca el ID de la región Moscú para la segmentación».

Cómo están estructurados los objetos de VK Ads

Un objeto tiene tres estados distintos. status se puede cambiar: active, blocked o deleted. delivery y moderation_status solo explican por qué el objeto se muestra o no; no se pueden cambiar directamente.

Qué puede modificar los datos

Las herramientas tipadas de creación, actualización y cambio de estado no tienen un parámetro interno confirmWrite. La forma en que la aplicación de IA solicita confirmación depende de su configuración. Tras un error de red o un 5xx, no repita la creación a ciegas: la operación podría haberse aplicado; primero compruebe la lista de objetos.

Cómo obtener un token

El token lo emite la cuenta de VK Ads:

1. En ads.vk.com, abra Configuración → Acceso a la API y cree una aplicación. Guarde client_id y client_secret. Si la sección no está disponible, solicite acceso a la API al soporte de VK Ads.

2. Cámbielos por un access token de la cuenta:

   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. Tome access_token de la respuesta y guárdelo como VK_ADS_TOKEN.

El token da acceso a la cuenta publicitaria, incluida la posibilidad de gastar presupuesto, y se almacena en texto plano en la configuración del cliente MCP. Trátelo como una contraseña. Si la API responde invalid_token, emita e indique un token nuevo.

Para agencias que trabajan con cuentas de clientes, se necesita el flujo authorization_code; consulte la documentación de la API de VK Ads.

Configuración

Datos, límites y trabajo en segundo plano

• Páginas y cuentas grandes. Una página de lista contiene hasta 250 objetos. Con autoPaginate, el servidor devuelve como máximo 1 000 objetos y marca el resultado incompleto con el campo _truncated.

• Límites de la API. La herramienta get_throttling muestra el saldo actual de límites. Compruébelo antes de operaciones masivas.

• Reintentos de solicitudes. El tiempo de espera de una solicitud es de 60 segundos. El servidor hace hasta tres reintentos: para cualquier método ante 429, y para lecturas también ante error de red, tiempo de espera agotado y 5xx. La demora tiene en cuenta Retry-After y no supera los 30 segundos.

• Sin supervisión en segundo plano. El servidor funciona cuando la aplicación de IA lo invoca. Si la aplicación admite tareas programadas, se puede configurar en ella una consulta periódica de estadísticas o estados.

• Telemetría anónima. Por defecto, el servidor envía un identificador de instalación aleatorio, el nombre del evento o la herramienta, las versiones del servidor, Node.js, el sistema operativo y el cliente de IA. No incluye el token, los datos de la cuenta, los argumentos de las herramientas, sus mensajes ni los valores de las variables de entorno. Para desactivarla en los servidores MCP de Ask Ads: ASKADS_TELEMETRY=0.

Documentación técnica

• Catálogo de capacidades MCP: páginas sobre tareas de usuario para cada herramienta.

• Todas las herramientas y parámetros

• Documentación de desarrollo

• Paquete en npm

• Documentación de la API de VK Ads

Soporte

¿Ha encontrado un error o le falta algún escenario? Cree un issue o escriba a Telegram.