Conectar Ozon Performance MCP con Microsoft Copilot

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Ozon Performance (Ads), pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Ozon Performance (Ads) + Microsoft Copilot

Ozon Performance API para la cuenta publicitaria del vendedor: campañas de pago por clic, de pago por pedido y de banners, sus productos y pujas, pujas de la competencia y límites de puja, estadísticas diarias y de gasto y los informes detallados de campaña. Detén campañas y cambia pujas. Un client ID y un client secret de una cuenta de servicio.

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:

OZON_PERFORMANCE_CLIENT_ID, OZON_PERFORMANCE_CLIENT_SECRET

Paso 1 — Obtener credenciales

La configuración lleva unos 3 minutos. Necesitas una cuenta de vendedor de Ozon con su cuenta publicitaria (Ozon Performance), donde creas una cuenta de servicio y una clave para ella.

1. En el portal de vendedores de Ozon abre Settings → API keys → Performance API (seller.ozon.ru/app/settings/api-keys?currentTab=performanceApi).
2. Si todavía no hay una cuenta de servicio, crea una con Create new account. Haz clic en el nombre de la cuenta de servicio y luego en Add new key.
3. Copia el client ID en OZON_PERFORMANCE_CLIENT_ID: termina en @advertising.performance.ozon.ru, así que pégalo completo. Copia el client secret, que aparece junto al client ID al añadir la clave, en OZON_PERFORMANCE_CLIENT_SECRET. Si has perdido el secret, añade una clave nueva.
4. Instala el conector y comprueba la conexión con ozon_performance_list_campaigns (sin argumentos): lista tus campañas con los ids que usan todas las demás herramientas.

Separado del conector Ozon Seller: este conector cubre solo la cuenta publicitaria y tiene sus propias credenciales, así que aquí no se usa la clave de la Seller API. Para pedidos, productos, stock y precios usa el conector Ozon Seller.

Cloud y self-hosted funcionan igual: pegas los mismos dos valores y no hay ninguna Redirect URL que configurar.

Los tokens se renuevan solos: el conector cambia el client ID y el secret en POST /api/client/token (grant type client_credentials) por un bearer token que dura 30 minutos, y pide uno nuevo antes de que caduque o tras un 401. Un 401 en el paso del token significa que el client ID o el secret son incorrectos o que la clave se eliminó: vuelve a copiar ambos o añade una clave nueva a la cuenta de servicio. Un 403 significa que la cuenta de servicio no tiene acceso a ese método o a esa campaña.

Tipos de campaña: SKU es pago por clic (Оплата за клик), SEARCH_PROMO es pago por pedido (Оплата за заказ), y además están BANNER y VIDEO_BANNER. Los productos de una campaña por clic y sus pujas salen de ozon_performance_list_campaign_products; los productos en promoción de pago por pedido, de ozon_performance_list_cpo_products.

Estadísticas rápidas: ozon_performance_get_daily_statistics, ozon_performance_get_expense_statistics y ozon_performance_get_cpc_campaign_statistics responden al momento con filas JSON. Sin fechas cubren los últimos 7 días. Las fechas son días (2026-10-01), que Ozon agrupa en hora de Moscú. ozon_performance_get_cpc_campaign_statistics no cuenta para los límites de informes.

Los informes detallados son asíncronos: ozon_performance_request_campaign_report pide un informe por producto de hasta 10 campañas para un máximo de 62 días, agrupado por día, semana o mes, y devuelve un UUID. La IA consulta ozon_performance_get_report_status cada pocos segundos hasta que state es OK (o ERROR) y luego descarga el informe con ozon_performance_download_report: texto CSV (separado por punto y coma, con nombres de columna en ruso) para una campaña, un archivo ZIP con un CSV por campaña para varias. Solo se genera un informe a la vez por cuenta, y como máximo 2000 al día; ozon_performance_list_api_reports encuentra los informes pedidos antes. ozon_performance_request_search_phrases_report funciona igual para las frases de búsqueda de la promoción en los primeros puestos, un método que Ozon marca como en pruebas.

Importes e ids: los presupuestos de campaña están en millonésimas de rublo (1000000 = 1 rublo); los límites de puja de ozon_performance_get_bid_limits están en rublos; las pujas de pago por pedido son un porcentaje del precio del producto. Los ids son cadenas numéricas.

Cambiar pujas: ozon_performance_update_campaign_bids cambia las pujas de productos que ya están en una campaña por clic, y Ozon sustituye las palabras de exclusión y las pujas por frase de la campaña por lo que se envía. ozon_performance_add_campaign_products añade como máximo 500 productos por campaña; en una campaña con estrategia automática, solo productos de su categoría de piloto automático. Una puja por clic solo se aplica con la estrategia de coste medio por clic y se indica en la misma unidad que las pujas actuales que lee el conector; sin ella, Ozon fija la puja competitiva.

Límites de solicitudes: como máximo 100.000 solicitudes al día por cuenta, más límites en los cambios de campaña (por ejemplo 500 cambios de presupuesto o de estrategia por campaña al día) y en los informes. Ante un 429, espera y vuelve a intentarlo más tarde.

Qué lee: tus campañas con tipo, estado, tipo de pago, ubicación, estrategia, fechas y presupuestos; los SKU o banners que promociona una campaña; los productos de una campaña por clic con su puja por clic, la cuota objetivo de coste publicitario o el rango de posiciones en la búsqueda; las pujas de otros vendedores para los mismos SKU, y las pujas mínimas y máximas por herramienta de promoción, ubicación y categoría; los productos en promoción de pago por pedido con precio, puja, índice de visibilidad y visualizaciones; visualizaciones, clics, gasto, pedidos y valor de los pedidos por campaña y día, el gasto dividido entre la cuenta de prepago y los bonos, los totales del periodo de las campañas por clic y los informes detallados por producto y de frases de búsqueda.

Desactivadas al instalar: ozon_performance_activate_campaign y ozon_performance_remove_campaign_products. La primera inicia una campaña, que entonces muestra anuncios y gasta su presupuesto; la segunda quita productos de una campaña por clic, y sus pujas se pierden. Activa en la página del conector solo las que necesites; la IA te pide confirmación antes de cada cambio. ozon_performance_deactivate_campaign, ozon_performance_add_campaign_products y ozon_performance_update_campaign_bids están activadas: detienen una campaña, añaden productos a una campaña por clic y cambian sus pujas, y con ello lo que gasta, siempre después de que la IA te haya mostrado exactamente qué va a cambiar.

No incluido: crear y copiar campañas, presupuestos y estrategias, cambios de pujas de pago por pedido, estadísticas de banners y vídeo, informes de atribución de pedidos y analítica de tráfico externo.

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 muestra YOUR_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.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. 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.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Ozon Performance (Ads).
6. 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

Ejemplos de prompts

• "¿Qué campañas publicitarias de Ozon tengo activas ahora mismo y cuál es su presupuesto diario?"
• "¿Cuánto gastó cada campaña al día la semana pasada y cuánto de eso se pagó con bonos?"
• "Compara las pujas actuales de mi campaña de pago por clic con las pujas de la competencia para los mismos SKU."
• "Pide un informe detallado por producto de mis campañas por clic de octubre, agrupado por semana, y resúmelo."
• "¿Qué productos en promoción de pago por pedido tienen la puja más alta en porcentaje del precio y cuántas visualizaciones tuvieron esta semana?"

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