Entwickler-Handbuch: KI-Agenten treffen auf Echtzeit-Lebensmitteldaten via MCP

KI-Assistenten wie Claude, ChatGPT und maßgeschneiderte Python-Agenten sind hervorragend im logischen Denken – aber sie sind blind für die physische Welt. Sie können dir nicht sagen, ob der Aldi in Schwabing gerade Bio-Olivenöl im Angebot hat oder ob sich der Umweg zu Lidl wegen der zusätzlichen 12 Minuten auf dem Fahrrad wirklich lohnt.

Offer Hopper schließt diese Lücke. Indem wir unseren Einkaufsrouten-Optimierer als Model Context Protocol (MCP) Server bereitstellen, kannst du jedem MCP-kompatiblen KI-Agenten Live-Zugriff geben auf:

• Echtzeit-Preise und Angebote von Aldi, Lidl, Rewe, Edeka, Penny, Norma, Netto, DM, Rossmann und Müller
• Filialstandorte und Öffnungszeiten in deiner Nähe
• KI-optimierte Routen für mehrere Geschäfte, die Fahrtzeit, Fahrt-/Fahrradkosten und die tatsächliche Ersparnis abwägen
• Eine teilbare interaktive Karte des Ergebnisses

TL;DR / Schnellstart

Für die schnelle Verbindung zum MCP-Server von Offer Hopper verwende bitte die folgenden Verbindungsparameter:

• MCP-Server-URL: https://mcp.offerhopper.ai/mcp
• Authentifizierung: Keine (kein API-Key erforderlich)
• Verfügbare Tools: find_grocery_deals

Dieses Handbuch führt dich durch die Einrichtung für Claude Desktop, ChatGPT (Entwicklermodus), OpenClaw und reines Python / curl – plus einen Abschnitt darüber, was du von der Tool-Antwort erwarten kannst und wie du effektive Prompts schreibst.

Was ist MCP und warum ist es hier wichtig?

Das Model Context Protocol ist ein offener Standard (ursprünglich von Anthropic entwickelt, inzwischen breit akzeptiert), der definiert, wie KI-Clients externe Tools entdecken und aufrufen. Anstatt Preise von einer Website manuell in deinen Chat zu kopieren, kann ein MCP-fähiger Agent das Tool find_grocery_deals direkt aufrufen, strukturierte JSON-Daten empfangen und darüber nachdenken – alles in einem einzigen Konversationsschritt.

Für Offer Hopper bedeutet das konkret:

• Kein Scraping oder Polling auf deiner Seite – der MCP-Server übernimmt alle Händlerabfragen
• Keine halluzinierten Preise – der Agent erhält verifizierte Live-Daten
• Strukturierte Ausgabe – Warenkorbpreis, Aufschlüsselung pro Geschäft, Routennachteil (Zeit-/Weg-Strafe) und eine share_url, die du anklicken kannst, um die interaktive Karte zu öffnen

Der Offer Hopper MCP-Server-Endpunkt lautet:

https://mcp.offerhopper.ai/mcp

Er verwendet den Streamable-HTTP-Transport (den aktuellen Standard der MCP-Spezifikation für Remote-Server). Für Desktop-Clients, die nur stdio unterstützen, wird supergateway as lokaler Tunnel verwendet – erklärt im Abschnitt für Claude Desktop weiter unten.

Unterstützte KI-Plattformen

1 App konfigurieren 2 Testen

Schritt 1: Konfiguriere deine KI-App

Wähle deine bevorzugte KI-Anwendung oder -Plattform aus, um die MCP-Integration von Offer Hopper zu konfigurieren:

Claude Desktop Claude.ai (Web) ChatGPT OpenClaw Python

1. Einstellungen öffnen

Klicke unten links auf dein Profilbild und öffne die Settings (Einstellungen).

2. Konfiguration bearbeiten

Klicke auf Developer und wähle dann Edit Config.

3. Konfigurationsdatei anpassen

Fügen Sie Folgendes zur Datei claude_desktop_config.json hinzu:

Windows:

{
  "mcpServers": {
    "offerhopper.ai": {
      "command": "cmd",
      "args": [
        "/C",
        "npx -y supergateway --sessionTimeout 180000 --streamableHttp https://mcp.offerhopper.ai/mcp"
      ]
    }
  }
}

macOS / Linux:

{
  "mcpServers": {
    "offerhopper.ai": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--sessionTimeout", "180000",
        "--streamableHttp", "https://mcp.offerhopper.ai/mcp"
      ]
    }
  }
}

Diese Konfiguration verwendet das Tool supergateway, um den streambaren HTTP-Endpunkt in das von Claude Desktop geforderte stdio-Protokoll umzuleiten.

Claude.ai Web & Mobile App Setup

Die Claude.ai Web- und Mobil-Apps unterstützen Remote-MCP-Connectors nativ – kein supergateway erforderlich.

1. Gehe zu Settings → Integrations (Einstellungen → Integrationen) oder zum MCP-Connectors-Panel.
2. Füge einen neuen Connector mit der Server-URL hinzu: https://mcp.offerhopper.ai/mcp
3. Setze die Authentifizierung auf None.
4. Speichern — das Tool find_grocery_deals ist jetzt in all deinen Chats verfügbar.

1. Einstellungen öffnen

Klicke unten links auf dein Profilbild und öffne die Settings (Einstellungen).

2. Entwicklermodus aktivieren

Gehe im linken Menü auf Apps, aktiviere den Schalter Developer mode und klicke oben auf die Schaltfläche Create app.

3. Verbindungsdetails hinzufügen

Trage im Modal New App die folgenden Verbindungsdetails ein. Du kannst jedes Feld über die Kopieren-Schaltflächen direkt kopieren:

Name

offerhopper.ai

Description (Beschreibung)

Tool for grocery trip planning in Germany, including real-time prices from Aldi, Rewe, DM, Müller as well as deals from Lidl, Norma, Netto, etc.

Connection (Server URL / Verbindung)

https://mcp.offerhopper.ai/mcp

Wähle als Authentifizierungsmethode No Auth, aktiviere das Kontrollkästchen I understand and want to continue (Ich verstehe und möchte fortfahren) und klicke auf Create.

OpenClaw-Plugin-Integration

OpenClaw unterstützt die native Integration von Offer Hopper über ClawHub. Du kannst das verifizierte Plugin direkt über die OpenClaw-CLI installieren:

openclaw plugins install clawhub:offerhopper.ai

Dieses Plugin registriert das Tool find_grocery_deals nativ auf deinem OpenClaw-Agenten zur sofortigen Verwendung ohne manuelle Konfiguration. Es sind keine zusätzlichen Serverschemata erforderlich.

Weitere Details, Sicherheitsaudits und die Dokumentation findest du auf der offiziellen ClawHub-Plugin-Seite.

Python-Integration einrichten

Wenn du einen eigenen Agenten entwickelst, kannst du den MCP-Server direkt über HTTP unter Verwendung des JSON-RPC 2.0-Protokolls aufrufen.

Zuerst installierst du die Abhängigkeiten:

pip install httpx

Verwende dann den folgenden Code, um das Tool aufzurufen:

import httpx, json

MCP_URL = "https://mcp.offerhopper.ai/mcp"

payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "find_grocery_deals",
        "arguments": {
            "items": "pasta, organic olive oil, 500g salmon",
            "location": "80331",          # PLZ München Hauptbahnhof
            "travel_mode": "bicycle",
            "max_radius_km": 5,
            "hour_cost": 12.0
        }
    }
}

with httpx.Client(timeout=60) as client:
    # MCP Streamable HTTP: Zuerst Session initialisieren
    init = client.post(MCP_URL, json={
        "jsonrpc": "2.0", "id": 0,
        "method": "initialize",
        "params": {"protocolVersion": "2025-03-26", "clientInfo": {"name": "my-agent", "version": "1.0"}}
    })
    session_id = init.headers.get("mcp-session-id")

    headers = {"mcp-session-id": session_id} if session_id else {}
    response = client.post(MCP_URL, json=payload, headers=headers)
    result = response.json()
    print(json.dumps(result, indent=2, ensure_ascii=False))

Nächster Schritt: Testen

Schritt 2: Teste die Integration

Teste nun deine Einrichtung. Kopiere die folgende Anfrage und füge sie direkt in das Chat-Fenster von Claude ein:

Plane mit offerhopper.ai einen Einkauf, um Nudeln, Bio-Olivenöl und 500g Lachs zu kaufen, beginnend am Hauptbahnhof München (PLZ 80331). Ich fahre mit dem Fahrrad.

Dein Agent ruft das Tool find_grocery_deals auf. Es übernimmt das Geocoding, fragt die Live-Preise ab, berechnet die TPSO-Route und gibt eine detaillierte Aufstellung aus – inklusive Fahrtkosten, Gesamtkorbpreis und dem share_url Link zur interaktiven Karte.

Vorheriger Schritt Alles bereit!

Tool-Referenz: find_grocery_deals

Tipp: Der Parameter hour_cost ist die wichtigste Einstellschraube. Setze ihn niedrig (1–3), wenn du Zeit hast und maximale Ersparnis wünschst; setze ihn hoch (20–30), wenn Zeit Geld ist und du den schnellsten Einkaufsplan bei möglichst nur einem Geschäft bevorzugst. Lies hier mehr darüber, wie du den Wert deiner Zeit für Supermarkt-Angebote richtig berechnest.

Prompt-Muster, die gut funktionieren

Diese Prompts sind verlässliche Startpunkte — passe sie für deinen Anwendungsfall an:

Wocheneinkauf mit Budget-Fokus

Ich muss kaufen: 2L Vollmilch, 6 Eier, 500g Rinderhackfleisch, 1kg Kartoffeln, griechischen Joghurt und ein Paket Spaghetti. Start am Hauptbahnhof Trier, mit dem Auto. Priorisiere Ersparnisse vor Geschwindigkeit.

Schnelle Erledigung zu Fuß

Ich brauche nur Brot und Butter. Ich bin am Hauptbahnhof Köln und gehe zu Fuß. Was ist die nächste und günstigste Option?

Pendelstrecke (Korridor-Trip)

Ich pendle jeden Morgen mit dem Auto vom Hauptbahnhof Potsdam nach Berlin Mitte. Findest du den besten Ort, um auf dem Weg Kaffee, Milch und eine Banane zu besorgen?

Reiner Preisvergleich

Was kostet 1kg Bio-Äpfel aktuell bei Rewe, Aldi und Edeka in der Nähe der PLZ 10115 (Berlin Mitte)?

Häufig gestellte Fragen (FAQ)

Benötigt der MCP-Server einen API-Key? Nein. Der MCP-Endpunkt von Offer Hopper ist derzeit offen und erfordert keine Authentifizierung. Dies kann sich ändern, wenn die Nutzung steigt – prüfe diese Seite für Updates.

Ist dies für die kommerzielle Nutzung oder Produktion geeignet? Offer Hopper ist ein nicht-kommerzielles Hobbyprojekt. Automatisierte Abfragen sind gemäß den Nutzungsbedingungen nicht gestattet. Die MCP-Integration ist für die private Nutzung durch KI-Assistenten gedacht, nicht für den Aufbau kommerzieller Datenpipelines.

Welche Händler werden abgedeckt? Derzeit: Aldi, Lidl, Rewe, Edeka, Penny, Norma, Netto, DM, Rossmann und Müller – nur in Deutschland.

Wie aktuell sind die Preisdaten? Preise werden zum Abfragezeitpunkt live aus den öffentlich zugänglichen Angeboten der Händler abgerufen. Wöchentliche Angebotszyklen (z. B. Angebote ab Donnerstag bei Aldi) spiegeln sich in Echtzeit wider.

Was passiert, wenn meine Stadt nicht erkannt wird? Gib eine Postleitzahl statt eines Stadtnamens an, um die zuverlässigsten Ergebnisse zu erhalten. Die 5-stelligen deutschen Postleitzahlen funktionieren am besten.

Kann ich dies mit LangChain oder LlamaIndex verwenden? Ja — beide Frameworks unterstützen MCP-Tool-Aufrufe über ihre jeweiligen MCP-Client-Integrationen. Verwende https://mcp.offerhopper.ai/mcp als Server-URL in deiner Tool-Konfiguration.

Fazit

Die MCP-Integration von Offer Hopper bietet jedem MCP-kompatiblen KI-Agenten eine direkte Live-Verbindung zu deutschen Lebensmittelpreisen und Routenoptimierungen in einem einzigen Tool-Aufruf. Das LLM übernimmt das logische Denken und die Kommunikation mit dem Nutzer; Offer Hopper übernimmt die schwierigen Teile: Scraping, Geocodierung und Routenoptimierung über mehrere Geschäfte hinweg.

Egal, ob du einen persönlichen Haushaltsassistenten, einen sparsamen Einkaufs-Chatbot baust oder einfach nur möchtest, dass dein Claude- oder ChatGPT-Setup wirklich nützliche Einkaufstipps gibt – diese Integration ist der schnellste Weg von „Was kaufe ich wo am besten?“ zu einer echten, optimierten Antwort.