Guida ›

Agenti IA e MCP

Aggiornato il 2026-11-04

Su Mac, RAF Film Lab può essere gestito da un agente IA come Claude o Codex. L'agente cerca nella libreria, guarda le tue foto, ne modifica look, ricette e regolazioni, le seleziona, le organizza in album e le esporta, seguendo gli stessi percorsi dell'app. Ogni modifica appare nell'app in tempo reale, si sincronizza come le tue e può essere annullata.

Cosa puoi chiedere

Gli agenti sono bravi nel lavoro che nell'editor risulta noioso: tutto ciò che segue una regola, va fatto su molte foto o richiede di guardare e regolare più e più volte.

Chiedi con parole tue; non serve nominare l'app. RAF Film Lab comunica agli agenti collegati che contiene la tua libreria fotografica, quindi una richiesta su foto, importazioni, valutazioni, album, look o ricette arriva a lei.

Esempi di prompt

Cercare e guardare

• “Mostrami le ultime 5 foto che ho importato.”
• “Quante foto della mia X-T5 ho importato questa settimana, e con quali look sono?”
• “Con quale ricetta è stata scattata la mia foto DSCF1234?”

Look e modifiche

• “Trova le mie foto a quattro stelle dell'ultima importazione, impostale su Classic Chrome e scaldale un po'. Mostrami un prima e dopo.”
• “Applica questa ricetta alle foto del mio album Kyoto:” seguito da una ricetta incollata da un post di un forum, da un link di condivisione o dal nome di una delle tue ricette salvate.
• “Rendi questi trenta scatti coerenti con la mia foto DSCF1234.”
• “Raddrizza e applica il tono automatico a tutto ciò che ho importato ieri.”
• “Scurisci un po' il cielo nei miei paesaggi di sabato e dai loro una leggera curva a S.”
• “Schiarisci il soggetto in DSCF1234 e aggiungi una vignettatura morbida intorno.”
• “Salva l'aspetto attuale di DSCF1234 come istantanea, poi provala in Acros. Crea anche una copia virtuale in Classic Negative, così posso confrontarle.”

Selezionare e organizzare

• “Seleziona l'importazione di sabato: rifiuta tutto ciò che è fuori fuoco, scegli le cinque migliori e dai loro cinque stelle.”
• “Trova le raffiche nell'ultima importazione e tieni lo scatto più nitido di ciascuna, con gli occhi di tutti aperti.”
• “Quali foto del matrimonio sono molto sovraesposte?”
• “Importa i nuovi RAF della mia cartella di importazione in un album chiamato Lisbona.”
• “Metti le foto scelte dell'ultima importazione in un nuovo album chiamato Lisbona.”

Fotocamere e ricette

• “Con quali fotocamere ho scattato, e quali simulazioni pellicola mancano alla mia X-T3?”
• “Salva la ricetta della mia foto DSCF1234 come Golden Hour, con un po' più di grana.”
• “Cosa c'è nelle impostazioni personalizzate della mia fotocamera? Salva quelle che non ho ancora.”
• “Metti la mia ricetta Golden Hour in C4 sulla fotocamera.”
• “Dammi un link per condividere la mia ricetta Kodachrome.”
• “Leggi la ricetta in questo screenshot nella mia cartella di importazione e salvala.”
• “Esporta la mia ricetta Golden Hour come profilo X RAW Studio per la mia X-T5.”

Esportare e annullare

• “Esporta tutte le foto scelte dell'album Blog a 2048 pixel in una cartella blog.”
• “Cosa hai modificato finora nelle mie foto? Annulla l'ultima modifica.”

Se l'agente cerca altrove

Gli agenti di programmazione come Codex e Claude Code possono anche leggere i file della cartella in cui stanno lavorando. Con un semplice nome di file come “DSCF1234”, Codex potrebbe cercare in quella cartella. Dire foto (“la mia foto DSCF1234”) di solito basta; nominare RAF Film Lab basta sempre.

Per risolvere una volta per tutte, dillo una volta alla tua app per agenti. Aggiungi questa riga alle sue istruzioni permanenti: ~/.codex/AGENTS.md per Codex, ~/.claude/CLAUDE.md per Claude Code, oppure le istruzioni personali o di progetto in Claude Desktop:

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

L'agente vede ogni foto tramite anteprime che l'app genera per lui, quindi valuta l'aspetto della foto, non solo le sue impostazioni.

Gli agenti si collegano tramite il Model Context Protocol (MCP), uno standard aperto supportato da Claude Desktop, Claude Code, Codex e molte altre app di IA. Il server MCP fa parte dell'app per Mac. Su iPhone e iPad, le stesse azioni sono disponibili in Comandi Rapidi.

Attivare gli agenti

Gli agenti sono disattivati finché non li attivi. Apri Impostazioni (⌘,) e cerca Agenti:

• Consenti agli agenti IA di usare la libreria attiva il server.
• Gli agenti possono stabilisce fin dove possono spingersi:
  • Solo visualizzazione (predefinito): cercare, leggere le impostazioni e vedere le anteprime.
  • Visualizzazione e modifica: anche modificare look, ricette e regolazioni, aggiungere maschere e curve, conservare istantanee e copie virtuali, valutare, contrassegnare, etichettare, creare e rinominare album, salvare e modificare ricette, salvare ricette su una fotocamera collegata e importare RAF da una cartella che scegli tu.
  • Visualizzazione, modifica ed esportazione: anche esportare foto e file ricetta, in una cartella che scegli tu.
  • Visualizzazione, modifica, esportazione ed eliminazione: anche eliminare album, ricette e istantanee, e rimuovere foto dalla libreria.
  Un agente collegato vede subito il nuovo livello; non gli viene proposto ciò che non gli è consentito.
• Stato indica se il server è pronto e quale agente è collegato.

Collegare Claude, Codex e altri client

RAF Film Lab include un piccolo programma, raffilmlab-mcp, all'interno dell'app. Le app di IA lo avviano per comunicare con la libreria, e lui apre RAF Film Lab in background se non è in esecuzione. In Impostazioni › Agenti ci sono pulsanti che copiano la configurazione esatta per la posizione in cui è installata l'app; usali invece di digitare il percorso. Scegli la tua app per agenti:

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"
      }
    }
  }

Cosa possono fare gli agenti

Ciò che un agente può fare dipende da ciò che consenti in Impostazioni. Gli id delle foto provengono da search_photos, e le modifiche possono riguardare fino a 500 foto alla volta.

Gli agenti non modificano mai i file RAF originali e leggono file solo dalla cartella di importazione che scegli. Non possono dipingere maschere a pennello né correggere imperfezioni: per quello serve una mano sulla foto.

Look e ricette

Un nuovo look o una nuova ricetta vengono sviluppati di nuovo in background, sul tuo Mac, come fa Sviluppa con Film Lab, così la libreria e le esportazioni li mostrano. Le anteprime mostrano subito la modifica, prima che lo sviluppo termini. Per ottenere invece il rendering della fotocamera, collega la fotocamera che ha scattato le foto con CONNECTION MODE impostato su USB RAW CONV./BACKUP RESTORE e chiedi all'agente di sviluppare nella fotocamera: una modifica può essere sviluppata direttamente lì, oppure develop_photos può sviluppare le foto lì in seguito. Lo sviluppo appare nel pannello Sviluppa, dove puoi anche metterlo in pausa o interromperlo.

Annullamento e sicurezza

• Le modifiche appaiono in tempo reale. Una foto aperta nell'editor si aggiorna davanti a te, e le miniature della libreria la seguono.
• Le modifiche a foto e ricette possono essere annullate. Chiedi all'agente di annullare oppure, per la foto aperta nell'editor, premi ⌘Z: una modifica dell'agente è un passaggio di annullamento come i tuoi. Se nel frattempo hai modificato una foto o una ricetta, l'annullamento lascia intatta la tua modifica.
• Lo stesso vale per nuovi album, importazioni, copie virtuali ed eliminazioni. L'annullamento elimina un album o una copia virtuale creati da un agente, rimuove dalla libreria un'importazione e ripristina un album, una ricetta o un'istantanea eliminati.
• Tre cose che l'annullamento non copre. La rimozione di foto dalla libreria, ed è per questo che gli agenti possono farla solo se consenti l'eliminazione, e devono confermare ogni volta. Una nuova ricetta resta finché non la elimini in Ricette. Una ricetta salvata sulla fotocamera sostituisce il contenuto dello slot; quest'ultimo viene prima salvato sul tuo Mac, e l'agente ti avvisa se la fotocamera non ha mantenuto un'impostazione.
• L'annullamento dura finché l'app è aperta. Ricorda le ultime 50 modifiche fatte dagli agenti.
• Gli agenti possono verificare prima. Ogni modifica può essere provata come simulazione, che indica cosa cambierebbe senza cambiarlo. Una modifica a più di 100 foto alla volta viene rifiutata, a meno che l'agente non la confermi.
• Le modifiche si sincronizzano sugli altri dispositivi come le tue, quando la sincronizzazione iCloud è attiva.

Esportazione

Gli agenti esportano solo in una cartella che scegli tu: imposta Gli agenti possono su Visualizzazione, modifica ed esportazione, poi fai clic su Scegli… accanto a Cartella di esportazione. Gli agenti possono creare cartelle al suo interno, ma non possono scrivere altrove.

• Le esportazioni non sostituiscono mai un file. Se DSCF1234.jpg è già presente, il nuovo file sarà DSCF1234 2.jpg.
• Un'esportazione viene eseguita in background. L'agente può seguirla e interromperla; i file già scritti restano.
• Le esportazioni degli agenti contano per le esportazioni gratuite come tutte le altre, e un'esportazione più grande di quelle rimaste viene rifiutata prima di iniziare.

Importazione

Gli agenti importano solo da una cartella che scegli tu: imposta Gli agenti possono su Visualizzazione e modifica o superiore, poi fai clic su Scegli… accanto a Cartella di importazione. Una scheda di memoria o la cartella in cui arrivano le foto della fotocamera vanno benissimo.

• Un'importazione funziona come quella che fai con il pulsante Importa: i RAF già presenti nella libreria vengono saltati, e quelli nuovi diventano l'Ultima importazione. Sul Mac restano dove sono.
• Gli agenti possono importare l'intera cartella, le cartelle al suo interno o singoli file, e non possono raggiungere nulla al di fuori di essa.
• I file ricetta e le immagini di ricette nella cartella possono essere letti con read_recipe.

Prompt e risorse

Alcuni client offrono i prompt MCP come attività già pronte, spesso da un menu o da un comando /:

• Match a Look: rende le foto simili a una foto di riferimento, poi rifinisce ciascuna.
• Cull Photos: valuta, sceglie e rifiuta in base ai criteri che indichi, partendo dalle raffiche e dalle misure di messa a fuoco, esposizione e volti.
• Apply a Recipe from Text: legge una ricetta scritta in un post o in una nota, la verifica e la applica.

I client che supportano le risorse possono allegare foto ed elenchi a una conversazione: photo://{id} per i dettagli di una foto, photo://{id}/preview per la sua anteprima, e library://looks, library://albums e library://recipes.

Comandi Rapidi e Siri

Su iPhone, iPad e Mac, RAF Film Lab aggiunge azioni all'app Comandi Rapidi: Trova foto, Imposta look, Applica ricetta, Valuta foto, Contrassegna foto, Aggiungi foto all'album, Esporta foto e Annulla l'ultima modifica alla libreria. Concatenale: trova le foto scelte dell'ultima importazione, impostale su un look, esportale e salva i file ovunque li metta l'azione successiva. Alcune funzionano anche con Siri, come “Trova foto in RAF Film Lab”.

I comandi rapidi non dipendono dall'impostazione Agenti; li crei tu. Le loro modifiche si annullano allo stesso modo.

Privacy

• Il server non è in rete. Ascolta solo i programmi sul tuo Mac, e solo mentre gli agenti sono attivi.
• Ciò che un agente legge, comprese le anteprime che richiede, va al servizio di IA usato dalla tua app per agenti, come Anthropic per Claude o OpenAI per Codex, secondo i termini di quel servizio. RAF Film Lab non ci invia nulla, e gli agenti non ricevono mai i tuoi file RAF.
• La misurazione delle foto, la ricerca delle raffiche e la lettura delle ricette dalle immagini avvengono sul tuo Mac, con Vision di Apple.
• Solo visualizzazione permette a un agente di vedere la libreria senza poterla modificare.

Consulta l'informativa sulla privacy.

Risoluzione dei problemi

“RAF Film Lab isn't accepting agents”

L'agente non è riuscito a raggiungere l'app. Verifica che Consenti agli agenti IA di usare la libreria sia attivo in Impostazioni › Agenti, poi ricollega il server nella tua app per agenti (in Claude Code o Codex, /mcp; in Claude Desktop, riavvialo).

L'agente dice che non può modificare, esportare o eliminare

Alza il livello di Gli agenti possono in Impostazioni › Agenti. L'agente viene avvisato e vede i nuovi strumenti.

“No export folder is set” o “No import folder is set”

Scegline una accanto a Cartella di esportazione o Cartella di importazione in Impostazioni › Agenti.

Un'anteprima non mostra ancora nella libreria la modifica a una ricetta

La foto è ancora in fase di sviluppo in background. Il suo stato di sviluppo in get_photo indica developing finché non è finito, e le esportazioni lo attendono.

Hai spostato l'app?

Il percorso dell'helper cambia con essa. Copia di nuovo il comando o la configurazione da Impostazioni › Agenti e aggiorna la tua app per agenti.