Cómo conectar Ozon Seller a Cursor vía MCP

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

Ozon Seller + Cursor

Gestiona una cuenta de vendedor de Ozon desde un agente de IA: productos, stock y precios, envíos FBS y FBO, devoluciones, movimientos financieros y el informe de saldo, analítica de ventas, almacenes, promociones, reseñas y preguntas de compradores, con actualización de precios y stock. Un Client ID y una clave de API.

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_CLIENT_ID, OZON_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 3 minutos en tu cuenta de vendedor de Ozon. El conector se ha probado con datos reales de Ozon: sus herramientas de lectura se comprobaron en una cuenta de vendedor activa.

1. En el portal de vendedores abre Settings → Seller API (seller.ozon.ru/app/settings/api-keys) y haz clic en Generate key.
2. Ponle un nombre a la clave y elige su rol: Admin cubre todas las herramientas, un rol más limitado sirve para las herramientas que cubre. Si Ozon pregunta para qué es la clave, elige un servicio externo e indica AnythingMCP.
3. Copia la clave en OZON_API_KEY en ese momento, porque Ozon la muestra una sola vez, y el Client ID de la misma página (un número) en OZON_CLIENT_ID. Instala el conector.
4. Ejecuta ozon_get_api_key_info: muestra los roles de la clave y su fecha de caducidad. Las claves de Ozon duran 3 meses, así que crea una nueva antes de que caduque.

Qué lee: tus productos por artículo (offer_id), id de producto de Ozon o SKU, con nombre, códigos de barras, precios, IVA, estado y errores de moderación; el stock en FBO, FBS y rFBS y por cada almacén propio; los precios con el precio mínimo, el precio tras tus promociones, el índice de precios y la comisión de venta para FBO y FBS; los envíos FBS, rFBS y FBO de un periodo, y un envío FBS completo con entrega, seguimiento, cancelación y el pago por producto; las devoluciones con motivo y estado; el informe de saldo como en Finance → Balance, todos los movimientos de un día y los movimientos de hasta 200 envíos; la analítica de ventas; tus almacenes; las promociones de Ozon a las que puedes unirte; reseñas y preguntas de compradores. Nunca se devuelven datos de contacto de los compradores.

Finanzas: Ozon desactivó la antigua lista de transacciones en septiembre de 2026. El conector ya usa los métodos que la sustituyen: el informe de saldo de hasta 30 días, la lista diaria de movimientos y los movimientos por envío.

Los envíos necesitan un periodo: para las listas FBS y FBO, la IA siempre indica una fecha de inicio y otra de fin (como máximo un año). Para los pedidos FBS de hoy filtra por el estado pendiente de embalaje.

Suscripciones: las reseñas necesitan la suscripción Review management o Premium Pro, las preguntas de compradores Premium Plus; sin ellas, Ozon rechaza esas llamadas. Sin Premium Plus, la analítica solo devuelve ingresos y unidades pedidas, de los últimos 3 meses y con un máximo de 50 llamadas al día. En cualquier caso, la analítica permite una llamada por minuto.

Pregunta antes de cada cambio: ozon_update_prices y ozon_update_stocks cambian tu tienda en vivo. La IA te muestra cada producto con el precio o el stock antiguo y el nuevo, espera tu sí, luego revisa la respuesta de Ozon y vuelve a leer los valores. Un valor de stock sustituye al actual y debe excluir las unidades reservadas, así que la IA las lee antes. El precio de cada producto puede cambiar como máximo 10 veces por hora. Las respuestas a reseñas (ozon_reply_to_review) y a preguntas (ozon_answer_question) son públicas en la página del producto: la IA te enseña el texto exacto antes de publicarlo.

Desactivadas al instalar: ozon_ship_fbs_posting (preparar un pedido FBS en bultos) y ozon_cancel_fbs_posting (cancelar un pedido FBS, algo que no se puede deshacer y puede afectar a tu valoración como vendedor). Un administrador las activa a conciencia, y la IA pide tu confirmación explícita cada vez.

Límites de solicitudes: como máximo 50 solicitudes por segundo por Client ID, más límites por método. Ante un 429, la IA espera el tiempo que Ozon indica en Retry-After. Ozon puede bloquear las claves que envían muchas solicitudes idénticas o fallidas.

Errores habituales: 401 Invalid Api-Key significa que la clave es incorrecta, ha caducado o pertenece a otro Client ID. 403 "missing a required role" significa que la clave funciona pero su rol no cubre esa herramienta; revisa los roles con ozon_get_api_key_info. 403 "restricted to specific IP addresses": permite todas las redes para la clave.

El conector no crea ni edita fichas de producto, no crea solicitudes de suministro FBO, no imprime etiquetas ni actas, no chatea con compradores, no se une a promociones ni las gestiona y no usa la API Performance (publicidad).

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 Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Ozon Seller.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué pedidos FBS están pendientes de embalar ahora mismo y desde qué almacén?"
• "Muéstrame mi saldo de Ozon de la primera quincena de octubre: devengado, pagado, ventas, devoluciones y comisiones."
• "¿Qué productos están agotados en mi propio almacén y cuántas unidades me quedan en los almacenes de Ozon?"
• "¿Qué cobró y qué pagó Ozon por el envío 89491381-0072-1? Desglosa los movimientos."
• "Sube el precio del artículo ART-123 de 1990 a 2190 rublos. Enséñame el precio antiguo y el nuevo antes de cambiarlo."
• "Muéstrame las reseñas nuevas de 1 y 2 estrellas de esta semana y redacta respuestas para que yo las apruebe."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT