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

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

Flipkart Seller + Cursor

Flipkart Marketplace Seller API v3 para tu propia cuenta de vendedor: anuncios con actualización de precio y stock, envíos de pedidos (búsqueda, detalles, etiquetas y facturas, listo para despachar, cancelación, entrega al mensajero y manifiesto) y devoluciones.

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:

FLIPKART_APP_ID, FLIPKART_APP_SECRET

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos. Necesitas una cuenta de vendedor de Flipkart.

1. Inicia sesión en el Flipkart Seller Hub (https://seller.flipkart.com) y abre Manage Profile > Developer Access.
2. Haz clic en Create New Access, dale a la aplicación un nombre y una descripción y envíala. Flipkart muestra un Application ID y un Application Secret. Una aplicación de self access es solo para tu propia cuenta de vendedor; no la compartas con un partner.
3. Pégalos en FLIPKART_APP_ID y FLIPKART_APP_SECRET.
4. Instala el conector y ejecuta flipkart_seller_search_listings para comprobarlo.

El conector inicia sesión con client credentials de OAuth2: solicita un token con el scope Seller_Api, enviando el id y el secret de la aplicación como HTTP Basic, y pide uno nuevo antes de que caduque o tras un 401.

Anuncios: la IA recorre página a página todos los anuncios (500 por página) con id de anuncio, id de producto (FSN) y SKU, o los lee de 20 en 20 con título, estado, vertical, precios y dimensiones. Para hasta 10 SKU lee los detalles: MRP y precio de venta, impuestos, estado, perfil de fulfilment, SLA de despacho, bultos, stock por ubicación y los pedidos pendientes de completar.

Precios y stock: flipkart_seller_update_price y flipkart_seller_update_inventory cambian un SKU y necesitan su id de producto y, para el stock, el id de ubicación. Cambian al instante lo que ven los compradores, así que la IA confirma antes contigo el SKU y los valores nuevos. Una respuesta 200 puede llevar aun así status: failure para el SKU, y la IA lee el motivo.

Pedidos (envíos): un envío es lo que se empaqueta y se entrega junto. La IA busca envíos antes del despacho (APPROVED, PACKING_IN_PROGRESS, PACKED, FORM_FAILED, READY_TO_DISPATCH), después del despacho (SHIPPED, DELIVERED, PICKUP_COMPLETE) o cancelados, 20 por página, y lee los artículos del pedido, precios, fechas, el indicador de retención, direcciones, mensajero e id de seguimiento. Las búsquedas alcanzan como máximo 5.000 envíos, y los pedidos Flipkart Assured no se incluyen.

Procesar un pedido nuevo: para un envío APPROVED que no está retenido y ya ha pasado su fecha dispatch-after, la IA genera la etiqueta y la factura, las descarga en un único PDF y marca el envío como listo para despachar, lo que reserva el mensajero. Antes de la recogida lee los recuentos de entrega por mensajero con el código de un solo uso, y descarga el PDF del manifiesto de un mensajero. Estas acciones responden por envío con SUCCESS o FAILURE, incluso cuando el estado HTTP es 200.

Devoluciones: devoluciones de clientes y devoluciones del mensajero (envíos no entregados) por fecha de creación o de modificación, 25 por página, con estado, motivo e id de seguimiento, o por id de devolución o de seguimiento.

Desactivada al instalar: flipkart_seller_cancel_shipments. Las cancelaciones perjudican la valoración del vendedor y pueden provocar la suspensión de la cuenta o de una ubicación, así que un administrador activa esta herramienta de forma deliberada, y la IA solo la usa cuando se lo pides.

Formatos: las fechas son ISO 8601, en IST cuando no se indica zona. Los importes están en INR. Los id de pedido empiezan por OD, los de anuncio por LST y los de ubicación por LOC; fsn es el id de producto de Flipkart y sku el tuyo propio. Las etiquetas, las facturas y el manifiesto llegan como archivos PDF.

Errores comunes: 401 significa un token caducado o rechazado (comprueba el id y el secret de la aplicación), 400 o 422 una solicitud no válida con un código como INVALID_REQUEST_PAGE_SIZE o INVALID_DATE_FORMAT, 403 un id que pertenece a otro vendedor, y 5xx un problema del lado de Flipkart como DEPENDENT_SYSTEM_CALL_FAILED, que conviene reintentar más tarde.

El conector no crea ni edita el contenido de los anuncios y no cubre el despacho y las devoluciones de self ship, los anuncios de Flipkart Quick, los informes ni las notificaciones de pedidos.

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 Flipkart Seller.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué envíos están aprobados y hay que despachar hoy?"
• "Genera las etiquetas de todos los envíos aprobados que no estén retenidos y dame el PDF."
• "¿Cuál es el precio y el stock del SKU TSHIRT-BLU-M en cada ubicación?"
• "Pon el precio de venta del SKU TSHIRT-BLU-M en 499 INR. Muéstrame antes el precio actual."
• "Lista las devoluciones de clientes creadas esta semana con sus motivos."

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
• Conectar a Microsoft Copilot