Resumen
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.
Configuración guiada
Conecta ABOUT YOU a Claude en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta ABOUT YOU con la configuración guiada y añade tu URL MCP a Claude. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
AnythingMCP está en el directorio de conectores de Claude: añádelo a Claude con un clic (se abre en una pestaña nueva), inicia sesión y elige qué servidores MCP puede usar Claude.
Prueba a pedir
Prompts de ejemplo para ABOUT YOU
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿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 + Claude
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.
- Inicia sesión en el Centro de Vendedores de ABOUT YOU como usuario Admin. Los usuarios miembros no pueden crear claves API.
- Abre Configuración, luego Claves API, y haz clic en + Agregar.
- Ingresa una etiqueta, opcionalmente una fecha de caducidad, y haz clic en Agregar clave.
- 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 Claude
La URL de tu servidor: en AnythingMCP, abre Servidores MCP → el servidor en el que está este conector, y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala dondequiera que esta guía muestreYOUR_SERVER_ID.
Ruta recomendada: funciona en claude.ai web sin editar ningún archivo de configuración.
- En Claude, abre Personalizar → Conectores.
- Haz clic en +, luego en Agregar conector personalizado.
- Ingresa un nombre, por ejemplo
ABOUT YOU, y la URL del servidor remoto de MCPhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, luego haz clic en Agregar. - Haz clic en Conectar e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.
Todas las herramientas a continuación aparecerán en tu chat: comienza a escribir indicaciones.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
about_you_list_orders | Lista los pedidos: por pedido order_number, estado (abierto, enviado, cancelado, devuelto, mixto), fulfillment_type, carrier_key, cost_with_tax y… |
about_you_list_carriers | Lista los transportistas con los que puedes enviar: key (por ejemplo DHL_STD_NATIONAL, el valor para carrier_key al enviar), carrier_name, display_label y… |
about_you_ship_order_items | Marca los artículos de pedidos abiertos como enviados, una entrada por paquete: los ids de los artículos del pedido en él, la clave del transportista, la clave de seguimiento del envío y la devolución… |
about_you_cancel_order_items | Cancela artículos de pedidos abiertos que no puedes entregar (por ejemplo, fuera de stock). Los artículos cancelados no pueden ser enviados más tarde, el stock no se añade… |
about_you_return_order_items | Registra artículos de pedidos enviados como devueltos a ti, con la clave de seguimiento de devolución. Una vez que un artículo está marcado como devuelto, ABOUT YOU reembolsa al… |
about_you_get_order_invoices | Descarga las facturas del cliente de un pedido. La respuesta es un archivo adjunto al resultado: un PDF, o un ZIP cuando el pedido tiene varios… |
about_you_get_delivery_document | Descarga el documento de entrega (albarán) de un pedido de dropshipping como un PDF adjunto al resultado. Los pedidos enviados por ABOUT YOU… |
about_you_list_products | Lista tus variantes de productos (una fila por SKU): sku, style_key, colorway_key, ean, name, status (draft, pending_approval, rejected… |
about_you_list_rejected_products | Lista los productos que ABOUT YOU rechazó en la aprobación: style_key, rejection_message, rejection_reasons[] (key, type Image Requirements o… |
about_you_upsert_products | Crea o actualiza hasta 100 variantes de productos (una entrada por SKU). Los nuevos productos comienzan como borrador; publícalos con about_you_publish_product.… |
about_you_publish_product | Publica un producto (todas las variantes de un style key). Un borrador va a la aprobación de ABOUT YOU (pending_approval, luego pending_active, luego… |
about_you_update_product_status | Establece el estado de uno o más productos por style key: published (envía a aprobación o vuelve a estar en línea), draft (retira de la aprobación; solo… |
about_you_update_stock | Establece la cantidad de stock de hasta 1000 SKUs (stock de tu propio almacén; una cantidad de 0 hace que el tamaño no esté disponible). Una actualización con una… |
about_you_update_prices | Establece el precio de hasta 1000 pares de SKU y país: precio de venta y precio de oferta opcional, como números decimales en la moneda del país.… |
about_you_delete_product | Elimina una variante por SKU. Cuando era el último tamaño de un color, el color también se elimina, y con el último color, el producto completo.… |
about_you_list_categories | Busca el árbol de categorías de ABOUT YOU: id (el valor de categoría para productos), name, path (para visualización), parent_id, material_composition_type… |
about_you_list_category_attribute_groups | Lista los grupos de atributos que una categoría exige (color, tamaño, grupos de material y otros atributos): por grupo id, name, frontend_name… |
about_you_list_brands | Lista las marcas que tu cuenta puede vender: id (el valor de la marca para productos) y name. Solo lectura, una llamada devuelve todo, 50 llamadas por minuto |
about_you_list_countries | Lista los países en los que tu cuenta vende (código, nombre), los locales para descripciones de productos y la moneda de cada país (country_code… |
about_you_get_batch_result | Lee el resultado de una escritura asíncrona: estado (pendiente, procesando, completado, reintentar, fallido) y items[] con el artículo de solicitud… |
about_you_list_reports | Lista los archivos de informe que ABOUT YOU generó para tu cuenta: id, type (SELLABLE_STOCK, WAREHOUSE_MOVEMENTS, DAC7), file_name, date… |
about_you_download_report | Descarga un archivo de informe por id. Un archivo de texto (CSV) regresa como texto, cualquier otro formato como un archivo adjunto al resultado. Solo lectura, 10… |
about_you_list_webhooks | Lista las suscripciones de webhook de la cuenta: id, url, events (order.created, order.shipped, stock.updated y otros), enabled… |
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
¿Funciona con Claude Code así como con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
¿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.
Próximos pasos
- Página de inicio del conector
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?