Files
hd-commerce/mcp
till aec179db36 v2: Session-Login & Rollen, Premium-Admin, Visual-Block-Builder, KI-/MCP-API
- Auth-Umbau: Session-Login (signiertes HMAC-Cookie, scrypt-Hashing) statt Basic-Auth;
  users-/audit-Tabellen, Initial-Owner aus ENV, Rate-Limit, konfigurierbarer ADMIN_PATH
  (Middleware-Rewrite), Rollen-Gate (owner/redaktion/versand), Nutzerverwaltung, Audit-Log,
  Login/Logout/Konto-Seiten.
- Premium-Pass: Command-Palette (Cmd-K), Toasts, Account-Menue, aufgewertetes Dashboard
  (KPI-Trend+Sparkline, Aktivitaets-Feed, Schnellaktionen), schoene Empty-States.
- Block-Builder: pages.blocks, Vollbild-Editor (Liste/Live-Vorschau/Settings, Desktop/Mobil),
  10 Block-Typen, Storefront-BlockRenderer auf /seite/[slug], Save-Endpoint.
- KI-Editierbarkeit: token-gesicherte /api/admin/* (CRUD), Manifest /api/admin + /ai-admin.txt,
  MCP-Server unter mcp/ (14 Tools).
- Docs: README + .env.example + mcp/README aktualisiert.
2026-06-17 12:46:31 +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).