Conectar Falabella a Cursor vía MCP: catálogo y precios

💡 ¿Sin instalar nada? Usa directamente cloud.anythingmcp.com. Inicia sesión, haz clic en Connectors → Falabella Seller Center, pega tus credenciales, genera una clave de API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Falabella Seller Center + Cursor

Deja que tu IA gestione tu tienda de falabella.com en Chile, Colombia o Perú a través de Falabella Seller Center: productos, stock por almacén, marcas, categorías y sus atributos, pedidos y sus artículos, etiquetas de envío y resultados de feeds, además de crear productos y cambiar precios, stock e imágenes.

Requisitos previos

Consulta las instrucciones de configuración completas incluidas en el conector (visibles en la tienda dentro de la aplicación al seleccionar el conector). Las variables de entorno necesarias para este conector son:

FALABELLA_USER_ID, FALABELLA_API_KEY, FALABELLA_SELLER_ID, FALABELLA_BUSINESS_UNIT

Paso 1 — Obtén las credenciales

La configuración lleva unos 5 minutos. Necesitas una cuenta de vendedor en Falabella Seller Center, un usuario de Seller Center con un rol de API, la clave de API de ese usuario y tu Seller ID.

No hay sandbox: todas las llamadas, incluidas las de escritura, actúan sobre tu tienda real.

1. Inicia sesión en sellercenter.falabella.com con el usuario con el que debe actuar el conector. Un administrador puede añadir un usuario dedicado en Mi cuenta → Usuarios → Agregar Usuario.
2. Abre Mi cuenta → Usuarios. Pon el correo electrónico del usuario en FALABELLA_USER_ID y el valor de la columna API Key de esa fila en FALABELLA_API_KEY.
3. Asigna al usuario un rol de API: Seller API Access (todos los métodos), Seller API Product Access (productos, marcas, categorías, imágenes y feeds) o Seller API Order Access (pedidos). Un método fuera del rol responde E009: Access Denied.
4. Copia tu Seller ID, que aparece en Mi cuenta, en FALABELLA_SELLER_ID.
5. Establece FALABELLA_BUSINESS_UNIT según tu país: FACL Chile, FACO Colombia, FAPE Perú. Un conector atiende a un solo país; añade un segundo conector para otro país.
6. Instala el conector. Ejecuta falabella_seller_center_feed_count para comprobar la conexión: es una llamada ligera.

Cómo firma: cada petición se firma con HMAC-SHA256, usando tu clave de API como clave. La clave en sí nunca se envía. Una petición cuya marca de tiempo esté demasiado desfasada es rechazada (E003).

La nube y el autoalojamiento funcionan igual: las credenciales son las mismas y no hay que configurar ninguna URL de redirección.

Por dónde empezar: falabella_seller_center_get_products lista productos con filtros por estado, búsqueda, SKU y fechas. falabella_seller_center_get_stock muestra el stock por almacén, incluido Fulfillment by Falabella. Para los pedidos, falabella_seller_center_get_orders y falabella_seller_center_get_order_items, que devuelven el OrderItemId y el PackageId que necesitan las etiquetas y los cambios de estado. falabella_seller_center_get_document devuelve la etiqueta de envío.

Productos nuevos: encuentra la categoría con falabella_seller_center_get_category_suggestion a partir de un título, o en falabella_seller_center_get_category_tree (los productos solo van en categorías hoja). Lee sus atributos con falabella_seller_center_get_category_attributes y el nombre exacto de la marca con falabella_seller_center_get_brands. Después crea los productos con falabella_seller_center_create_products y añade las imágenes con falabella_seller_center_set_images.

Las escrituras son feeds: crear, actualizar, fijar precios, gestionar stock, añadir imágenes y eliminar productos es asíncrono. Una respuesta correcta solo significa que la petición fue aceptada. falabella_seller_center_feed_status muestra el resultado: espera a que Status sea Finished, Error o Canceled, y luego lee FailedRecords y FeedErrors, porque un feed puede terminar con algunos registros rechazados. Falabella permite 50 llamadas de feed libremente y después una cada 2 minutos por vendedor, así que la IA agrupa varios productos en una sola petición en lugar de hacer una llamada por SKU.

Códigos de país: la unidad de negocio va en mayúsculas (FACL). Dentro del XML de producto, el mismo país es el OperatorCode en minúsculas: facl, faco, fape.

Desactivadas en la instalación: falabella_seller_center_remove_products (eliminar productos), falabella_seller_center_set_status_ready_to_ship (marcar artículos de un pedido como listos para enviar) y falabella_seller_center_set_status_canceled (cancelar un artículo de un pedido). Actívalas en la página del conector cuando quieras que la IA las use; la IA te pide confirmación en cada llamada. Crear y actualizar productos y cambiar precios, stock e imágenes está activado (falabella_seller_center_create_products, falabella_seller_center_update_products, falabella_seller_center_update_price, falabella_seller_center_update_stock, falabella_seller_center_update_stock_xml, falabella_seller_center_set_images).

Formatos: los filtros de fecha usan ISO 8601 (2026-11-01T00:00:00+00:00). Los precios usan el punto como separador decimal. Las listas de ids van entre corchetes: [123456,123457]. Una actualización solo cambia los elementos que contiene.

Errores comunes: E007 significa que la firma no coincide: la clave de API debe pertenecer al usuario de FALABELLA_USER_ID (la misma fila en Mi cuenta → Usuarios) y copiarse completa. E009 significa que el rol del usuario no cubre ese método. E429 significa que se alcanzó el límite de feeds: espera e inténtalo de nuevo. Falabella comunica los rechazos con HTTP 200; el conector los notifica como llamadas fallidas.

Paso 2 — Instala el adaptador

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ñade 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 Falabella Seller Center.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué pedidos han entrado hoy y qué artículos faltan por enviar?"
• "Muestra el stock del SKU ZAP-RUN-42 en cada almacén."
• "¿Terminó mi último feed? Lista los registros rechazados y el motivo."
• "Cambia el precio del SKU ZAP-RUN-42 a 49990 con un precio de oferta de 39990 hasta fin de mes."
• "Sugiere una categoría para 'Zapatillas running hombre' y lista sus atributos obligatorios."

Preguntas frecuentes

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

Próximos pasos

• Página del conector
• Conectar con Claude