Files
till 30c41c355e v2.3: Feature-Module live — Suche, Merkliste, Kundenkonten+Adressbuch, Bewertungen, Abandoned-Cart
- feature_search: Storefront-Header-Suche + /suche (SSR, SQLite LIKE, case-insensitiv; Name/Kurz/Desc/Material/Kategorie), Treffer als Karten, Leer-Zustand
- feature_wishlist: Herz-Button auf Karten/PDP (localStorage, public/wishlist.js) + /merkliste
- feature_accounts: getrennte Kunden-Session (Cookie hdc_customer, scrypt), /konto/registrieren|anmelden|abmelden, /konto (Bestellhistorie+Adressbuch), Tabelle customer_addresses, Checkout-Vorbefuellung + orders.customer_id-Zuordnung; Gast-Checkout bleibt
- feature_reviews: Tabelle reviews (1-5, Moderation), /api/review (approved=0), PDP-Anzeige Durchschnitt+Reviews + aggregateRating-JSON-LD, Admin /bewertungen (Freigeben/Verbergen/Loeschen) + Nav-Zaehler
- feature_abandoned_cart: Tabelle abandoned_carts, /api/cart-capture beim Checkout-Start, /api/cron/abandoned (CRON_TOKEN) sendet Erinnerungsmail (Mailer/Log) + reminded=1, recovered=1 bei Bestellung; Status in Einstellungen
- Gating: Flag aus => Storefront-Elemente weg, Routen 302/404, Admin-Nav-Punkt entfaellt; KEIN 'in Vorbereitung' mehr
- API/MCP: reviews CRUD + abandoned_carts (read) in admin-api + ai-admin.txt + MCP-Tools; Manifest v2.3
- README + .env.example (CRON_TOKEN, ABANDONED_AFTER_MINUTES); 16 neue Unit-Tests (Suche/Review-Avg/Kunden/Abandoned)
2026-06-18 07:27:34 +00:00
..

hd-commerce — MCP-Server

Ein Model Context Protocol-Server (stdio), mit dem ein LLM/Agent einen hd-commerce-Shop bearbeiten kann. Der Server ruft die token-gesicherte Admin-API (/api/admin/*) des Shops auf.

Voraussetzungen

  • Laufende hd-commerce-Instanz mit gesetztem HDC_API_TOKEN.
  • Node 18+ (für globales fetch).

Installation

cd mcp
npm install

Konfiguration (ENV)

Variable Beschreibung Beispiel
HDC_BASE_URL Basis-URL des Shops https://shop.example.com
HDC_API_TOKEN gleiches Token wie in der Shop-Instanz geheimes-token

Tools

Tool Zweck
list_products / get_product / upsert_product / delete_product Produkte verwalten
list_pages / get_page / create_page Seiten lesen/anlegen
update_page_blocks Block-Struktur einer Seite (Visual-Builder) setzen
list_slides / upsert_slide Slider verwalten
list_orders Bestellungen lesen
get_settings / update_settings Shop-Einstellungen (Name, Farben …)
get_manifest Vollständiges API-Manifest

In Claude Desktop / Cowork registrieren

claude_desktop_config.json (bzw. die MCP-Konfiguration):

{
  "mcpServers": {
    "hd-commerce": {
      "command": "node",
      "args": ["/absoluter/pfad/zu/hd-commerce/mcp/server.js"],
      "env": {
        "HDC_BASE_URL": "https://shop.example.com",
        "HDC_API_TOKEN": "geheimes-token"
      }
    }
  }
}

Danach den Client neu starten. Der Server meldet sich als hd-commerce mit obigen Tools.

Schneller Start-Check

HDC_BASE_URL=http://localhost:4321 HDC_API_TOKEN=testtoken node server.js
# Gibt auf stderr "bereit" aus und wartet auf stdio-Anfragen (mit Ctrl-C beenden).