Cómo conectar BricoBravo a Meta Muse 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 + Meta Muse

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 Muse

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.

Muse añade los servidores MCP remotos como conectores personalizados e inicia sesión en ellos con OAuth.

1. En Muse, abre Settings → Connectors y elige Add custom connector.
2. Pega la URL del servidor MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse abre la página de inicio de sesión de AnythingMCP: inicia sesión y aprueba el acceso.
4. En un chat, pídele a Muse algo que necesite las herramientas de BricoBravo.

También puedes configurarlo desde un chat, en la web, en las apps de iOS y Android o en WhatsApp. Envía a Muse este mensaje:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Muse se conecta desde la nube de Meta, así que localhost no funciona.

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

¿Dónde está disponible Muse? Por ahora Meta ofrece Muse en Estados Unidos y Canadá, en la web, en las apps de iOS y Android y en WhatsApp.

¿Meta revisa este conector? No. Meta no revisa los conectores personalizados. Muse solo ve las herramientas que activaste para este servidor MCP en AnythingMCP, y puedes desconectarlo cuando quieras en Settings → Connectors.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT