Avito Ads MCP

A1 Avito Ads MCP conecta la aplicación de IA a la cuenta publicitaria de Avito Ads. Ayuda a consultar campañas y estadísticas, gestionar el presupuesto y la puja de un grupo, trabajar con saldos de agencia, accesos y documentos ORD — en lenguaje natural.

No es la API de vendedor de Avito: el servidor no trabaja con productos, mensajes, pedidos ni promoción de anuncios de vendedor. Solo trabaja con campañas de display y performance de la cuenta publicitaria de Avito Ads.

• 25 herramientas. Campañas, grupos, creatividades, estadísticas, saldo, cuentas hijas, usuarios y documentos ORD.

• Cambios limitados en campañas. La API solo permite cambiar el presupuesto y la puja de un grupo; no se pueden crear, editar, pausar ni eliminar campañas, grupos o creatividades.

• Las operaciones irreversibles son visibles. La transferencia de dinero o bonificaciones, la eliminación de un usuario y la solicitud técnica a la API están marcadas como destructivas.

• Presupuesto semanal de API. Cada llamada consume puntos; el servidor devuelve el saldo apiPointBalance junto con el resultado.

Comience con una solicitud que solo lea datos:

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

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

Ver el funcionamiento en un minuto

Usted: Muestra las campañas de mi cuenta de Avito y el gasto de la semana pasada por grupos de anuncios.

Asistente: Muestra campañas, grupos, gasto, clics e impresiones. No cambia nada.

Usted: Prepara el cambio de la puja del grupo 101 a 350 rublos.

Asistente: Muestra la cuenta, el grupo, la puja actual y la nueva, y luego solicita confirmación.

Usted: Confirmo.

Asistente: Cambia la puja solo de ese grupo. La campaña, las creatividades y los demás grupos no cambian.

Related MCP server: VK Ads MCP

Contenido

• Inicio rápido

• Qué se puede encargar

• Qué puede cambiar

• Obtención de acceso

• Configuración

• Datos, límites y trabajo en segundo plano

• Documentación técnica

• Soporte

Inicio rápido

Se necesitan Node.js 20+, Client Key, Client Secret e ID de la cuenta publicitaria de Avito Ads. Para otorgar accesos se necesita el rol de administrador de la cuenta.

1. Obtenga el acceso.

2. Agregue el servidor a la aplicación de IA.

3. Envíe la primera solicitud segura de arriba.

En Settings → Plugins → MCP servers haga clic en Add server y luego agregue npx -y mcp-avito-ads@latest con AVITO_ADS_CLIENT_ID, AVITO_ADS_CLIENT_SECRET y AVITO_ADS_ACCOUNT_ID.

codex mcp add avito-ads \
  --env AVITO_ADS_CLIENT_ID=your_client_key \
  --env AVITO_ADS_CLIENT_SECRET=your_client_secret \
  --env AVITO_ADS_ACCOUNT_ID=your_account_id \
  -- npx -y mcp-avito-ads@latest
codex mcp list

Documentación de Codex MCP

claude mcp add \
  --env AVITO_ADS_CLIENT_ID=your_client_key \
  --env AVITO_ADS_CLIENT_SECRET=your_client_secret \
  --env AVITO_ADS_ACCOUNT_ID=your_account_id \
  --transport stdio --scope user avito-ads \
  -- npx -y mcp-avito-ads@latest
claude mcp list

Documentación de Claude Code MCP

Abra Settings → Developer → Edit Config y agregue:

{"mcpServers":{"avito-ads":{"command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"your_client_key","AVITO_ADS_CLIENT_SECRET":"your_client_secret","AVITO_ADS_ACCOUNT_ID":"your_account_id"}}}}

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. Documentación de Claude Desktop MCP

Agregue {"mcpServers":{"avito-ads":{"type":"stdio","command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"your_client_key","AVITO_ADS_CLIENT_SECRET":"your_client_secret","AVITO_ADS_ACCOUNT_ID":"your_account_id"}}}} en ~/.cursor/mcp.json en macOS/Linux o %USERPROFILE%\.cursor\mcp.json en Windows. Documentación de Cursor MCP

Ejecute MCP: Open User Configuration y agregue:

{"servers":{"avito-ads":{"type":"stdio","command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"${input:avito_client_id}","AVITO_ADS_CLIENT_SECRET":"${input:avito_client_secret}","AVITO_ADS_ACCOUNT_ID":"${input:avito_account_id}"}}},"inputs":[{"type":"promptString","id":"avito_client_id","description":"Avito Ads Client Key"},{"type":"promptString","id":"avito_client_secret","description":"Avito Ads Client Secret","password":true},{"type":"promptString","id":"avito_account_id","description":"ID рекламного аккаунта"}]}

Verifique el servidor con el comando MCP: List Servers. Documentación de VS Code MCP

Qué se puede encargar

• Muestra campañas, grupos, creatividades, estados y estadísticas por período.

• Compara gasto, CTR, CPM, CPC o VTR por grupos y creatividades.

• Consulta el saldo y las cuentas hijas de la agencia.

• Prepara el cambio de presupuesto o de puja de un solo grupo.

• Crea un anunciante y un contrato ORD, mostrando primero los datos que se transmiten.

• Agrega un usuario, cambia su rol o revoca el acceso después de la confirmación.

Qué puede cambiar

Las campañas, los grupos y las creatividades no se pueden crear, editar, pausar, archivar ni eliminar a través de esta API. Las creatividades y las segmentaciones tampoco están disponibles para escritura.

Obtención de acceso

1. Abra la cuenta de Avito Ads con un usuario con rol de administrador.

2. Cree una aplicación de API y copie el Client Key y el Client Secret.

3. Copie el ID de la cuenta publicitaria.

4. Transmítalos como AVITO_ADS_CLIENT_ID, AVITO_ADS_CLIENT_SECRET, AVITO_ADS_ACCOUNT_ID.

El servidor obtiene el Bearer token mediante OAuth2 client_credentials. Guarde el Client Secret como una contraseña. El ID de la cuenta está definido por configuración: las herramientas no podrán cambiar accidentalmente a otra cuenta.

Para ensayar las escrituras se puede definir AVITO_ADS_ENVIRONMENT=sandbox. El sandbox no es una copia completa de production: por ejemplo, el saldo no está disponible allí.

Configuración

Datos, límites y trabajo en segundo plano

• Presupuesto semanal de puntos. Los puntos se recargan el lunes a las 00:00 UTC. Un informe largo de hasta 100 días suele ser más económico que una serie de informes cortos; el servidor muestra apiPointBalance con cada resultado.

• Errores temporales. En caso de 429, el error devuelve Retry-After y el saldo de puntos. Las escrituras no se repiten después de un error de red o 5xx, para no transferir dinero dos veces.

• No hay monitoreo permanente. El servidor solo funciona cuando se lo invoca. Si la aplicación de IA admite tareas programadas, puede recopilar estadísticas y saldo de puntos periódicamente.

• Telemetría anónima. No incluye secretos, datos de la cuenta, argumentos ni prompts; desactivación: ASKADS_TELEMETRY=0.

Documentación técnica

• Catálogo de capacidades MCP — páginas por tareas de usuario para cada herramienta.

• Todas las herramientas y parámetros

• Documentación de desarrollo

• Documentación de publicación

• SDK oficial de Avito Ads

Soporte

¿Encontró un error o falta un escenario? Cree un issue o escriba a Telegram.