till
ed22a76fda
- 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
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. EntwederrecipeId(Preset) odermode(each/compose/generate) + Optionen:tasks(clean/cutout/format/contour),prompt_text,output_format(fest wie30x40/theframeoder frei25x35/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).