till
295f0ce91e
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XNQ8ghPfzAfsyVYd6HgFb6
42 lines
1.4 KiB
Markdown
42 lines
1.4 KiB
Markdown
# 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
|
|
(`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).
|