Cómo conectar Wildberries a Cursor — via MCP

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

Wildberries + Cursor

Gestiona una cuenta de vendedor de Wildberries desde un agente de IA: pedidos FBS y sus estados, almacenes del vendedor y niveles de stock, estadísticas de pedidos y ventas, stock en almacenes de WB, el detalle del informe de ventas, fichas de producto y precios. 22 herramientas en los hosts de la WB API, un solo token 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:

WILDBERRIES_API_TOKEN

Paso 1 — Obtener credenciales

Un solo token sirve para todas las herramientas; cada herramienta llama por sí misma al host correcto de la WB API (marketplace, estadísticas, analítica, finanzas, contenido, precios).

1. En el portal de vendedores, abre Settings → API integrations (Настройки → Доступ к API) y haz clic en Create token.
2. Elige el tipo Base token. Según Wildberries, los tokens Personal no deben usarse en servicios en la nube. Un Base token tiene límites más bajos en estadísticas, finanzas, fichas de producto y precios (ver abajo).
3. Marca las categorías que necesitas: Marketplace (pedidos FBS, almacenes, stock), Statistics, Analytics (stock en almacenes de WB), Finance (informe de ventas), Content (fichas de producto), Prices and Discounts. Elige Read only salvo que la IA deba actualizar stock o precios.
4. Copia el token, que se muestra una sola vez, en WILDBERRIES_API_TOKEN sin Bearer. Es válido 180 días; crea uno nuevo antes de que caduque.
5. Llama a wildberries_ping para comprobar el token y luego a wildberries_list_new_orders para ver los pedidos FBS pendientes de preparar.

Un 401 significa que el token es incorrecto o ha caducado; un 403, que le falta la categoría de esa parte de la API.

Los límites son estrictos. Marketplace: 300 solicitudes por minuto, y cada respuesta 4xx cuenta como 10. Estadísticas de pedidos y ventas: una llamada por minuto, y solo una cada 3 horas con un Base token, así que llámalas una vez con date_from y trabaja con el resultado. Detalle del informe de ventas: 2 al día con un Base token. Precios: 4 por hora con un Base token. Ante un 429, espera los segundos que indica X-Ratelimit-Retry.

Stock en almacenes de WB: wildberries_get_wb_warehouse_stocks responde 403 a un Base token. Usa en su lugar el flujo del informe: wildberries_create_stock_report, luego wildberries_get_stock_report_status y luego wildberries_download_stock_report.

Escrituras: wildberries_update_stocks sobrescribe la cantidad en stock (no suma) y wildberries_set_prices cambia precios en vivo. Vuelve a leer el stock tras una actualización: los nombres de campo erróneos devuelven igualmente 204 sin cambiar nada.

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 Wildberries.

Herramientas disponibles

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
• Conectar a Gemini
• Conectar a Meta Muse