Cómo conectar BricoBravo a Cursor vía MCP

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

BricoBravo + Cursor

Vende en BricoBravo, el marketplace italiano de bricolaje y hogar, desde un agente de IA: pedidos con artículos, totales, cliente y dirección de envío, filtrados por fecha. Confirmar el envío con transportista y seguimiento está incluido, desactivado al instalar.

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:

BRICOBRAVO_API_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva un par de minutos cuando ya tienes el token. Necesitas una cuenta de vendedor en BricoBravo, el marketplace italiano de bricolaje, hogar y jardín, y el token de API de su Seller Hub.

1. Consigue el token de API de tu tienda a través de BricoBravo: en el Seller Hub en sellerhub.bricobravo.com o desde el soporte para vendedores de BricoBravo.
2. Pégalo en BRICOBRAVO_API_TOKEN. Se envía en la cabecera sh-token, así que no añadas la palabra Bearer.
3. Instala el conector y ejecuta bricobravo_search_orders con per_page 1. Si devuelve un pedido, o una lista vacía en una tienda recién abierta, el token funciona.

Qué lee: tus pedidos de BricoBravo con el id del Seller Hub y el número de pedido del marketplace, estado, total, fecha de creación, artículos (EAN, código de producto, nombre, precio, precio de lista, cantidad), datos de facturación y los datos de envío del cliente y del destinatario (nombre, email, teléfono, calle, código postal, ciudad, provincia, país). La IA filtra los pedidos por fecha de creación y recorre las páginas, 100 por página de forma predeterminada.

Dos números de pedido: cada pedido tiene un id del Seller Hub (id_order) y un número del marketplace como 1234460505385-01. Para leer un pedido concreto la IA necesita el id del Seller Hub; con el número del marketplace BricoBravo responde con una lista de errores en lugar del pedido. Si solo tienes el número del marketplace, la IA busca primero el pedido en la lista.

Estados y horas: 0 pagado (por enviar), 1 completado, 2 por reembolsar, 3 reembolsado. Las horas están en hora italiana.

Pedidos ya importados: el conector pide todos los pedidos, también los que un sistema de gestión ya ha recogido, para que no falte ninguno en la lista.

Desactivada al instalar: bricobravo_mark_shipped. Confirma el envío de un pedido real con transportista, número de seguimiento y URL de seguimiento; si se vuelve a llamar sobre un pedido ya enviado, sustituye los datos de seguimiento, por ejemplo tras un segundo envío. Entre los transportistas están BRT, GLS Italy, SDA, Poste Italiane, TNT, DHL, UPS, FedEx, DPD y otros. Si tu sistema de gestión ya confirma los envíos, úsala solo para correcciones. Un administrador la activa de forma deliberada, y aun así la IA te muestra el pedido, el transportista y el seguimiento, espera tu sí y después vuelve a leer el pedido para comprobarlo.

Errores habituales: 401 token NOT valid significa un token incorrecto o revocado: pide uno nuevo a BricoBravo. 404 significa que BricoBravo no conoce la ruta o el pedido.

El conector no reembolsa ni cancela pedidos, no cambia productos, precios ni stock y no responde a los clientes.

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 BricoBravo.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué pedidos de BricoBravo están pagados pero aún sin enviar?"
• "Enséñame los pedidos de BricoBravo de los últimos 7 días con el total y la provincia de entrega."
• "Busca el pedido 1234460505385-01 y dime qué compró el cliente y adónde hay que enviarlo."
• "¿Qué pedidos están ahora mismo pendientes de reembolso?"
• "¿Cuánto vendimos en BricoBravo en septiembre y qué producto vendió más unidades?"

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