Cómo conectar idealo a Meta Muse vía MCP

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

idealo + Meta Muse

Gestiona las ofertas de tu tienda en el comparador de precios idealo desde un agente de IA a través del Partner Web Service de idealo: consulta una oferta por SKU y, con tu aprobación, crea o reemplaza ofertas, cambia precios, plazos de entrega y títulos, o retira ofertas. Para tiendas que aparecen en idealo.

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:

IDEALO_CLIENT_ID, IDEALO_CLIENT_SECRET, IDEALO_SHOP_ID

Paso 1 — Obtener credenciales

La configuración lleva unos 3 minutos. Necesitas una tienda que aparezca en idealo (un contrato de comerciante con idealo) y acceso a idealo Business.

1. Inicia sesión en idealo Business y abre Shop settings → API clients (business.idealo.com/direct/shops/settings/api-clients).
2. Crea un cliente de API con acceso al Partner Web Service y copia su client ID y su client secret. El secret solo se muestra una vez; si ya no lo tienes, crea un cliente nuevo.
3. Pega el client ID (un UUID) en IDEALO_CLIENT_ID, el secret en IDEALO_CLIENT_SECRET y tu shop ID numérico, que aparece en idealo Business, en IDEALO_SHOP_ID. AnythingMCP cambia las credenciales del cliente por un token de acceso que dura una hora y lo renueva por sí mismo.
4. Instala el conector y ejecuta idealo_get_offer con el SKU de una oferta que sepas que está publicada: ves la oferta tal como la guarda idealo.

Qué lee: una oferta cada vez por su SKU, tal como la guarda idealo: título, precio y precio anterior, URL, EAN y referencias del fabricante, marca, costes de envío y de pago, plazo de entrega, etiquetas energéticas, estado y el resto de campos de la oferta. El Partner Web Service no tiene una llamada de listado, así que la IA te pide el SKU.

Solo ofertas, sin pedidos: el Partner Web Service 2.0 es la interfaz con la que las tiendas que aparecen en idealo gestionan sus ofertas una a una, en lugar del feed de productos o junto a él, para idealo.de, .at, .fr, .it, .es y .co.uk. idealo cerró en 2023 su servicio de pago (Direktkauf) y su API de pedidos, así que los pedidos siguen llegando por tu propia tienda.

Cómo se escriben las ofertas: los precios son cadenas con exactamente dos decimales y punto, como "177.99"; el precio anterior es el de antes de una rebaja. Una oferta nueva necesita como mínimo SKU, título, precio, URL, un coste de envío (por ejemplo "DHL": "4.90") y un coste de pago (por ejemplo "PAYPAL": "0.00"); los EAN, las referencias del fabricante y la marca ayudan a idealo a asociar el producto. idealo_upsert_offer reemplaza la oferta entera, de modo que se elimina cualquier campo no enviado; idealo_update_offer cambia solo los campos enviados, pero no puede modificar costes de envío y de pago, talla, color, género, material ni atributos dinámicos del producto, y los campos de lista como los EAN o las imágenes deben enviarse completos. Los SKU solo pueden contener letras, cifras, guiones bajos, puntos y guiones.

Pregunta antes de cada cambio: al instalar no hay ninguna herramienta de escritura activa. Cuando un administrador activa una, la IA te muestra la oferta con el valor antiguo y el nuevo, o te indica el SKU que retiraría, y espera tu sí antes de que nada se publique.

Desactivadas al instalar: idealo_upsert_offer, idealo_update_offer y idealo_delete_offer. idealo no tiene entorno de pruebas, así que cada escritura cambia al momento tus ofertas publicadas en el comparador, y una oferta retirada desaparece de idealo. Activa solo las que la IA pueda usar. Borrar todas las ofertas de golpe no se ofrece, a propósito.

Límites: idealo limita el número de llamadas; el límite actual aparece en la cabecera X-RateLimit-Limit. Tras un 429 la IA espera antes de reintentar, y cambia las ofertas de una en una.

Errores frecuentes: 401 significa que el client ID o el secret son incorrectos o que se rechazó el token: revísalos en Shop settings → API clients. 403 significa que el cliente de API no tiene el permiso del Partner Web Service o que el shop ID no es tuyo. 404 significa que la oferta no existe en esta tienda (SKU o shop ID incorrectos). 400 lista los fieldErrors con el campo y el motivo, por ejemplo un precio sin dos decimales.

El conector no lee ni gestiona pedidos, no lista todas tus ofertas, no cambia tu feed de productos ni borra todas las ofertas de golpe.

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

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

• "¿Cómo aparece ahora en idealo mi oferta con SKU KS-4711: precio, plazo de entrega y gastos de envío?"
• "Baja el precio del SKU TV-55-OLED a 899,00 euros y muestra 999,00 euros como precio anterior."
• "Cambia el plazo de entrega del SKU BOSCH-GSR18 a 1-3 días laborables."
• "Crea una oferta nueva en idealo para el SKU LAMPARA-200 con EAN 4006381333931: 49,90 euros, envío con DHL por 4,90 euros y PayPal sin recargo."
• "Retira de idealo la oferta con SKU KS-4711, el artículo está agotado."

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