idealo über MCP mit Cursor verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → idealo klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

idealo + Cursor

Pflege die Angebote deines Shops im idealo-Preisvergleich aus einem KI-Agent über den Partner Web Service von idealo: Lies ein Angebot per SKU und lege mit deiner Freigabe Angebote an oder ersetze sie, ändere Preise, Lieferzeiten und Titel oder nimm Angebote heraus. Für Shops, die bei idealo gelistet sind.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

IDEALO_CLIENT_ID, IDEALO_CLIENT_SECRET, IDEALO_SHOP_ID

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 3 Minuten. Du brauchst einen Shop, der bei idealo gelistet ist (einen Händlervertrag mit idealo), und Zugang zu idealo Business.

1. Melde dich bei idealo Business an und öffne Shop settings → API clients (business.idealo.com/direct/shops/settings/api-clients).
2. Leg einen API-Client mit Zugriff auf den Partner Web Service an und kopiere seine Client ID und sein Client Secret. Das Secret wird nur einmal angezeigt; hast du es nicht mehr, legst du einen neuen Client an.
3. Füge die Client ID (eine UUID) in IDEALO_CLIENT_ID ein, das Secret in IDEALO_CLIENT_SECRET und deine numerische Shop-ID, die idealo Business anzeigt, in IDEALO_SHOP_ID. AnythingMCP tauscht die Client-Zugangsdaten gegen ein Access Token, das eine Stunde gilt, und erneuert es selbst.
4. Installiere den Connector und führe idealo_get_offer mit der SKU eines Angebots aus, von dem du weißt, dass es live ist: Du siehst das Angebot so, wie idealo es gespeichert hat.

Was er liest: jeweils ein Angebot per SKU, so wie idealo es speichert: Titel, Preis und Streichpreis, URL, EANs und Herstellernummern, Marke, Versand- und Zahlungskosten, Lieferzeit, Energielabels, Zustand und die übrigen Angebotsfelder. Der Partner Web Service hat keinen Listenaufruf, deshalb fragt dich die KI nach der SKU.

Nur Angebote, keine Bestellungen: Der Partner Web Service 2.0 ist die Schnittstelle, über die gelistete Shops ihre Angebote einzeln pflegen, statt oder neben der Produktdatei (dem Feed), für idealo.de, .at, .fr, .it, .es und .co.uk. idealo hat Direktkauf und die zugehörige Bestell-API 2023 eingestellt, Bestellungen kommen also weiter über deinen eigenen Shop.

So werden Angebote geschrieben: Preise sind Zeichenketten mit genau zwei Nachkommastellen und Punkt, etwa "177.99"; der Streichpreis ist der Preis vor einer Reduzierung. Ein neues Angebot braucht mindestens SKU, Titel, Preis, URL, eine Versandkostenangabe (zum Beispiel "DHL": "4.90") und eine Zahlungskostenangabe (zum Beispiel "PAYPAL": "0.00"); EANs, Herstellernummern und Marke helfen idealo, das Produkt richtig zuzuordnen. idealo_upsert_offer ersetzt das ganze Angebot, jedes nicht mitgeschickte Feld wird also entfernt. idealo_update_offer ändert nur die mitgeschickten Felder, kann aber Versand- und Zahlungskosten, Größe, Farbe, Geschlecht, Material und dynamische Produktattribute nicht ändern, und Listenfelder wie EANs oder Bilder müssen vollständig mitgeschickt werden. SKUs dürfen nur Buchstaben, Ziffern, Unterstriche, Punkte und Bindestriche enthalten.

Fragt vor jeder Änderung: Bei der Installation ist kein schreibendes Tool aktiv. Schaltet ein Administrator eines ein, zeigt dir die KI das Angebot mit altem und neuem Wert oder nennt dir die SKU, die sie herausnehmen würde, und wartet auf dein Ja, bevor etwas live geht.

Bei der Installation deaktiviert: idealo_upsert_offer, idealo_update_offer und idealo_delete_offer. idealo hat keine Testumgebung: Jeder Schreibzugriff ändert sofort deine Live-Angebote im Preisvergleich, und ein herausgenommenes Angebot verschwindet von idealo. Schalte nur die Tools ein, die die KI nutzen darf. Alle Angebote auf einmal zu löschen wird bewusst nicht angeboten.

Limits: idealo begrenzt die Zahl der Aufrufe; das aktuelle Limit steht im Header X-RateLimit-Limit. Nach einem 429 wartet die KI, bevor sie es erneut versucht, und sie ändert Angebote eins nach dem anderen.

Häufige Fehler: 401 heißt, Client ID oder Secret sind falsch oder das Token wurde abgelehnt: Prüf sie unter Shop settings → API clients. 403 heißt, dem API-Client fehlt das Recht für den Partner Web Service oder die Shop-ID gehört nicht zu dir. 404 heißt, das Angebot gibt es in diesem Shop nicht (falsche SKU oder Shop-ID). 400 listet fieldErrors mit Feld und Grund, zum Beispiel einen Preis ohne zwei Nachkommastellen.

Der Connector liest und bearbeitet keine Bestellungen, listet nicht alle deine Angebote auf, ändert deinen Produktfeed nicht und löscht nicht alle Angebote auf einmal.

Schritt 2 — Adapter installieren

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

Schritt 3 — Connector in Cursor hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

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

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die idealo-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Wie steht mein Angebot mit der SKU KS-4711 gerade bei idealo drin: Preis, Lieferzeit und Versandkosten?“
• „Senk den Preis für SKU TV-55-OLED auf 899,00 Euro und zeig 999,00 Euro als Streichpreis an.“
• „Ändere die Lieferzeit für SKU BOSCH-GSR18 auf 1-3 Werktage.“
• „Leg ein neues idealo-Angebot für SKU LAMPE-200 mit der EAN 4006381333931 an: 49,90 Euro, Versand mit DHL für 4,90 Euro und PayPal ohne Aufpreis.“
• „Nimm das Angebot mit der SKU KS-4711 bei idealo raus, der Artikel ist ausverkauft.“

FAQ

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden