Guía ›

Agentes de IA y MCP

Actualizado 2026-11-04

En el Mac, RAF Film Lab puede manejarlo un agente de IA como Claude o Codex. El agente busca en tu biblioteca, mira tus fotos, cambia sus aspectos, recetas y ediciones, descarta, las organiza en álbumes y las exporta, por los mismos caminos que la propia app. Cada cambio aparece en la app en el momento, se sincroniza como los tuyos y se puede deshacer.

Qué puedes pedir

Los agentes son buenos en el trabajo que el editor vuelve tedioso: todo lo que sigue reglas, se hace con muchas fotos o se hace mirando y ajustando una y otra vez.

Pídelo con tus propias palabras; no hace falta nombrar la app. RAF Film Lab les dice a los agentes conectados que contiene tu biblioteca de fotos, así que cualquier petición sobre tus fotos, importaciones, valoraciones, álbumes, aspectos o recetas le llega a ella.

Ejemplos de peticiones

Buscar y mirar

• “Enséñame las últimas 5 fotos que importé.”
• “¿Cuántas fotos de mi X-T5 importé esta semana y con qué aspectos están?”
• “¿Con qué receta se tomó mi foto DSCF1234?”

Estilos y ediciones

• “Busca mis fotos de cuatro estrellas de la última importación, ponlas en Classic Chrome y caliéntalas un poco. Enséñame una antes y después.”
• “Aplica esta receta a las fotos de mi álbum Kioto:” seguido de una receta pegada de una publicación de un foro, un enlace compartido o el nombre de una de tus recetas guardadas.
• “Haz que estos treinta fotogramas sean coherentes con mi foto DSCF1234.”
• “Endereza y aplica tono automático a todo lo de la importación de ayer.”
• “Oscurece un poco el cielo de mis paisajes del sábado y dales una curva en S suave.”
• “Ilumina el sujeto de DSCF1234 y añade una viñeta suave a su alrededor.”
• “Guarda el aspecto actual de DSCF1234 como instantánea y luego pruébala en Acros. Haz también una copia virtual en Classic Negative para poder comparar.”

Descartar y organizar

• “Descarta en la importación del sábado: rechaza todo lo desenfocado, elige las cinco mejores y dales cinco estrellas.”
• “Busca las ráfagas de la última importación y quédate con el fotograma más nítido de cada una, con todo el mundo con los ojos abiertos.”
• “¿Qué fotos de la boda están muy sobreexpuestas?”
• “Importa los RAF nuevos de mi carpeta de importación a un álbum llamado Lisboa.”
• “Pon mis elegidas de la última importación en un álbum nuevo llamado Lisboa.”

Cámaras y recetas

• “¿Con qué cámaras he disparado y qué simulaciones de película no tiene mi X-T3?”
• “Guarda la receta de mi foto DSCF1234 como Hora dorada, con un poco más de grano.”
• “¿Qué hay en los ajustes personalizados de mi cámara? Guarda los que aún no tenga.”
• “Pon mi receta Hora dorada en C4 en mi cámara.”
• “Dame un enlace para compartir mi receta Kodachrome.”
• “Lee la receta de esta captura de pantalla de mi carpeta de importación y guárdala.”
• “Exporta mi receta Hora dorada como perfil de X RAW Studio para mi X-T5.”

Exportar y deshacer

• “Exporta todas las elegidas del álbum Blog a 2048 píxeles en una carpeta blog.”
• “¿Qué has cambiado en mis fotos hasta ahora? Deshaz lo último.”

Si el agente busca en otro sitio

Los agentes de programación como Codex y Claude Code también pueden leer los archivos de la carpeta en la que trabajan. Si les das solo un nombre de archivo como “DSCF1234”, Codex puede buscar en esa carpeta. Decir foto (“mi foto DSCF1234”) suele bastar; nombrar RAF Film Lab basta siempre.

Para zanjarlo de una vez, díselo una sola vez a tu app de agente. Añade esta línea a sus instrucciones permanentes: ~/.codex/AGENTS.md para Codex, ~/.claude/CLAUDE.md para Claude Code, o tus instrucciones personales o de proyecto en Claude Desktop:

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

El agente ve cada foto mediante previsualizaciones que la app renderiza para él, así que juzga cómo se ve la foto, no solo sus ajustes.

Los agentes se conectan mediante el Model Context Protocol (MCP), un estándar abierto compatible con Claude Desktop, Claude Code, Codex y muchas otras apps de IA. El servidor MCP forma parte de la app para Mac. En iPhone y iPad, las mismas acciones están disponibles en Atajos.

Activar los agentes

Los agentes están desactivados hasta que los activas. Abre Ajustes (⌘,) y busca Agentes:

• Permitir que los agentes de IA usen la biblioteca activa el servidor.
• Los agentes pueden fija hasta dónde pueden llegar:
  • Solo ver (la opción predeterminada): buscar, leer ajustes y ver previsualizaciones.
  • Ver y editar: además, cambiar aspectos, recetas y ediciones, añadir máscaras y curvas, guardar instantáneas y copias virtuales, valorar, marcar, etiquetar, crear y renombrar álbumes, guardar y cambiar recetas, guardar recetas en una cámara conectada e importar RAF desde una carpeta que elijas.
  • Ver, editar y exportar: además, exportar fotos y archivos de receta a una carpeta que elijas.
  • Ver, editar, exportar y eliminar: además, eliminar álbumes, recetas e instantáneas, y quitar fotos de la biblioteca.
  Un agente conectado ve el nuevo nivel al instante; no se le ofrece lo que no tiene permitido.
• Estado indica si el servidor está listo y qué agente está conectado.

Conectar Claude, Codex y otros clientes

RAF Film Lab incluye un pequeño programa, raffilmlab-mcp, dentro de la app. Las apps de IA lo inician para hablar con la biblioteca, y abre RAF Film Lab en segundo plano si no está en ejecución. En Ajustes › Agentes hay botones que copian la configuración exacta para el lugar donde esté instalada tu app; úsalos en lugar de escribir la ruta. Elige tu 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"
      }
    }
  }

Qué pueden hacer los agentes

Lo que puede hacer un agente depende de lo que permitas en Ajustes. Los identificadores de las fotos salen de search_photos, y los cambios pueden abarcar hasta 500 fotos a la vez.

Los agentes nunca cambian tus archivos RAF originales y solo leen archivos de la carpeta de importación que elijas. No pueden pintar máscaras con pincel ni corregir manchas: eso requiere una mano sobre la foto.

Aspectos y recetas

Un aspecto o una receta nuevos se vuelven a revelar en segundo plano, en tu Mac, como hace Revelar con Film Lab, para que la biblioteca y las exportaciones lo reflejen. Las previsualizaciones muestran el cambio al instante, antes de que termine ese revelado. Para obtener el renderizado de la propia cámara, conecta la cámara que tomó las fotos con CONNECTION MODE ajustado en USB RAW CONV./BACKUP RESTORE y pide al agente que revele en la cámara: un cambio puede revelarse allí directamente, o develop_photos puede revelar las fotos allí después. El revelado aparece en el panel Revelar, donde también puedes pausarlo o detenerlo.

Deshacer y seguridad

• Los cambios se ven al momento. Una foto abierta en el editor se actualiza ante tus ojos, y las miniaturas de la biblioteca la siguen.
• Los cambios en fotos y recetas se pueden deshacer. Pídele que lo deshaga o, para la foto abierta en el editor, pulsa ⌘Z: la edición de un agente es un paso de deshacer como los tuyos. Si has cambiado una foto o receta después, deshacer respeta tu cambio.
• También los álbumes nuevos, las importaciones, las copias virtuales y las eliminaciones. Deshacer elimina un álbum o una copia virtual que haya creado un agente, saca una importación de la biblioteca y recupera un álbum, una receta o una instantánea eliminados.
• Tres cosas que deshacer no cubre. Quitar fotos de la biblioteca, por eso los agentes solo pueden hacerlo si permites eliminar, y deben confirmarlo cada vez. Una receta nueva se queda hasta que la eliminas en Recetas. Una receta guardada en tu cámara sustituye lo que contenía la ranura; antes se hace una copia de seguridad en tu Mac, y el agente avisa si la cámara no ha conservado algún ajuste.
• Deshacer dura mientras la app está abierta. Recuerda los últimos 50 cambios que hicieron los agentes.
• Los agentes pueden comprobar antes. Cualquier cambio se puede probar como simulacro, que indica qué cambiaría sin cambiarlo. Un cambio en más de 100 fotos a la vez se rechaza salvo que el agente lo confirme.
• Los cambios se sincronizan con tus otros dispositivos como tus propias ediciones, cuando la sincronización con iCloud está activada.

Exportar

Los agentes solo exportan a una carpeta que elijas: ajusta Los agentes pueden en Ver, editar y exportar y haz clic en Elegir… junto a Carpeta de exportación. Los agentes pueden crear carpetas dentro, pero no escribir en ningún otro sitio.

• Las exportaciones nunca sustituyen un archivo. Si DSCF1234.jpg ya existe, el nuevo se llama DSCF1234 2.jpg.
• Una exportación se ejecuta en segundo plano. El agente puede seguirla y detenerla; los archivos ya escritos se quedan.
• Las exportaciones de los agentes cuentan para las exportaciones gratuitas como cualquier otra, y una exportación mayor de lo que queda se rechaza antes de empezar.

Importar

Los agentes solo importan desde una carpeta que elijas: ajusta Los agentes pueden en Ver y editar o superior y haz clic en Elegir… junto a Carpeta de importación. Una tarjeta de memoria o la carpeta donde llegan las fotos de tu cámara funcionan bien.

• Una importación es como la que haces con el botón Importar: los RAF que ya están en la biblioteca se omiten, y los nuevos pasan a ser la Última importación. En tu Mac se quedan donde están.
• Los agentes pueden importar la carpeta entera, carpetas que haya dentro o archivos sueltos, y no pueden acceder a nada fuera de ella.
• Los archivos de receta y las imágenes de recetas de la carpeta se pueden leer con read_recipe.

Peticiones y recursos

Algunos clientes ofrecen prompts MCP como tareas listas para usar, a menudo desde un menú o un comando /:

• Match a Look: hace que las fotos se parezcan a una foto de referencia y luego ajusta cada una.
• Cull Photos: valora, elige y rechaza según los criterios que indiques, empezando por las ráfagas y el enfoque, la exposición y las caras medidos.
• Apply a Recipe from Text: lee una receta escrita en una publicación o nota, la comprueba y la aplica.

Los clientes compatibles con recursos pueden adjuntar fotos y listas a una conversación: photo://{id} para los detalles de una foto, photo://{id}/preview para su previsualización, y library://looks, library://albums y library://recipes.

Atajos y Siri

En iPhone, iPad y Mac, RAF Film Lab añade acciones a la app Atajos: Buscar fotos, Ajustar aspecto, Aplicar receta, Valorar fotos, Marcar fotos, Añadir fotos al álbum, Exportar fotos y Deshacer último cambio en la biblioteca. Encadénalas: busca las elegidas de la última importación, ponles un aspecto, expórtalas y guarda los archivos donde los deje la siguiente acción. Algunas también funcionan con Siri, como “Buscar fotos en RAF Film Lab”.

Los atajos no dependen del ajuste Agentes; los creas tú. Sus cambios se pueden deshacer de la misma forma.

Privacidad

• El servidor no está en la red. Solo escucha a programas de tu Mac, y solo mientras los agentes están activados.
• Lo que lee un agente, incluidas las previsualizaciones que pide, va al servicio de IA que usa tu app de agente, como Anthropic para Claude u OpenAI para Codex, según las condiciones de ese servicio. RAF Film Lab no nos envía nada, y los agentes nunca reciben tus archivos RAF.
• Medir fotos, encontrar ráfagas y leer recetas de imágenes se hace en tu Mac, con Vision de Apple.
• Solo ver permite que un agente vea tu biblioteca sin poder cambiarla.

Consulta la política de privacidad.

Solución de problemas

“RAF Film Lab no acepta agentes”

El agente no ha podido conectar con la app. Comprueba que Permitir que los agentes de IA usen la biblioteca esté activado en Ajustes › Agentes y vuelve a conectar el servidor en tu app de agente (en Claude Code o Codex, /mcp; en Claude Desktop, reinícialo).

El agente dice que no puede cambiar, exportar o eliminar

Sube Los agentes pueden en Ajustes › Agentes. El agente recibe el aviso y ve las nuevas herramientas.

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

Elige una junto a Carpeta de exportación o Carpeta de importación en Ajustes › Agentes.

Una previsualización aún no muestra un cambio de receta en la biblioteca

La foto aún se está revelando en segundo plano. Su estado de revelado en get_photo indica developing hasta que termina, y las exportaciones lo esperan.

¿Has movido la app?

La ruta del programa auxiliar cambia con ella. Vuelve a copiar el comando o la configuración desde Ajustes › Agentes y actualiza tu app de agente.