Cómo conectar idealo a Gemini 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 + Gemini

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 Gemini

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.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de idealo.

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 busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

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