Cómo conectar Fruugo a Microsoft Copilot vía MCP

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

Fruugo + Microsoft Copilot

Vende en el marketplace Fruugo desde un agente de IA: descarga pedidos con líneas, precios al cliente, dirección de envío y envíos, y consulta la disponibilidad y el stock de tus SKU. Confirmar y enviar pedidos 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:

FRUUGO_USERNAME, FRUUGO_PASSWORD

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de vendedor en Fruugo y un usuario del Fruugo Retailer Portal.

1. Inicia sesión en el Fruugo Retailer Portal en retailer.fruugo.com. Fruugo recomienda un usuario del portal aparte para la integración, así que crea uno para AnythingMCP si puedes.
2. Pon el nombre de ese usuario del portal en FRUUGO_USERNAME y su contraseña en FRUUGO_PASSWORD. Fruugo los comprueba con HTTP Basic en cada llamada.
3. Instala el conector y ejecuta fruugo_download_orders con una fecha from de hace unos días.

Qué lee: los pedidos que Fruugo te ha liberado tras sus controles antifraude, con id de pedido y de pedido del cliente, fechas, estado, idioma del cliente, dirección y método de envío, coste de envío, líneas con los ids de producto y SKU de Fruugo y los tuyos, tus precios y los que vio el cliente en su moneda, IVA, contadores de artículos (pendientes, confirmados, enviados, cancelados, devolución anunciada, devueltos) y envíos; y tus SKU activos con título, disponibilidad (INSTOCK, OUTOFSTOCK, NOTAVAILABLE) y unidades en stock cuando tu feed las incluye. Cuando Fruugo ha cobrado los impuestos, el pedido trae también el número fiscal y el EORI de Fruugo para la declaración de aduanas.

Como máximo 60 días por consulta: Fruugo lista pedidos en una ventana de 60 días como máximo; una más larga responde 400 Time range specified is too long. Para un trimestre entero, la IA consulta en dos partes y suma los resultados.

Estado del pedido: PENDING significa nuevo y pendiente de ti, PROCESSED al menos en parte gestionado, EXCEPTION que Fruugo gestiona el pedido a mano, fuera de la API.

El stock viene de tu feed: la lista de stock llega en páginas de 1.000 SKU, y la IA solo lee más páginas si las necesitas. El conector no cambia ni el stock ni los precios: vienen de tu feed de productos.

Desactivadas al instalar: fruugo_confirm_order y fruugo_ship_order. Actúan sobre pedidos reales de clientes: la primera confirma un pedido pendiente, si quieres con una fecha de envío estimada; la segunda lo marca como enviado con el código de seguimiento y la URL de seguimiento o al menos el nombre del transportista, que Fruugo comunica al cliente. Ambas sirven para un pedido entero o para un solo artículo. Un administrador las activa de forma deliberada, y aun así la IA te muestra el pedido y exactamente qué va a cambiar, y espera tu sí.

Errores habituales: 401 significa usuario o contraseña del portal incorrectos; compruébalos iniciando sesión en retailer.fruugo.com. 400 explica el problema en texto claro, por ejemplo una ventana de más de 60 días o un pedido que no está en el estado adecuado.

El conector no cancela pedidos ni registra devoluciones, porque ambas cosas reembolsan al cliente: hazlas en el Retailer Portal. Tampoco cambia anuncios, precios ni stock.

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 Fruugo.
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 Fruugo de las últimas dos semanas siguen pendientes y hay que enviar?"
• "¿Cuántos pedidos de Fruugo recibimos en los últimos 30 días y a qué países fueron?"
• "¿Qué SKU míos aparecen ahora mismo sin stock en Fruugo?"
• "Enséñame los pedidos de la semana pasada con lo que pagó el cliente en su moneda y el IVA de cada línea."
• "¿En qué pedidos desde el 1 de septiembre se cancelaron o devolvieron artículos?"

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