Conectar B&Q Marketplace MCP con Claude

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

Mercado de B&Q + Claude

Gestiona tu tienda en el mercado de B&Q desde un agente de IA: pedidos, aceptación, seguimiento y envío, incidentes, ofertas con precios y stock, importaciones, mensajes, devoluciones, facturas y transacciones. El mercado vende en el Reino Unido; inicia sesión con la clave API de la tienda desde tu oficina de vendedor de B&Q.

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:

B_AND_Q_API_KEY

Paso 1 — Obtén credenciales

Países: el Reino Unido.

Quién puede vender: B&Q acepta solicitudes a través del Kingfisher Merchant Hub; el negocio debe estar registrado para el IVA. El conector necesita una cuenta de vendedor que B&Q ya ha abierto.

B&Q pertenece a Kingfisher, por eso la plataforma de vendedores está en una dirección de Kingfisher.

La configuración tarda unos 5 minutos.

1. Inicia sesión en la oficina de vendedor de B&Q: https://marketplace.kingfisher.com/login.
2. En la oficina de vendedor abre tu nombre de usuario (arriba a la derecha) > Mis configuraciones de usuario > Clave API y haz clic en Generar una nueva clave (o copia la clave existente). Pégala en B_AND_Q_API_KEY. La clave se envía tal cual en el encabezado Authorization, sin Bearer. Generar una nueva clave invalida la antigua, por lo que cualquier otra herramienta que la use dejará de funcionar.
3. Se sabe que los vendedores en B&Q establecen el id de la tienda, también con una sola tienda. Si tu usuario tiene más de una tienda, establece B_AND_Q_SHOP_ID al id numérico de la tienda en la que debe funcionar este conector (mostrado en el panel de la oficina de vendedor junto a Identificador o ID de tienda, y devuelto como shop_id por b_and_q_get_account); para trabajar en varias tiendas, instala el conector una vez por tienda. Sin esto, se usará tu tienda por defecto.
4. Instala y ejecuta b_and_q_get_account: devuelve la tienda a la que pertenece la clave.

Dónde empezar: b_and_q_get_account muestra la tienda detrás de la clave (id, nombre, estado, moneda y canales). Para el trabajo diario usa b_and_q_list_orders con order_state_codes=WAITING_ACCEPTANCE, b_and_q_list_offers para precios y stock y b_and_q_list_threads para mensajes que esperan respuesta.

Productos y ofertas competidoras: b_and_q_get_products busca productos en el catálogo de B&Q por EAN u otra referencia y devuelve el SKU del producto en el mercado; b_and_q_list_product_offers lista las ofertas de cada tienda para productos dados, mejor precio primero, a unas 5 llamadas por minuto.

Flujo de trabajo de pedidos: un nuevo pedido espera en WAITING_ACCEPTANCE. b_and_q_accept_order acepta (o rechaza) cada línea; después de que se debite al cliente, el pedido pasa a SHIPPING. Luego b_and_q_update_tracking almacena el transportista y el número de seguimiento (los códigos de transportista provienen de b_and_q_list_carriers) y b_and_q_ship_order confirma el envío (SHIPPED). Los estados posteriores son TO_COLLECT, RECEIVED, CLOSED, REFUSED y CANCELED. Usa b_and_q_list_orders con order_state_codes=WAITING_ACCEPTANCE para la lista de tareas diaria y has_incident=true para incidentes abiertos; b_and_q_resolve_incident cierra un incidente en una línea de pedido una vez que se resuelve. Los documentos adjuntos a los pedidos (notas de entrega, etiquetas, facturas de clientes) se listan mediante b_and_q_list_order_documents.

Escrituras: confirma primero. b_and_q_accept_order, b_and_q_update_tracking, b_and_q_ship_order, b_and_q_resolve_incident, b_and_q_accept_return, b_and_q_receive_return, b_and_q_update_offers, b_and_q_reply_thread, b_and_q_create_order_thread y b_and_q_import_products actúan en el mercado en vivo. Antes de cada llamada, muestra al usuario lo que cambiará (id de pedido y líneas, número de seguimiento, SKU de oferta con el precio o stock antiguo y nuevo, el texto del mensaje y los destinatarios) y espera un sí. Rechazar una línea de pedido la cancela de forma definitiva. Ninguna herramienta aquí reembolsa, cancela pedidos o mueve dinero; hazlo en la oficina de vendedor. b_and_q_import_offers puede eliminar ofertas (el modo REPLACE elimina cada oferta que falta en el archivo), por lo que se instala apagado.

Actualización de ofertas (precios y stock): b_and_q_update_offers (OF24) reemplaza toda la oferta. Cada campo que dejes fuera se restablece: una quantity faltante se convierte en 0, un discount o description faltante se elimina. Siempre lee la oferta primero (b_and_q_get_offer o b_and_q_list_offers con sku) y envíala de vuelta completa con solo el cambio previsto: shop_sku, product_id y product_id_type (de product_references), state_code, price, quantity, leadtime_to_ship, logistic_class (su código), min_quantity_alert, description, discount, all_prices, available_started / available_ended (leído como available_start_date / available_end_date) y cualquier offer_additional_fields. Deja update_delete vacío o update. La llamada devuelve un import_id; el cambio se aplica de forma asíncrona, así que revísalo con b_and_q_get_offer_import antes de leer la oferta nuevamente. Los códigos de condición para state_code provienen de b_and_q_list_offer_conditions, los códigos de clase logística de b_and_q_list_logistic_classes.

Importaciones de archivos: b_and_q_import_products (P41) y b_and_q_import_offers (OF01) toman la URL de un archivo CSV, XLSX o XML en el formato de archivo que B&Q solicita; el conector lo descarga y lo sube a B&Q. Haz seguimiento con b_and_q_list_product_imports / b_and_q_get_product_import y b_and_q_list_offer_imports / b_and_q_get_offer_import.

Devoluciones: b_and_q_list_returns (RT11) lista las solicitudes de devolución. Donde B&Q deja que la tienda decida, b_and_q_accept_return acepta o rechaza una en WAITING_ACCEPTANCE y b_and_q_receive_return confirma que los bienes han llegado. Los reembolsos permanecen en la oficina de vendedor.

Mensajes: b_and_q_list_threads lista conversaciones (filtra con entity_type=MMP_ORDER y entity_id=<order id> para un pedido; entity_id sin entity_type es rechazado), b_and_q_get_thread lee una con sus mensajes, b_and_q_reply_thread responde (destinatario CUSTOMER u OPERATOR, que es B&Q) y b_and_q_create_order_thread abre una nueva conversación sobre un pedido. Los códigos de razón para los temas provienen de b_and_q_list_reasons; deja su locale vacío a menos que sepas que el mercado tiene ese idioma (un locale inactivo responde 400).

Dinero: b_and_q_list_invoices (IV01) lista los documentos contables que B&Q emite a la tienda y b_and_q_list_transactions (TL02) las líneas de transacción (ventas, comisiones, reembolsos, pagos). Si B&Q utiliza la facturación mejorada para vendedores, IV01 no devuelve nuevos documentos; usa b_and_q_list_document_requests (DR11) y las transacciones entonces.

Listas de referencia: b_and_q_list_channels (sitios de países), b_and_q_list_carriers, b_and_q_list_shipping_zones, b_and_q_list_shipping_methods y b_and_q_list_logistic_classes cambian raramente; léelos una vez por conversación.

Paginación: los pedidos, ofertas, facturas e importaciones de productos se paginan con max (máximo 100) y offset. Los hilos, devoluciones, transacciones, solicitudes de documentos e importaciones de ofertas devuelven un next_page_token; pásalo como page_token para obtener la siguiente página (todos los demás filtros se ignoran) hasta que falte.

Fechas son ISO 8601, por ejemplo 2026-10-01T00:00:00Z; las respuestas están en UTC.

Límites de tasa: Cada API tiene su propio límite y B&Q puede endurecerlos. Listar ofertas y pedidos está destinado a uso interactivo, las importaciones de productos y ofertas a lo sumo cada 15 minutos, b_and_q_get_account y las listas de referencia aproximadamente una vez al día. Un 429 lleva un encabezado Retry-After con los segundos a esperar; no intentes de nuevo en un bucle.

Errores: 401 significa que la clave es incorrecta o fue reemplazada por una más nueva, 403 que tu usuario no tiene el derecho para esta acción, 404 que el pedido, oferta o hilo no existe para esta tienda, 400 un parámetro incorrecto o un pedido en el estado incorrecto (el mensaje lo nombra, por ejemplo ORDER_INVALID_STATE).

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 — Agrega el conector en Claude

La URL de tu servidor: en AnythingMCP, abre MCP Servers → el servidor en el que está este conector, y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala dondequiera que esta guía muestre YOUR_SERVER_ID.

Ruta recomendada: funciona en claude.ai web sin editar ningún archivo de configuración.

1. En Claude, abre Personalizar → Conectores.
2. Haz clic en +, luego en Agregar conector personalizado.
3. Ingresa un nombre, por ejemplo Mercado de B&Q, y la URL del servidor MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, luego haz clic en Agregar.
4. 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 mensajes.

Herramientas disponibles

Ejemplos de mensajes

• "¿Qué pedidos de B&Q están esperando aceptación, y cuál es su valor total en GBP?"
• "Establece el stock de mi carrete de manguera de jardín SKU HR-30M a 40 en B&Q."
• "Marca el incidente en la línea 2 del pedido 7012345-A como resuelto; el cliente recibió los tornillos faltantes."
• "¿Cuáles de mis ofertas de B&Q no están activas, y qué razón da B&Q?"
• "Muestra las facturas que B&Q me emitió este trimestre con sus totales de comisiones."

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 obtengo la clave API de B&Q? En la oficina de vendedor de B&Q: tu nombre de usuario (arriba a la derecha), Mis configuraciones de usuario, Clave API, luego Generar una nueva clave (o copia la clave existente). Generar una nueva clave invalida la antigua. Se sabe que los vendedores en B&Q establecen el id de la tienda, también con una sola tienda. Con más de una tienda, establece B_AND_Q_SHOP_ID a la tienda en la que debe funcionar este conector.

¿Quién puede vender en B&Q, y qué países cubre? B&Q acepta solicitudes a través del Kingfisher Merchant Hub; el negocio debe estar registrado para el IVA. El conector cubre el Reino Unido. B&Q pertenece a Kingfisher, por eso la plataforma de vendedores está en una dirección de Kingfisher.

¿Puede cancelar pedidos, reembolsar o eliminar ofertas? Ninguna herramienta reembolsa o cancela un pedido; hazlo en la oficina de B&Q. Rechazar una línea al aceptar un pedido la cancela de forma definitiva, por lo que la IA te muestra cada escritura y espera un sí. b_and_q_import_offers se instala apagado, porque su modo REPLACE elimina cada oferta que falta en el archivo; actívalo en la página del conector solo si la IA debe usarlo.

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