Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Yandex Direct con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
Deja que tu IA analice tu publicidad en Yandex Direct, en solo lectura: campañas, grupos de anuncios, anuncios, palabras clave y pujas, sitelinks y textos destacados, clientes de agencia, diccionarios, seguimiento de cambios e informes estadísticos por día, campaña, anuncio o consulta de búsqueda.
Prueba a pedir
Prompts de ejemplo para Yandex Direct
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Yandex Direct, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Yandex Direct + ChatGPT
Deja que tu IA analice tu publicidad en Yandex Direct, en solo lectura: campañas, grupos de anuncios, anuncios, palabras clave y pujas, sitelinks y textos destacados, clientes de agencia, diccionarios, seguimiento de cambios e informes estadísticos por día, campaña, anuncio o consulta de búsqueda.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
YANDEX_DIRECT_TOKEN
Paso 1 — Obtener credenciales
La configuración lleva unos 10 minutos, más el tiempo que Yandex tarda en aprobar el acceso a la API (de una hora a unos días laborables). Necesitas una cuenta de Yandex Direct con al menos una campaña y una app propia registrada en oauth.yandex.ru.
- Registra una app en oauth.yandex.ru: plataforma servicios web, con el permiso Yandex Direct API (
direct:api). Apunta su ClientID. - En la interfaz web de Yandex Direct abre Tools → API, envía una solicitud de acceso a la API para ese ClientID y acepta el acuerdo de uso de la API. Hasta que Yandex apruebe la solicitud, las llamadas fallan con el error 58.
- Con la sesión de la cuenta de Direct iniciada, abre
https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID>con tu ClientID y copia elaccess_token(empieza por y0_) enYANDEX_DIRECT_TOKEN, sin Bearer ni OAuth delante. El token vale aproximadamente un año y se prolonga mientras se usa. - Solo agencias: pon en
YANDEX_DIRECT_CLIENT_LOGINel login de Yandex del anunciante que quieres leer;yandex_direct_list_agency_clientslista esos logins. Déjalo vacío para tu propia cuenta. - Instala el conector y ejecuta
yandex_direct_get_client: muestra la cuenta, su login y su moneda.
Qué lee: campañas con tipo, estado, situación, fechas, fondos y clics e impresiones acumulados, además de la estrategia de puja; grupos de anuncios con regiones y palabras clave negativas; anuncios con título, texto y enlace; palabras clave y autotargeting con pujas y productividad; pujas de palabras clave con las pujas y el tráfico necesarios para cada posición en la búsqueda; sitelinks, textos destacados, conjuntos compartidos de palabras clave negativas y listas de retargeting; clientes de agencia; diccionarios como monedas y regiones; qué campañas cambiaron desde un momento dado; e informes estadísticos por día, campaña, anuncio o consulta de búsqueda.
Informes: yandex_direct_get_report devuelve texto separado por tabuladores, con los nombres de las columnas en la primera línea y los importes en decimales. Los informes pequeños llegan al momento. Los más grandes se preparan offline: la IA vuelve a pedirlos con los mismos parámetros tras la espera que indica Yandex. Puede haber como máximo 5 informes offline en cola, y los informes de consultas de búsqueda son solo offline y cubren los últimos 180 días.
Importes y paginación: pujas, presupuestos y fondos llegan como enteros en micros (2500000 = 2,50 en la moneda de la cuenta). Las listas devuelven hasta 500 objetos por defecto y 10.000 como máximo, y los grupos, anuncios y palabras clave se leen para hasta 10 campañas por llamada.
Solo lectura a propósito: todas las herramientas leen. Nada crea, cambia, pausa ni paga nada, así que no hay nada que confirmar ni nada desactivado al instalar.
Límites: cada llamada gasta puntos de API del cupo diario del anunciante, y una llamada fallida cuesta 20 puntos. La IA prefiere una llamada con varios ids a muchas llamadas sueltas y pide solo los campos que necesita. El error 152 indica que se acabaron los puntos de hoy; 506, demasiadas peticiones a la vez.
Errores comunes: 53 significa que el token no es válido o ha caducado: consigue uno nuevo como en el paso 3. 58 significa que el acceso a la API de la app aún no está aprobado. 54, 3000 o 3001 indican que no hay acceso a la API o faltan permisos, por ejemplo para un login de cliente que el token no puede leer. 513 indica que el login no está conectado a Direct. 8000 y 4000 a 4006 indican un parámetro incorrecto, 8800 un objeto no encontrado y 9300 demasiados ids en una llamada.
El conector no crea ni edita campañas, anuncios, palabras clave ni pujas, no gestiona moderación, presupuestos ni pagos y no usa el Sandbox ni Wordstat.
Paso 2 — Instalar el adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Paso 3 — Añadir el conector en ChatGPT
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.
- Ve a chatgpt.com/plugins, pulsa + y luego Add custom MCP server.
- Escribe un nombre, por ejemplo Name:
Yandex Direct. - En Connection, introduce como Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDy deja Authentication en OAuth. - Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
- Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.
Herramientas disponibles
| Tool | What it does |
|---|---|
yandex_direct_get_client | Read the advertiser account the token acts for (or the Client-Login one): ClientId, Login, ClientInfo (name), Currency, CountryId, Type… |
yandex_direct_list_campaigns | List campaigns: Id, Name, Type (TEXT_CAMPAIGN, UNIFIED_CAMPAIGN, SMART_CAMPAIGN, MOBILE_APP_CAMPAIGN, CPM_BANNER_CAMPAIGN ...), Status… |
yandex_direct_list_ad_groups | List ad groups of up to 10 campaigns (or by id): Id, Name, CampaignId, Type, Status, ServingStatus, RegionIds, NegativeKeywords… |
yandex_direct_list_ads | List ads of up to 10 campaigns, up to 1000 ad groups, or by id: Id, CampaignId, AdGroupId, Type, Status, State, StatusClarification, and… |
yandex_direct_list_keywords | List keywords and autotargeting of up to 10 campaigns, up to 1000 ad groups, or by id: Id, Keyword, State, Status, ServingStatus… |
yandex_direct_list_keyword_bids | Read keyword bids with the auction picture: for each keyword the search and network bid and, on search, the bids and traffic volume needed… |
yandex_direct_list_sitelinks | Read sitelink sets by id (SitelinkSetId from yandex_direct_list_ads): each sitelink's Title, Href and Description |
yandex_direct_list_ad_extensions | List ad extensions (callouts) of the account: Id, Type, Status, Associated and the callout text |
yandex_direct_list_negative_keyword_sets | Read shared negative keyword sets by id (NegativeKeywordSharedSetIds of campaigns and ad groups): Id, Name, NegativeKeywords, Associated |
yandex_direct_list_retargeting_lists | List retargeting and audience lists: Id, Name, Type, Description, Rules (Metrica goals and segments), IsAvailable, Scope |
yandex_direct_list_agency_clients | For agency accounts: list the agency's advertisers with Login, ClientId, ClientInfo, Currency and Archived |
yandex_direct_get_dictionaries | Read reference dictionaries: Currencies (with bid limits), GeoRegions (region ids used in RegionIds), TimeZones, Constants, AdCategories… |
yandex_direct_check_campaign_changes | Which campaigns changed since a moment: for each changed campaign, whether the campaign itself (SELF), its groups, ads or keywords… |
yandex_direct_get_report | Run a statistics report (Reports service) and return it as tab-separated text: a column header row, one row per line, money as decimals in… |
Ejemplos de prompts
- "¿Cómo fueron mis campañas la semana pasada? Muéstrame impresiones, clics, CTR, coste y conversiones por campaña."
- "¿Qué consultas de búsqueda gastaron más en los últimos 30 días sin una sola conversión?"
- "Lista las palabras clave de la campaña Neumáticos de invierno con sus pujas, y dime qué haría falta para llegar a las primeras posiciones."
- "¿Cuáles de mis anuncios están rechazados o no se están mostrando ahora mismo, y por qué?"
- "Somos una agencia: lista nuestros clientes y enséñame el gasto de ayer del cliente romashka-shop."
FAQ
¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.
Siguientes pasos
¿Te ha sido útil esta guía?
