# Klarbild MCP-Server

Erlaubt einem KI-Assistenten (z. B. Claude), Bilder an Klarbild zu übergeben und dort zu
verarbeiten — etwa „nimm die Bilder aus Ordner XY" oder „verarbeite die Fotos, die mir jemand
per iMessage geschickt hat". Der Assistent besorgt die Bilddateien (mit seinen eigenen
Werkzeugen) und ruft dann die Klarbild-Tools auf.

## Einrichtung

1. In Klarbild einen Token erzeugen: **Admin → „Automatisierung / MCP-Zugriff" → Token erzeugen**.
2. Abhängigkeit installieren: `npm i @modelcontextprotocol/sdk`
3. Server starten (bzw. im MCP-Client eintragen):

```json
{
  "mcpServers": {
    "klarbild": {
      "command": "node",
      "args": ["/pfad/zu/mcp/klarbild-mcp.mjs"],
      "env": {
        "KLARBILD_URL": "https://klarbild.heidrich-digital.de",
        "KLARBILD_TOKEN": "klb_…"
      }
    }
  }
}
```

## Tools

- **list_recipes** — verfügbare Presets/Rezepte auflisten.
- **process_images** — Bilder (lokale Pfade oder `data:`-URLs) hochladen und verarbeiten.
  Entweder `recipeId` (Preset) oder `mode` (`each`/`compose`/`generate`) + Optionen:
  `tasks` (`clean`/`cutout`/`format`/`contour`), `prompt_text`, `output_format`
  (fest wie `30x40`/`theframe` **oder frei** `25x35` / `sticker5`), `output_ext` (`png`/`jpg`,
  weglassen = globaler Standard), `orientation`, `crop_mode`, `contour_mm`, `picdrop_gallery`,
  `delivery`. Liefert die Auftrags-ID.
- **job_status** — Status eines Auftrags abfragen (inkl. Endzeit und Fehlermeldungen).

## Sicherheit

Der Token gibt vollen programmatischen Zugriff auf Upload/Verarbeitung (nicht auf den
Admin-Bereich). Wie ein Passwort behandeln; bei Verdacht neuen Token erzeugen (der alte wird
dadurch ungültig).