klarbild/mcp/README.md

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

{
  "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 (prompt_text, output_format, delivery). Liefert die Auftrags-ID.
• job_status — Status eines Auftrags abfragen.

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