Guia ›

Agentes de IA e MCP

Atualizado em 04/11/2026

No Mac, o RAF Film Lab pode ser controlado por um agente de IA como o Claude ou o Codex. O agente pesquisa sua biblioteca, olha suas fotos, muda os visuais, as receitas e as edições delas, faz a triagem, organiza em álbuns e exporta, pelos mesmos caminhos do próprio app. Cada mudança aparece no app na hora, é sincronizada como as suas e pode ser desfeita.

O que você pode pedir

Os agentes são bons no trabalho que o editor torna tedioso: tudo o que segue regras, é feito em muitas fotos ou exige olhar e ajustar várias vezes.

Peça com suas próprias palavras; você não precisa citar o app. O RAF Film Lab informa aos agentes conectados que ele guarda sua biblioteca de fotos, então um pedido sobre suas fotos, importações, classificações, álbuns, visuais ou receitas vai para ele.

Exemplos de prompts

Encontrar e olhar

• “Mostre as últimas 5 fotos que importei.”
• “Quantas fotos da minha X-T5 importei esta semana, e em quais visuais elas estão?”
• “Com qual receita foi feita minha foto DSCF1234?”

Visuais e edições

• “Encontre minhas fotos de quatro estrelas da última importação, defina-as como Classic Chrome e deixe-as um pouco mais quentes. Mostre um antes e depois.”
• “Aplique esta receita às fotos do meu álbum Kyoto:” seguido de uma receita colada de um post de fórum, um link de compartilhamento ou o nome de uma das suas receitas salvas.
• “Deixe estas trinta fotos consistentes com a minha foto DSCF1234.”
• “Endireite e aplique tom automático em tudo da importação de ontem.”
• “Escureça um pouco o céu nas minhas paisagens de sábado e dê a elas uma curva em S suave.”
• “Clareie o assunto na DSCF1234 e adicione uma vinheta suave ao redor.”
• “Salve o visual atual da DSCF1234 como instantâneo e depois experimente em Acros. Crie também uma cópia virtual em Classic Negative, para eu comparar.”

Triagem e organização

• “Faça a triagem da importação de sábado: rejeite tudo o que estiver fora de foco, escolha as cinco melhores e dê cinco estrelas a elas.”
• “Encontre as sequências na última importação e fique com a foto mais nítida de cada uma, com todo mundo de olhos abertos.”
• “Quais fotos do casamento estão muito superexpostas?”
• “Importe os novos RAFs da minha pasta de importação para um álbum chamado Lisboa.”
• “Coloque minhas escolhidas da última importação em um novo álbum chamado Lisboa.”

Câmeras e receitas

• “Com quais câmeras eu fotografei, e quais simulações de filme minha X-T3 não tem?”
• “Salve a receita da minha foto DSCF1234 como Golden Hour, com um pouco mais de granulação.”
• “O que tem nos ajustes personalizados da minha câmera? Salve os que eu ainda não tenho.”
• “Coloque minha receita Golden Hour no C4 da minha câmera.”
• “Me dê um link para compartilhar minha receita Kodachrome.”
• “Leia a receita nesta captura de tela na minha pasta de importação e salve.”
• “Exporte minha receita Golden Hour como perfil do X RAW Studio para minha X-T5.”

Exportar e desfazer

• “Exporte todas as escolhidas do álbum Blog em 2048 pixels para uma pasta blog.”
• “O que você mudou nas minhas fotos até agora? Desfaça a última mudança.”

Se o agente procurar em outro lugar

Agentes de programação como o Codex e o Claude Code também conseguem ler os arquivos da pasta em que estão trabalhando. Diante de um simples nome de arquivo como “DSCF1234”, o Codex pode procurar nessa pasta. Dizer foto (“minha foto DSCF1234”) geralmente basta; citar o RAF Film Lab sempre basta.

Para resolver de vez, avise seu app de agente uma única vez. Adicione esta linha às instruções permanentes dele: ~/.codex/AGENTS.md no Codex, ~/.claude/CLAUDE.md no Claude Code, ou suas instruções pessoais ou de projeto no Claude Desktop:

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

O agente vê cada foto por meio de prévias que o app renderiza para ele, então julga a aparência da foto, não só os ajustes dela.

Os agentes se conectam pelo Model Context Protocol (MCP), um padrão aberto compatível com o Claude Desktop, o Claude Code, o Codex e muitos outros apps de IA. O servidor MCP faz parte do app para Mac. No iPhone e no iPad, as mesmas ações estão disponíveis no Atalhos.

Ativar os agentes

Os agentes ficam desativados até você ativá-los. Abra Ajustes (⌘,) e encontre Agentes:

• Permitir que agentes de IA usem a biblioteca ativa o servidor.
• Os agentes podem define até onde eles podem ir:
  • Somente visualizar (o padrão): pesquisar, ler ajustes e ver prévias.
  • Visualizar e editar: também mudar visuais, receitas e edições, adicionar máscaras e curvas, guardar instantâneos e cópias virtuais, classificar, sinalizar, rotular, criar e renomear álbuns, salvar e alterar receitas, salvar receitas em uma câmera conectada e importar RAFs de uma pasta que você escolher.
  • Visualizar, editar e exportar: também exportar fotos e arquivos de receita para uma pasta que você escolher.
  • Visualizar, editar, exportar e apagar: também apagar álbuns, receitas e instantâneos, e remover fotos da biblioteca.
  Um agente conectado vê o novo nível na hora; ele não recebe o que não tem permissão para fazer.
• Estado informa se o servidor está pronto e qual agente está conectado.

Conectar o Claude, o Codex e outros clientes

O RAF Film Lab vem com um pequeno programa, raffilmlab-mcp, dentro do app. Os apps de IA o iniciam para falar com a biblioteca, e ele abre o RAF Film Lab em segundo plano se ele não estiver aberto. Ajustes › Agentes tem botões que copiam a configuração exata para onde seu app estiver instalado; use-os em vez de digitar o caminho. Escolha seu app de agente:

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

O que os agentes podem fazer

O que um agente pode fazer depende do que você permite em Ajustes. Os ids das fotos vêm de search_photos, e as mudanças podem atingir até 500 fotos de uma vez.

Os agentes nunca alteram seus arquivos RAF originais e só leem arquivos da pasta de importação que você escolher. Eles não pintam máscaras de pincel nem recuperam pontos: isso exige uma mão na foto.

Visuais e receitas

Um novo visual ou receita é revelado de novo em segundo plano, no seu Mac, como faz Revelar com o Film Lab, para que a biblioteca e as exportações o mostrem. As prévias mostram a mudança na hora, antes de essa revelação terminar. Para ter a renderização da própria câmera, conecte a câmera que fez as fotos com CONNECTION MODE definido como USB RAW CONV./BACKUP RESTORE e peça ao agente que revele na câmera: uma mudança pode ser revelada lá diretamente, ou develop_photos pode revelar as fotos lá depois. A revelação aparece no painel Revelar, onde você também pode pausá-la ou pará-la.

Desfazer e segurança

• As mudanças aparecem na hora. Uma foto aberta no editor se atualiza na sua frente, e as miniaturas da biblioteca acompanham.
• Mudanças em fotos e receitas podem ser desfeitas. Peça para desfazer ou, para a foto aberta no editor, pressione ⌘Z: uma edição do agente é um passo de desfazer como os seus. Se você mudou uma foto ou receita depois, desfazer não mexe na sua mudança.
• Novos álbuns, importações, cópias virtuais e exclusões também. Desfazer apaga um álbum ou cópia virtual que um agente criou, tira uma importação da biblioteca e traz de volta um álbum, receita ou instantâneo apagado.
• Três coisas que desfazer não cobre. Remover fotos da biblioteca, e é por isso que os agentes só podem fazer isso quando você permite apagar, e precisam confirmar toda vez. Uma nova receita fica até você apagá-la em Receitas. Uma receita salva na sua câmera substitui o que o slot continha; isso é salvo antes como backup no seu Mac, e o agente avisa se a câmera não guardou algum ajuste.
• O desfazer dura enquanto o app está aberto. Ele lembra as últimas 50 mudanças feitas pelos agentes.
• Os agentes podem verificar antes. Toda mudança pode ser testada como simulação, que diz o que mudaria sem mudar nada. Uma mudança em mais de 100 fotos de uma vez é recusada, a menos que o agente a confirme.
• As mudanças são sincronizadas com seus outros dispositivos como suas próprias edições, quando a sincronização com o iCloud está ativada.

Exportação

Os agentes só exportam para uma pasta que você escolher: defina Os agentes podem como Visualizar, editar e exportar e clique em Escolher… ao lado de Pasta de exportação. Os agentes podem criar pastas dentro dela, mas não podem gravar em nenhum outro lugar.

• As exportações nunca substituem um arquivo. Se DSCF1234.jpg já estiver lá, o novo será DSCF1234 2.jpg.
• Uma exportação roda em segundo plano. O agente pode acompanhá-la e pará-la; os arquivos já gravados ficam.
• As exportações dos agentes contam para as exportações gratuitas como qualquer outra, e uma exportação maior do que o que resta é recusada antes de começar.

Importação

Os agentes só importam de uma pasta que você escolher: defina Os agentes podem como Visualizar e editar ou superior e clique em Escolher… ao lado de Pasta de importação. Um cartão de memória ou a pasta onde chegam as fotos da sua câmera funcionam bem.

• Uma importação é como a que você faz com o botão Importar: RAFs que já estão na biblioteca são pulados, e os novos formam a Última importação. No seu Mac, eles ficam onde estão.
• Os agentes podem importar a pasta inteira, pastas dentro dela ou arquivos avulsos, e não alcançam nada fora dela.
• Arquivos de receita e imagens de receitas na pasta podem ser lidos com read_recipe.

Prompts e recursos

Alguns clientes oferecem prompts MCP como tarefas prontas, muitas vezes em um menu ou num comando /:

• Match a Look: deixa as fotos parecidas com uma foto de referência e depois ajusta cada uma.
• Cull Photos: classifica, escolhe e rejeita segundo critérios que você der, partindo das sequências e das medições de foco, exposição e rostos.
• Apply a Recipe from Text: lê uma receita escrita em um post ou nota, confere e aplica.

Clientes compatíveis com recursos podem anexar fotos e listas a uma conversa: photo://{id} para os detalhes de uma foto, photo://{id}/preview para a prévia dela, e library://looks, library://albums e library://recipes.

Atalhos e Siri

No iPhone, iPad e Mac, o RAF Film Lab adiciona ações ao app Atalhos: Encontrar fotos, Definir visual, Aplicar receita, Classificar fotos, Sinalizar fotos, Adicionar fotos ao álbum, Exportar fotos e Desfazer última alteração da biblioteca. Encadeie-as: encontre as escolhidas da última importação, defina um visual para elas, exporte-as e salve os arquivos onde a próxima ação mandar. Algumas também funcionam com a Siri, como “Encontrar fotos no RAF Film Lab”.

Os atalhos não dependem do ajuste Agentes; você mesmo os cria. As mudanças deles podem ser desfeitas do mesmo jeito.

Privacidade

• O servidor não fica na rede. Ele só escuta programas no seu Mac, e só enquanto os agentes estão ativados.
• O que um agente lê, incluindo as prévias que ele pede, vai para o serviço de IA que seu app de agente usa, como a Anthropic no caso do Claude ou a OpenAI no caso do Codex, segundo os termos desse serviço. O RAF Film Lab não nos envia nada, e os agentes nunca recebem seus arquivos RAF.
• A medição das fotos, a detecção de sequências e a leitura de receitas em imagens acontecem no seu Mac, com o Vision da Apple.
• Somente visualizar permite que um agente veja sua biblioteca sem poder alterá-la.

Consulte a política de privacidade.

Solução de problemas

“RAF Film Lab isn't accepting agents”

O agente não conseguiu alcançar o app. Verifique se Permitir que agentes de IA usem a biblioteca está ativado em Ajustes › Agentes e reconecte o servidor no seu app de agente (no Claude Code ou no Codex, /mcp; no Claude Desktop, reinicie-o).

O agente diz que não pode alterar, exportar ou apagar

Aumente Os agentes podem em Ajustes › Agentes. O agente é avisado e passa a ver as novas ferramentas.

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

Escolha uma ao lado de Pasta de exportação ou Pasta de importação em Ajustes › Agentes.

Uma prévia ainda não mostra na biblioteca uma mudança de receita

A foto ainda está sendo revelada em segundo plano. O estado da revelação em get_photo diz developing até terminar, e as exportações esperam por ela.

Mudou o app de lugar?

O caminho do auxiliar muda junto. Copie de novo o comando ou a configuração em Ajustes › Agentes e atualize seu app de agente.