# hd-commerce — MCP-Server

Ein [Model Context Protocol](https://modelcontextprotocol.io)-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

```bash
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):

```json
{
  "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

```bash
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).
```