Cómo conectar BricoBravo a Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de BricoBravo.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, 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

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse