Anleitung ›

KI-Agenten und MCP

Aktualisiert 2026-11-04

Auf dem Mac lässt sich RAF Film Lab von einem KI-Agenten wie Claude oder Codex steuern. Der Agent durchsucht Ihre Mediathek, sieht sich Ihre Fotos an, ändert deren Looks, Rezepte und Bearbeitungen, sichtet sie, ordnet sie in Alben ein und exportiert sie – auf denselben Wegen wie die App selbst. Jede Änderung erscheint sofort in der App, wird wie Ihre eigene synchronisiert und lässt sich widerrufen.

Was Sie fragen können

Agenten sind gut in der Arbeit, die im Editor mühsam ist: alles, was Regeln folgt, viele Fotos betrifft oder immer wieder Hinsehen und Nachjustieren erfordert.

Fragen Sie in Ihren eigenen Worten; Sie müssen die App nicht nennen. RAF Film Lab teilt verbundenen Agenten mit, dass es Ihre Fotomediathek enthält – eine Anfrage zu Ihren Fotos, Importen, Bewertungen, Alben, Looks oder Rezepten landet also dort.

Beispiel-Prompts

Suchen und ansehen

• „Zeig mir die letzten 5 Fotos, die ich importiert habe.“
• „Wie viele Fotos von meiner X-T5 habe ich diese Woche importiert, und in welchen Looks sind sie?“
• „Mit welchem Rezept wurde mein Foto DSCF1234 aufgenommen?“

Looks und Bearbeitungen

• „Such meine Vier-Sterne-Fotos aus dem letzten Import, stell sie auf Classic Chrome und mach sie etwas wärmer. Zeig mir eines vorher und nachher.“
• „Wende dieses Rezept auf die Fotos in meinem Album Kyoto an:“ gefolgt von einem Rezept, das Sie aus einem Forumsbeitrag einfügen, einem Teilen-Link oder dem Namen eines Ihrer gesicherten Rezepte.
• „Gleich diese dreißig Bilder an mein Foto DSCF1234 an.“
• „Richte alles aus dem gestrigen Import aus und wende Auto-Ton an.“
• „Dunkle in meinen Landschaften vom Samstag den Himmel etwas ab und gib ihnen eine sanfte S-Kurve.“
• „Hell das Motiv in DSCF1234 auf und füge eine weiche Vignette drumherum hinzu.“
• „Sichere den aktuellen Zustand von DSCF1234 als Schnappschuss und probier es dann in Acros. Mach außerdem eine virtuelle Kopie in Classic Negative, damit ich vergleichen kann.“

Sichten und organisieren

• „Sichte den Import vom Samstag: Lehne alles Unscharfe ab, markiere die besten fünf und gib ihnen fünf Sterne.“
• „Finde die Serien im letzten Import und behalte jeweils das schärfste Bild, auf dem alle die Augen offen haben.“
• „Welche Fotos von der Hochzeit sind stark überbelichtet?“
• „Importiere die neuen RAF-Dateien aus meinem Importordner in ein Album namens Lissabon.“
• „Leg meine markierten Fotos aus dem letzten Import in ein neues Album namens Lissabon.“

Kameras und Rezepte

• „Mit welchen Kameras habe ich fotografiert, und welche Filmsimulationen fehlen meiner X-T3?“
• „Sichere das Rezept meines Fotos DSCF1234 als Golden Hour, mit etwas mehr Körnung.“
• „Was liegt in den eigenen Einstellungen meiner Kamera? Sichere alle, die ich noch nicht habe.“
• „Leg mein Rezept Golden Hour auf C4 meiner Kamera.“
• „Gib mir einen Link, um mein Kodachrome-Rezept zu teilen.“
• „Lies das Rezept in diesem Bildschirmfoto in meinem Importordner und sichere es.“
• „Exportiere mein Rezept Golden Hour als X RAW Studio-Profil für meine X-T5.“

Exportieren und widerrufen

• „Exportiere alle markierten Fotos im Album Blog mit 2048 Pixeln in einen Ordner blog.“
• „Was hast du bisher an meinen Fotos geändert? Mach das Letzte rückgängig.“

Wenn der Agent woanders sucht

Coding-Agenten wie Codex und Claude Code können auch die Dateien in dem Ordner lesen, in dem sie arbeiten. Bei einem bloßen Dateinamen wie „DSCF1234“ durchsucht Codex womöglich stattdessen diesen Ordner. Das Wort Foto („mein Foto DSCF1234“) genügt meist; RAF Film Lab zu nennen, genügt immer.

Um das ein für alle Mal zu klären, sagen Sie es Ihrer Agenten-App einmal. Fügen Sie diese Zeile zu ihren dauerhaften Anweisungen hinzu: ~/.codex/AGENTS.md für Codex, ~/.claude/CLAUDE.md für Claude Code oder Ihre persönlichen bzw. Projektanweisungen in Claude Desktop:

My photos are in RAF Film Lab. For anything about my photos, use its tools, not files on disk.

Der Agent sieht jedes Foto über Vorschauen, die die App für ihn rendert – er beurteilt also, wie das Foto aussieht, nicht nur seine Einstellungen.

Agenten verbinden sich über das Model Context Protocol (MCP), einen offenen Standard, den Claude Desktop, Claude Code, Codex und viele andere KI-Apps unterstützen. Der MCP-Server ist Teil der Mac-App. Auf iPhone und iPad stehen dieselben Aktionen in Kurzbefehle zur Verfügung.

Agenten aktivieren

Agenten sind ausgeschaltet, bis Sie sie aktivieren. Öffnen Sie die Einstellungen (⌘,) und suchen Sie Agenten:

• KI-Agenten die Mediathek nutzen lassen schaltet den Server ein.
• Agenten dürfen legt fest, wie weit sie gehen dürfen:
  • Nur ansehen (Standard): suchen, Einstellungen lesen und Vorschauen sehen.
  • Ansehen und bearbeiten: außerdem Looks, Rezepte und Bearbeitungen ändern, Masken und Kurven hinzufügen, Schnappschüsse und virtuelle Kopien anlegen, bewerten, markieren, mit Etiketten versehen, Alben erstellen und umbenennen, Rezepte sichern und ändern, Rezepte in einer verbundenen Kamera sichern und RAF-Dateien aus einem von Ihnen gewählten Ordner importieren.
  • Ansehen, bearbeiten und exportieren: außerdem Fotos und Rezeptdateien in einen von Ihnen gewählten Ordner exportieren.
  • Ansehen, bearbeiten, exportieren und löschen: außerdem Alben, Rezepte und Schnappschüsse löschen und Fotos aus der Mediathek entfernen.
  Ein verbundener Agent sieht die neue Stufe sofort; was er nicht darf, wird ihm gar nicht erst angeboten.
• Status zeigt, ob der Server bereit ist und welcher Agent verbunden ist.

Claude, Codex und andere Clients verbinden

RAF Film Lab enthält ein kleines Programm, raffilmlab-mcp, innerhalb der App. KI-Apps starten es, um mit der Mediathek zu sprechen, und es öffnet RAF Film Lab im Hintergrund, falls die App nicht läuft. Unter „Einstellungen“ › „Agenten“ gibt es Tasten, die die exakte Einrichtung für den Ort kopieren, an dem Ihre App installiert ist; nutzen Sie diese, statt den Pfad abzutippen. Wählen Sie Ihre Agenten-App:

claude mcp add --scope user raf-film-lab -- "/Applications/RAF Film Lab.app/Contents/Helpers/raffilmlab-mcp"

{
    "mcpServers": {
      "raf-film-lab": {
        "command": "/Applications/RAF Film Lab.app/Contents/Helpers/raffilmlab-mcp"
      }
    }
  }

codex mcp add raf-film-lab -- "/Applications/RAF Film Lab.app/Contents/Helpers/raffilmlab-mcp"

[mcp_servers.raf-film-lab]
  command = "/Applications/RAF Film Lab.app/Contents/Helpers/raffilmlab-mcp"

{
    "mcpServers": {
      "raf-film-lab": {
        "type": "stdio",
        "command": "/Applications/RAF Film Lab.app/Contents/Helpers/raffilmlab-mcp"
      }
    }
  }

{
    "servers": {
      "raf-film-lab": {
        "type": "stdio",
        "command": "/Applications/RAF Film Lab.app/Contents/Helpers/raffilmlab-mcp"
      }
    }
  }

{
    "mcpServers": {
      "raf-film-lab": {
        "command": "/Applications/RAF Film Lab.app/Contents/Helpers/raffilmlab-mcp"
      }
    }
  }

Was Agenten können

Was ein Agent tun kann, hängt davon ab, was Sie in den Einstellungen erlauben. Foto-IDs stammen aus search_photos, und Änderungen können bis zu 500 Fotos auf einmal betreffen.

Agenten ändern nie Ihre Original-RAF-Dateien und lesen Dateien nur aus dem Importordner, den Sie wählen. Pinselmasken malen oder Stellen reparieren können sie nicht: Dafür braucht es eine Hand am Foto.

Looks und Rezepte

Ein neuer Look oder ein neues Rezept wird im Hintergrund auf Ihrem Mac neu entwickelt, so wie bei „Mit Film Lab entwickeln“, damit Mediathek und Exporte ihn zeigen. Vorschauen zeigen die Änderung sofort, noch bevor diese Entwicklung abgeschlossen ist. Möchten Sie stattdessen das kameraeigene Rendering, schließen Sie die Kamera an, mit der die Fotos aufgenommen wurden, stellen CONNECTION MODE auf USB RAW CONV./BACKUP RESTORE und bitten den Agenten, in der Kamera zu entwickeln: Eine Änderung kann dort direkt entwickelt werden, oder develop_photos kann Fotos anschließend dort entwickeln. Die Entwicklung erscheint im Bereich „Entwickeln“, wo Sie sie auch pausieren oder stoppen können.

Widerrufen und Sicherheit

• Änderungen erscheinen, während sie geschehen. Ein im Editor geöffnetes Foto aktualisiert sich vor Ihren Augen, und die Miniaturen der Mediathek ziehen nach.
• Änderungen an Fotos und Rezepten lassen sich widerrufen. Bitten Sie den Agenten darum oder drücken Sie beim im Editor geöffneten Foto ⌘Z: Die Bearbeitung eines Agenten ist ein Widerrufen-Schritt wie Ihre eigene. Haben Sie ein Foto oder Rezept inzwischen geändert, lässt das Widerrufen Ihre Änderung unangetastet.
• Ebenso neue Alben, Importe, virtuelle Kopien und Löschungen. Widerrufen löscht ein Album oder eine virtuelle Kopie, die ein Agent erstellt hat, nimmt einen Import wieder aus der Mediathek und stellt ein gelöschtes Album, Rezept oder einen Schnappschuss wieder her.
• Drei Dinge deckt das Widerrufen nicht ab. Das Entfernen von Fotos aus der Mediathek – deshalb können Agenten das nur, wenn Sie Löschen erlauben, und müssen es jedes Mal bestätigen. Ein neues Rezept bleibt, bis Sie es unter „Rezepte“ löschen. Ein in Ihrer Kamera gesichertes Rezept ersetzt den bisherigen Inhalt des Speicherplatzes; dieser wird vorher auf Ihrem Mac gesichert, und der Agent meldet, falls die Kamera eine Einstellung nicht übernommen hat.
• Widerrufen gilt, solange die App geöffnet ist. Es merkt sich die letzten 50 Änderungen von Agenten.
• Agenten können vorher prüfen. Jede Änderung lässt sich als Probelauf ausführen, der zeigt, was sich ändern würde, ohne etwas zu ändern. Eine Änderung an mehr als 100 Fotos auf einmal wird abgelehnt, sofern der Agent sie nicht bestätigt.
• Änderungen werden wie Ihre eigenen Bearbeitungen mit Ihren anderen Geräten synchronisiert, wenn die iCloud-Synchronisierung aktiviert ist.

Exportieren

Agenten exportieren nur in einen Ordner, den Sie wählen: Stellen Sie Agenten dürfen auf Ansehen, bearbeiten und exportieren und klicken Sie dann neben Exportordner auf Auswählen …. Agenten können darin Ordner anlegen, aber nirgendwo anders schreiben.

• Exporte ersetzen nie eine Datei. Liegt DSCF1234.jpg bereits dort, heißt die neue DSCF1234 2.jpg.
• Ein Export läuft im Hintergrund. Der Agent kann ihn verfolgen und stoppen; bereits geschriebene Dateien bleiben erhalten.
• Exporte von Agenten zählen wie alle anderen zu den kostenlosen Exporten, und ein Export, der größer ist als das verbleibende Kontingent, wird vor dem Start abgelehnt.

Importieren

Agenten importieren nur aus einem Ordner, den Sie wählen: Stellen Sie Agenten dürfen auf Ansehen und bearbeiten oder höher und klicken Sie dann neben Importordner auf Auswählen …. Eine Speicherkarte oder der Ordner, in dem die Fotos Ihrer Kamera landen, eignet sich gut.

• Ein Import funktioniert wie einer über die Taste „Importieren“: RAF-Dateien, die schon in der Mediathek sind, werden übersprungen, und die neuen bilden den letzten Import. Auf Ihrem Mac bleiben sie, wo sie sind.
• Agenten können den ganzen Ordner, Ordner darin oder einzelne Dateien importieren und kommen an nichts außerhalb davon heran.
• Rezeptdateien und Bilder von Rezepten im Ordner lassen sich mit read_recipe lesen.

Prompts und Ressourcen

Manche Clients bieten MCP-Prompts als vorgefertigte Aufgaben an, oft über ein Menü oder einen /-Befehl:

• Match a Look: Fotos wie ein Referenzfoto aussehen lassen und dann jedes einzeln feinabstimmen.
• Cull Photos: nach Ihren Kriterien bewerten, markieren und ablehnen, ausgehend von den Serien und der gemessenen Schärfe, Belichtung und den Gesichtern.
• Apply a Recipe from Text: ein in einem Beitrag oder einer Notiz ausgeschriebenes Rezept lesen, prüfen und anwenden.

Clients, die Ressourcen unterstützen, können Fotos und Listen an eine Unterhaltung anhängen: photo://{id} für die Details eines Fotos, photo://{id}/preview für seine Vorschau sowie library://looks, library://albums und library://recipes.

Kurzbefehle und Siri

Auf iPhone, iPad und Mac fügt RAF Film Lab der App „Kurzbefehle“ Aktionen hinzu: Fotos suchen, Look festlegen, Rezept anwenden, Fotos bewerten, Fotos markieren, Fotos zum Album hinzufügen, Fotos exportieren und Letzte Mediatheksänderung widerrufen. Verketten Sie sie: die markierten Fotos des letzten Imports finden, ihnen einen Look geben, sie exportieren und die Dateien dort sichern, wo die nächste Aktion sie ablegt. Manche funktionieren auch mit Siri, etwa „Fotos in RAF Film Lab suchen“.

Kurzbefehle hängen nicht von der Einstellung „Agenten“ ab; Sie erstellen sie selbst. Ihre Änderungen lassen sich auf dieselbe Weise widerrufen.

Datenschutz

• Der Server ist nicht im Netzwerk erreichbar. Er nimmt nur Verbindungen von Programmen auf Ihrem Mac an und nur, solange Agenten aktiviert sind.
• Was ein Agent liest, einschließlich der angeforderten Vorschauen, geht an den KI-Dienst, den Ihre Agenten-App nutzt – etwa Anthropic für Claude oder OpenAI für Codex – und unterliegt dessen Bedingungen. RAF Film Lab sendet nichts an uns, und Agenten erhalten nie Ihre RAF-Dateien.
• Das Vermessen von Fotos, das Finden von Serien und das Lesen von Rezepten aus Bildern geschieht auf Ihrem Mac, mit Apples Vision.
• „Nur ansehen“ lässt einen Agenten Ihre Mediathek sehen, ohne dass er sie ändern kann.

Siehe die Datenschutzerklärung.

Fehlerbehebung

„RAF Film Lab nimmt keine Agenten an“

Der Agent konnte die App nicht erreichen. Prüfen Sie, ob KI-Agenten die Mediathek nutzen lassen unter „Einstellungen“ › „Agenten“ aktiviert ist, und verbinden Sie den Server in Ihrer Agenten-App neu (in Claude Code oder Codex mit /mcp; Claude Desktop starten Sie neu).

Der Agent sagt, er könne nichts ändern, exportieren oder löschen

Erhöhen Sie Agenten dürfen unter „Einstellungen“ › „Agenten“. Der Agent wird informiert und sieht die neuen Werkzeuge.

„No export folder is set“ oder „No import folder is set“

Wählen Sie unter „Einstellungen“ › „Agenten“ einen Ordner neben Exportordner bzw. Importordner.

Eine Vorschau zeigt eine Rezeptänderung, die Mediathek noch nicht

Das Foto wird noch im Hintergrund entwickelt. Sein Entwicklungsstatus in get_photo lautet developing, bis es fertig ist, und Exporte warten darauf.

App verschoben?

Der Pfad des Hilfsprogramms ändert sich mit. Kopieren Sie Befehl oder Konfiguration erneut unter „Einstellungen“ › „Agenten“ und aktualisieren Sie Ihre Agenten-App.