Conectar ABOUT YOU MCP con Cursor

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → ABOUT YOU, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

ABOUT YOU + Cursor

API del Centro de Vendedores de ABOUT YOU para socios de mercado: pedidos, envíos con seguimiento, facturas y albaranes, productos con estado de aprobación, stock, precios, categorías y atributos, marcas e informes. Clave API.

Requisitos previos

Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:

ABOUT_YOU_API_KEY

Paso 1 — Obtener credenciales

La configuración tarda aproximadamente 2 minutos.

1. Inicia sesión en el Centro de Vendedores de ABOUT YOU como usuario Admin. Los usuarios miembros no pueden crear claves API.
2. Abre Configuración, luego Claves API, y haz clic en + Agregar.
3. Ingresa una etiqueta, opcionalmente una fecha de caducidad, y haz clic en Agregar clave.
4. Copia la clave de inmediato en ABOUT_YOU_API_KEY: el Centro de Vendedores solo la muestra esta vez.

La clave se envía en el encabezado X-API-Key. Para datos de prueba, crea un sandbox en Configuración, Sandbox, Crear Sandbox: tiene su propia clave API en la misma dirección, los productos se publican allí sin aprobación, y los pedidos de prueba provienen del botón Recibir Pedidos en la página de Pedidos.

Dónde empezar: about_you_list_orders con order_status abierto muestra lo que está esperando ser enviado. about_you_list_products muestra tu catálogo con stock y precios. about_you_list_countries es la llamada económica que prueba que la clave funciona.

Pedidos y envíos: about_you_list_orders devuelve los artículos de cada pedido con su id; las herramientas de envío, cancelación y devolución toman estos ids de artículo, nunca SKUs. Envía con about_you_ship_order_items (clave de transportista de about_you_list_carriers, clave de seguimiento de envío y clave de seguimiento de devolución son todas requeridas). about_you_get_delivery_document devuelve el albarán de un pedido de dropshipping y about_you_get_order_invoices las facturas del cliente, ambos como archivos. about_you_cancel_order_items y about_you_return_order_items están instalados desactivados: un artículo cancelado no puede ser enviado más tarde, y marcar un artículo como devuelto hace que ABOUT YOU reembolse automáticamente al cliente. Verifica una devolución dentro de las 24 horas de la recepción; no registres una que rechaces.

Escrituras asíncronas: cada escritura responde de inmediato con un batchRequestId y se procesa en segundo plano. Lee el resultado con about_you_get_batch_result (elige el result_type correspondiente) hasta que el estado esté completado o fallido; cada artículo lleva éxito y errores. Los resultados se mantienen durante 7 días. La misma carga útil enviada dos veces en un corto período devuelve el mismo id de lote y no se procesa de nuevo.

Productos: una fila es un SKU (un tamaño de un color de un estilo). Crea o cámbialos con about_you_upsert_products utilizando ids de about_you_list_categories, about_you_list_category_attribute_groups y about_you_list_brands, luego envía el estilo para aprobación con about_you_publish_product. Estados: borrador, pendiente_aprobación (bloqueado mientras ABOUT YOU revisa), rechazado (razones en about_you_list_rejected_products), pendiente_activo, activo, inactivo y problema (un producto activo que se volvió inválido; vuelve a ser activo una vez corregido). about_you_update_product_status (también borrador e inactivo) y about_you_delete_product están instalados desactivados.

Stock y precios: about_you_update_stock y about_you_update_prices aceptan hasta 1000 filas por llamada y siempre se aplican, a diferencia del stock o precios enviados a través de la actualización de productos. Los precios de los productos son números decimales en la moneda del país (49.99), mientras que los montos de los pedidos son enteros en la unidad más pequeña (4999 = 49.99 EUR). Envía currency con cada precio.

Informes y webhooks: about_you_list_reports y about_you_download_report (informes de stock y movimiento para bienes en los almacenes de ABOUT YOU, DAC7), about_you_list_webhooks (solo lectura).

Paginación: las listas devuelven items y pagination. Los pedidos y productos deben paginarse con cursor = pagination.next_cursor; el parámetro de página aún funciona allí pero está en desuso. Listas más pequeñas utilizan page y per_page (máx. 100).

Tipos de cumplimiento: dropshipping significa que tú envías; fulfillment_by_marketplace significa que ABOUT YOU envía desde su propio almacén (FbAY), por lo que no hay nada que enviar y no hay documento de entrega para esos pedidos.

Límites de tasa (por endpoint y por clave): pedidos 100 por minuto, envío 200, cancelación y devolución 50, stock 1000, precios 200, lista de productos 1000, actualización de productos y estado 100, resultados de lotes 200, facturas e informes 10. Los encabezados X-RateLimit-Limit y X-RateLimit-Remaining muestran el presupuesto; un 429 significa esperar hasta el siguiente minuto.

Errores: 400 y 401 responden con un JSON message. Un 404 en un documento significa que el pedido no tiene tal archivo. Esta API no tiene llamada de pago o reembolso; la única acción que lleva a un reembolso es registrar una devolución, que está desactivada.

Paso 2 — Instalar 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 — Agregar 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 ABOUT YOU.

Herramientas disponibles

Ejemplos de indicaciones

• "¿Qué pedidos de ABOUT YOU están abiertos y esperando ser enviados?"
• "¿Cuáles de mis productos fueron rechazados por ABOUT YOU, y por qué?"
• "Establece el stock de SKU AY-TSHIRT-WHT-M en 50."
• "Envía los artículos del pedido 123456789 con DHL, seguimiento 003404341612345678 y seguimiento de devolución 003404341698765432."
• "Descarga el informe de ventas del mes pasado."

Preguntas frecuentes

¿Dónde consigo la clave API? En el Centro de Vendedores de ABOUT YOU, iniciando sesión como usuario Admin: Configuración, Claves API, + Agregar. La clave se muestra solo una vez. Un sandbox en Configuración tiene su propia clave para pedidos de prueba.

¿Qué cubre? Pedidos y sus artículos, envíos con seguimiento, facturas de clientes y albaranes, productos con su estado de aprobación, stock, precios, categorías, atributos, marcas, resultados de lotes, informes y webhooks.

¿Qué herramientas se instalan desactivadas? about_you_cancel_order_items, about_you_return_order_items, about_you_update_product_status y about_you_delete_product, porque un artículo cancelado no puede ser enviado más tarde y marcar un artículo como devuelto hace que ABOUT YOU reembolse automáticamente al cliente. Actívalas en la página del conector solo si la IA debe usarlas.

¿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 de inicio del conector
• Conectar a Claude