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.
Configuración guiada
Conecta Yandex Direct a Microsoft Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Yandex Direct con la configuración guiada y añade tu URL MCP a Microsoft Copilot. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
Yandex Direct. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
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
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Siguientes pasos
- Página del conector
- Conectar a Claude
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
¿Te ha sido útil esta guía?