till
e5514dd5da
- payments.js: einheitliche createPayment/Webhook-Schnittstelle (Mollie Default, Stripe, Demo); Auto-Provider-Wahl; Mollie-REST + /api/payments/webhook (idempotent); Fake-Key => sauberer Demo-Fallback - mailer.js: sendMail via Listmonk-Tx / SMTP (nodemailer) / Log-Fallback (email_log); gebrandete Bestellbestaetigung bei paid - DACH: products.mwst + base_amount/base_unit/base_price_per (Grundpreis); Storefront/Warenkorb/Checkout/Erfolg/Admin mit MwSt-Ausweis + Versand-Transparenz; tax_cents/shipping_cents/country an Orders - shipping_zones-Tabelle + CRUD + shippingFor(); Admin 'Versand'; serverseitige Versandberechnung in /api/checkout + /api/shipping-quote (Laenderwahl live) - Feature-Flags (feature_*) + feature()-Helper; Admin Module-Toggles; Newsletter-Gating (Popup/Subscribe) - Admin-API/Manifest/ai-admin.txt um shipping_zones erweitert; MCP list/upsert/delete_shipping; README/.env.example ergaenzt; Version 2.2.0
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).