Kroger MCP-Server

Integriert die öffentliche API von Kroger mit Claude, sodass Mahlzeiten-Einkaufslisten direkt zum Kroger-Warenkorb hinzugefügt werden können.

Tools

Related MCP server: Grocery Logger MCP Server

Einrichtung

Schritt 1 — Registrieren Sie Ihre App im Kroger Developer Portal

1. Gehen Sie zu https://developer.kroger.com

2. Klicken Sie auf Register App

3. Füllen Sie Folgendes aus:

   • App Name: Meal Plan Assistant (oder ein beliebiger Name)

   • Redirect URI: http://localhost:8080/callback

   • Scopes: product.compact, cart.basic:write, profile.compact

4. Kopieren Sie Ihre Client ID und Ihr Client Secret

Schritt 2 — Abhängigkeiten installieren

cd kroger_mcp
python3 -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate
pip install -r requirements.txt

Schritt 3 — Umgebungsvariablen festlegen

export KROGER_CLIENT_ID=your_client_id_here
export KROGER_CLIENT_SECRET=your_client_secret_here
export KROGER_REDIRECT_URI=http://localhost:8080/callback

Fügen Sie diese Ihrem Shell-Profil hinzu (~/.zshrc oder ~/.bashrc), damit sie dauerhaft gespeichert bleiben.

Schritt 4 — Mit Claude verbinden

Fügen Sie dies Ihrer Claude MCP-Konfiguration hinzu (normalerweise ~/Library/Application Support/Claude/claude_desktop_config.json auf dem Mac):

{
  "mcpServers": {
    "kroger": {
      "command": "/path/to/kroger_mcp/venv/bin/python",
      "args": ["/path/to/kroger_mcp/server.py"],
      "env": {
        "KROGER_CLIENT_ID": "your_client_id",
        "KROGER_CLIENT_SECRET": "your_client_secret",
        "KROGER_REDIRECT_URI": "http://localhost:8080/callback"
      }
    }
  }
}

Starten Sie Claude Desktop nach dem Speichern neu.

Erste Verwendung — OAuth-Anmeldung

Wenn Sie Claude zum ersten Mal bitten, Artikel in Ihren Warenkorb zu legen:

1. Ihr Browser öffnet die Anmeldeseite von Kroger

2. Melden Sie sich mit Ihrem Kroger-Konto an

3. Fügen Sie die Redirect-URL zurück in das Terminal ein

4. Fertig — die Tokens werden unter ~/.kroger_mcp_tokens.json gespeichert

Danach kann Claude mithilfe des gespeicherten Refresh-Tokens im Hintergrund Artikel zu Ihrem Warenkorb hinzufügen.

Beispiel-Ablauf

Sobald die Verbindung hergestellt ist, können Sie zu Claude sagen:

"Finde meine nächste Kroger-Filiale und füge die Einkaufsliste für diese Woche zu meinem Warenkorb hinzu"

Claude wird:

1. kroger_find_store mit Ihrer Postleitzahl aufrufen

2. kroger_add_grocery_list mit allen Artikeln aufrufen

3. Rückmeldung geben, was hinzugefügt wurde, was übersprungen wurde und ob Probleme aufgetreten sind

Sicherheitshinweise

• Ihre Client ID und Ihr Secret gehören Ihnen — registriert unter Ihrem Konto

• Tokens werden lokal unter ~/.kroger_mcp_tokens.json gespeichert (Berechtigungen: 600)

• Kein Code von Drittanbietern involviert — direkte Aufrufe der offiziellen API von Kroger

• kroger_clear_auth entfernt bei Bedarf alle gespeicherten Tokens

Fehlerbehebung

"Missing environment variables" — Legen Sie KROGER_CLIENT_ID und KROGER_CLIENT_SECRET fest

"Authorization expired" — Wiederholen Sie den Vorgang; der Server aktualisiert sich automatisch

"No matching product found" — Versuchen Sie einen kürzeren Suchbegriff (z. B. "spinach" statt "Private Selection Baby Spinach")

Ratenbegrenzungen (HTTP 429) — Kroger begrenzt Anfragen; warten Sie 30 Sekunden und versuchen Sie es erneut