Conectar ManoMano MCP con Microsoft Copilot

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

ManoMano + Microsoft Copilot

Vende en ManoMano, el marketplace europeo de bricolaje y jardín, desde un agente IA: pedidos con aceptación, envío y reembolsos, precios y stock de tus ofertas, competitividad frente a otros vendedores, búsquedas en el catálogo por EAN, stock de ManoFulfillment y facturas a clientes. Una instalación por contrato de vendedor.

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:

MANOMANO_API_KEY, MANOMANO_SELLER_CONTRACT_ID

Paso 1 — Obtener credenciales

1. Inicia sesión en la ManoMano Toolbox en https://toolbox.manomano.com con un usuario que tenga el rol Admin.
2. Abre Settings > API keys, haz clic en Create API key, ponle un nombre como AnythingMCP y haz clic en Generate API key. Copia la clave en ese momento: ManoMano la muestra una sola vez. Pégala en MANOMANO_API_KEY.
3. Escribe el id de tu contrato de vendedor en MANOMANO_SELLER_CONTRACT_ID. Es un número que aparece en la Toolbox, por ejemplo 110841.
4. Instala el conector y empieza con manomano_list_orders.

Una instalación por contrato: ManoMano crea un contrato de vendedor por plataforma (manomano.fr, .es, .it, .de y .co.uk) y modalidad de entrega, así que quien vende en varias plataformas tiene varios contratos. Instala el conector una vez por contrato y ponle a cada instalación el nombre del contrato, por ejemplo ManoMano ES. El id del contrato se añade a cada llamada y la clave solo se envía a ManoMano.

Flujo de pedidos: un pedido nuevo está en PENDING. Al aceptarlo pasa a PREPARATION; al rechazarlo se reembolsa al cliente (REFUNDING y después REFUSED). El envío registra el transportista, el número y la URL de seguimiento y los productos del paquete, una vez por paquete, y el pedido pasa a SHIPPED. Un reembolso cubre algunos o todos los productos (REFUNDING y después REFUNDED). Para la lista de tareas del día, la IA muestra los pedidos en PENDING y en PREPARATION, y lee el pedido antes de enviarlo o reembolsarlo, porque ambas operaciones necesitan el seller_sku y la cantidad de cada producto.

Confirma primero: aceptar, rechazar, enviar y reembolsar pedidos, cambiar, descongelar y reemplazar ofertas y subir facturas actúan sobre el marketplace real. Antes de cada una de estas acciones, la IA te muestra qué va a cambiar (el pedido, los productos y cantidades, el número de seguimiento, los SKU con el precio o stock anterior y el nuevo, el documento) y espera tu sí. Los rechazos y los reembolsos no se pueden deshacer.

Precios y stock: manomano_update_offers cambia el precio, el stock o ambos de SKU existentes. Por defecto los nuevos valores quedan congelados, de modo que las importaciones posteriores de tu feed de productos ya no los sobrescriben, hasta que manomano_unfreeze_offers los devuelve al feed. ManoMano aplica el cambio en segundo plano: la IA lo comprueba con manomano_list_offers y el request_id devuelto (IN PROGRESS, ERROR con los errores o COMPLETED). manomano_upsert_offers, que crea ofertas o las reemplaza por completo, está desactivado al instalar.

Competencia, catálogo y fulfillment: compara los SKU que elijas con la mejor oferta del producto, o lista todas las ofertas cuya situación competitiva cambió en un rango de fechas. Consulta hasta 200 EAN a la vez para saber si un producto ya está en el catálogo de ManoMano y si puedes publicar una oferta en él. El stock del almacén de ManoFulfillment solo está disponible con un contrato ManoFulfillment.

Facturas a clientes: la IA lista las facturas que los clientes están esperando, empezando por la solicitud más antigua. Tienes 3 días hábiles desde el envío para entregarla. La IA sube el PDF desde una URL; cada documento se suma a los anteriores y el cliente recibe un aviso.

Límites: unas 250 solicitudes por hora a la API de pedidos y 200 a la de ofertas, por clave API; por encima de eso ManoMano responde 429. Los pedidos llegan en páginas de 50 como máximo. El conector trabaja con la API real, no con el sandbox de ManoMano.

Errores habituales: 401 significa que ManoMano rechazó la clave: revísala o crea una nueva en la Toolbox (una clave eliminada deja de funcionar al instante). 403: la clave funciona pero no puede actuar sobre este contrato; comprueba que el id del contrato pertenezca a la cuenta de vendedor que creó la clave. 400: comprueba que el id del contrato sea tu id numérico de contrato de vendedor. 429: demasiadas solicitudes; espera antes de volver a intentarlo.

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 ManoMano.
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 ManoMano siguen pendientes y qué pedidos en preparación tienen más de dos días?"
• "Envía el pedido M240915123 con Correos Express, número de seguimiento 3230012345678901, todos los productos en un solo paquete."
• "Pon el precio del SKU DRILL-18V en 89,90 euros y su stock en 25, y luego comprueba que la actualización se ha aplicado."
• "¿Soy la mejor oferta de ManoMano en estos cinco SKU? Muéstrame quién me supera y a qué precio."

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