Files

T

till 32f3b91779 feat: print sheets via Telegram and MCP

Telegram gains a fully button-driven print flow (photo -> size -> count ->
A4 PDF with corner marks), running inline without the queue or a model. MCP
gains exact_size and print_sheet so an assistant can produce print-ready files
from a local folder. Keeps the rule that every feature works on all three ways in.

2026-08-18 06:20:46 +00:00

klarbild-mcp.mjs

feat: print sheets via Telegram and MCP

2026-08-18 06:20:46 +00:00

README.md

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

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

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

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