Яндекс Директ MCP

Яндекс Директ MCP conecta la aplicación de IA al panel publicitario de Яндекс Директ. Pregunte en lenguaje natural a dónde va el presupuesto publicitario, compare campañas, anuncios y frases clave, y luego prepare o realice los cambios necesarios sin cambiar entre secciones del panel. La conexión comienza directamente en el diálogo: no es necesario crear un token de antemano ni editar la configuración.

• 44 herramientas. Campañas, grupos, anuncios, frases clave, pujas, ajustes, extensiones, estadísticas, saldo, directorios y conexión de cuenta directamente en el diálogo.

• Dos formas de conexión. El servidor remoto por URL no requiere obtener un token manualmente y solo lee datos; el local mediante npx da acceso completo al panel.

• Conexión en el chat. Яндекс abrirá la página de inicio de sesión; después del código del chat se puede trabajar con la publicidad de inmediato, y el acceso se renueva automáticamente.

• Dinero en formato claro. En las herramientas convenientes, los presupuestos, las pujas y el saldo se muestran en la moneda de la cuenta, no en microunidades de la API.

• Publicidad real. Los cambios locales se aplican en el panel real y pueden afectar el gasto. Para trabajar en un entorno de prueba existe el sandbox de Яндекс Директ.

Pruebe con el primer mensaje:

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

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

Ver el trabajo en un minuto

Usted: Conecte Яндекс Директ.

Asistente: Da un enlace para iniciar sesión en Яндекс. Ábralo con la cuenta que tenga acceso al panel publicitario correspondiente, confirme el acceso y envíe el código mostrado.

Usted: Envía el código de la página de Яндекс.

Asistente: Conecta Директ y muestra el panel. No es necesario reiniciar la aplicación.

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

Asistente: Encuentra las campañas, genera un informe por grupos de anuncios y muestra el gasto en la moneda de la cuenta.

Related MCP server: Yandex Direct MCP Server

Contenido

• Inicio rápido

• Qué se puede encargar

• Cómo funciona

• Qué puede cambiar los datos

• Conexión y configuración

• Datos y telemetría

• Limitaciones

• Documentación técnica

• Soporte

Inicio rápido

1. Elija el método de conexión y agregue el servidor a la aplicación de IA según las instrucciones a continuación.

2. Abra un nuevo diálogo y pregunte: «Muestra las campañas de mi cuenta y el gasto de la semana pasada por grupos de anuncios».

Análisis sin obtener token manualmente — por URL

El servidor remoto https://mcp.askads.ru/mcp se conecta a través de una aplicación que admite MCP por URL. Inicie sesión en Яндекс en el navegador y confirme el acceso: no es necesario pasar el token en la configuración. Esta opción es solo de lectura: estadísticas, auditoría y visualización de objetos; no cambia la configuración de la publicidad.

En Claude Code se puede agregar con el comando:

claude mcp add --transport http yandex-direct https://mcp.askads.ru/mcp

Después de conectarse, abra /mcp y complete la autorización. En otras aplicaciones que admitan HTTP MCP, agregue la misma URL a través de la interfaz de la aplicación.

Acceso completo — localmente mediante npx

Para crear y modificar objetos se necesita Node.js 20+. npx descargará el servidor en el primer inicio; no es necesario instalar el paquete por separado. No se requiere obtener un token de antemano: la conexión comienza directamente en el diálogo:

1. Agregue el servidor a la aplicación de IA: a continuación se muestra un ejemplo para Codex; las demás aplicaciones están en instrucciones plegables.

2. Escriba: «Conecta Яндекс Директ»: el asistente lo guiará a través del inicio de sesión en Яндекс y mostrará el panel.

Para CI e instalaciones de agencia: token listo y YANDEX_DIRECT_LOGIN, consulte Conexión y configuración.

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

1. Abra Settings → Plugins → MCP servers.

2. Haga clic en Add server.

3. Agregue el comando de inicio npx -y mcp-yandex-direct@latest.

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

codex mcp add yandex-direct -- npx -y mcp-yandex-direct@latest

Verifique la conexión:

codex mcp list

Instrucciones oficiales de Codex

claude mcp add --transport stdio --scope user yandex-direct -- npx -y mcp-yandex-direct@latest

Verificar la conexión: claude mcp list.

Abra Settings → Developer → Edit Config y agregue en claude_desktop_config.json:

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

Si no hay sección Developer, abra el archivo manualmente: macOS — ~/Library/Application Support/Claude/claude_desktop_config.json, Windows — %APPDATA%\Claude\claude_desktop_config.json. Reinicie Claude Desktop.

Abra ~/.cursor/mcp.json para conectar el servidor en todos los proyectos, o .cursor/mcp.json en un proyecto específico. Agregue:

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

En la paleta de comandos ejecute MCP: Open User Configuration. En el mcp.json abierto agregue el servidor:

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

Después de guardar, ejecute MCP: List Servers e inicie el servidor desde la lista.

Qué se puede encargar

Verificar cómo se gasta el presupuesto

• «¿Qué campañas gastaron más la semana pasada?»

• «¿Qué anuncios reciben impresiones y clics, pero no generan conversiones?»

• «Compara el gasto, el CTR y el precio medio por clic de las campañas durante el mes».

• «Muestra el saldo de la cuenta y el resto de la cuota diaria de la API».

Encontrar puntos de mejora

• «¿Qué frases clave gastan presupuesto pero no generan clics?»

• «¿Qué grupos y anuncios están actualmente pausados o no pasan la moderación?»

• «Comprueba qué ajustes de pujas están activos para dispositivos móviles».

• «¿Qué enlaces rápidos y aclaraciones tiene esta campaña?»

Preparar cambios

• «Propón nuevas pujas para frases con CTR alto y muestra los cambios antes de aplicarlos».

• «Comprueba si la campaña tiene palabras negativas para este tema y prepara una lista».

• «Reúne los parámetros de una nueva campaña de texto para Moscú: presupuesto, grupos, frases clave y anuncios».

Realizar una acción explícita

• «Agrega estas frases clave al grupo 123 y establece una puja de 45 ₽».

• «Pausa el anuncio 456».

• «Envía la página con la imagen a la biblioteca de anuncios».

Cómo funciona

La publicidad generalmente se construye en tres niveles: campaña → grupo de anuncios → anuncio. En el grupo se encuentran las frases clave, la configuración de visualización y los ajustes de pujas. Los anuncios pueden tener enlaces rápidos, aclaraciones, tarjetas de visita e imágenes.

El servidor ayuda a ver estos objetos juntos: vincular el gasto de la campaña con las estadísticas de los grupos, las frases clave y los anuncios. Puede crear nuevas campañas y anuncios solo de tipo texto. Las campañas de otros tipos se pueden leer, renombrar, cambiar su presupuesto, pausar, archivar y eliminar por identificador.

Las estadísticas no se generan al instante: get_statistics inicia un informe en el servicio Reports y espera a que esté listo. Las listas grandes autoPaginate recorre las páginas de resultados automáticamente.

Qué puede cambiar los datos

El servidor remoto por URL solo lee datos. El servidor local mediante npx puede modificar el panel publicitario real:

Las herramientas transmiten a la aplicación de IA etiquetas de lectura, escritura y acción potencialmente irreversible. La aplicación puede mostrar una confirmación, pero su comportamiento depende del cliente. La solicitud directa a la API no realizará una escritura sin confirmWrite=true; para cambiar la publicidad se necesita una solicitud explícita.

Conexión y configuración

Para el uso normal no se necesita un token de antemano:

1. En el chat, pida conectar Яндекс Директ.

2. Abra el enlace de Яндекс OAuth con la cuenta que tenga acceso al panel publicitario correspondiente.

3. Confirme el acceso y envíe al chat el código mostrado. Eso es todo, ya puede trabajar con la publicidad: no es necesario reiniciar el cliente ni editar la configuración.

Después, la conexión se mantiene sola: el acceso se renueva automáticamente y no caduca al año. Para verificar el estado, pida «muestra el estado de la conexión»; para desconectar, «desconecta Директ». El acceso otorgado se revoca en Яндекс ID.

Para CI e instalaciones automáticas donde no hay diálogo, la configuración está disponible mediante variables de entorno:

Puede obtener un token listo para YANDEX_DIRECT_TOKEN a través del enlace, iniciando sesión con la cuenta que tenga acceso al panel correspondiente:

Obtener token de Яндекс Директ

No publique el token en chats, repositorios ni capturas de pantalla: da acceso al panel publicitario, incluidas acciones que pueden afectar al presupuesto.

Datos y telemetría

Por defecto, el servidor envía eventos técnicos anónimos: un identificador de instalación aleatorio, el nombre de la herramienta invocada, las versiones del servidor, de la aplicación de IA, de Node.js y del sistema operativo. Esto sirve para entender qué partes del servidor se utilizan y si surgen problemas al iniciarlo. El token de Yandex, los datos del panel publicitario, los argumentos de las herramientas, los textos de las consultas, los valores y nombres de las variables de entorno no se envían.

Para desactivar la telemetría de los servidores MCP de Ask Ads, defina la variable de entorno:

ASKADS_TELEMETRY=0

Limitaciones

• Cuota diaria de API. Cada llamada consume Units. La herramienta get_quota muestra cuánto se ha gastado, cuánto queda y cuánto hay disponible hoy.

• Límites de informes. Los informes de Yandex tienen sus propias restricciones de volumen y cantidad por día, y la disponibilidad del informe en el servicio Reports hay que esperarla.

• Listas grandes. Si al hacer paginación automática se alcanza el límite interno, el servidor marca explícitamente el resultado como incompleto, en lugar de ocultarlo.

• Errores temporales. El servidor hace hasta tres reintentos ante limitaciones de frecuencia. Los errores de red y de servidor se repiten automáticamente solo en operaciones de lectura, para no duplicar un cambio.

• Panel real. Los cambios locales se aplican en el panel publicitario real y pueden afectar al gasto. Para pruebas, use el sandbox (YANDEX_DIRECT_SANDBOX=true).

• Sin supervisión continua. El servidor funciona durante la llamada desde la aplicación de IA. Si la aplicación admite tareas programadas, se puede configurar una consulta periódica para comprobar las métricas necesarias.

Documentación técnica

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

• Todas las herramientas — parámetros, respuestas y límites de cada herramienta.

• Desarrollo — estructura del proyecto y trabajo con el código fuente.

• API de Yandex Direct — fuente original sobre la API y sus limitaciones.

• Paquete npm — versiones publicadas del servidor.

Soporte

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