Files

T

till ed22a76fda feat: deliver in chosen format (not forced JPEG); wire output_ext through jobs/Telegram/MCP

- delivery.ts: upload the stored result in its chosen format (output_ext,
  global or per-recipe) instead of always converting non-alpha to JPEG.
- jobs POST froze the snapshot without output_ext -> per-conversion/per-recipe
  format choice was silently dropped. Now carried through.
- telegram.ts: recipe snapshots carry output_ext + delivery_target_id
  (custom formats already flow via output_format).
- mcp/klarbild-mcp.mjs: process_images gains tasks, output_ext, orientation,
  crop_mode, contour_mm, picdrop_gallery; job_status shows finished_at + errors.
- Docs: llms.txt, mcp/README, changelog updated.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XNQ8ghPfzAfsyVYd6HgFb6

2026-07-24 09:12:07 +00:00

1.7 KiB

Raw Blame History

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

In Klarbild einen Token erzeugen: Admin → „Automatisierung / MCP-Zugriff" → Token erzeugen.
Abhängigkeit installieren: npm i @modelcontextprotocol/sdk
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: 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).

1.7 KiB Raw Blame History

Klarbild MCP-Server

Einrichtung

Tools

Sicherheit

1.7 KiB

Raw Blame History