Guide ›

Agents IA et MCP

Mis à jour le 2026-11-04

Sur Mac, RAF Film Lab peut être piloté par un agent IA comme Claude ou Codex. L’agent fait des recherches dans votre bibliothèque, regarde vos photos, change leurs rendus, recettes et modifications, les trie, les range dans des albums et les exporte, en passant par les mêmes chemins que l’app elle-même. Chaque changement apparaît dans l’app en temps réel, se synchronise comme les vôtres et peut être annulé.

Ce que vous pouvez demander

Les agents excellent dans les tâches que l’éditeur rend fastidieuses : tout ce qui suit une règle, s’applique à de nombreuses photos, ou demande de regarder et d’ajuster encore et encore.

Demandez avec vos propres mots ; inutile de nommer l’app. RAF Film Lab indique aux agents connectés qu’il contient votre photothèque : une demande portant sur vos photos, importations, notes, albums, rendus ou recettes lui est donc adressée.

Exemples de requêtes

Rechercher et regarder

• « Montre-moi les 5 dernières photos que j’ai importées. »
• « Combien de photos de mon X-T5 ai-je importées cette semaine, et avec quels rendus ? »
• « Avec quelle recette ma photo DSCF1234 a-t-elle été prise ? »

Rendus et modifications

• « Trouve mes photos quatre étoiles de la dernière importation, passe-les en Classic Chrome et réchauffe-les un peu. Montre-moi un avant/après. »
• « Applique cette recette aux photos de mon album Kyoto : » suivi d’une recette collée depuis un forum, d’un lien de partage ou du nom de l’une de vos recettes enregistrées.
• « Harmonise ces trente images avec ma photo DSCF1234. »
• « Redresse et règle automatiquement la tonalité de toute l’importation d’hier. »
• « Assombris un peu le ciel de mes paysages de samedi, et donne-leur une légère courbe en S. »
• « Éclaircis le sujet de DSCF1234 et ajoute un léger vignetage autour. »
• « Enregistre l’état actuel de DSCF1234 comme instantané, puis essaie-la en Acros. Fais aussi une copie virtuelle en Classic Negative, pour que je puisse comparer. »

Tri et organisation

• « Trie l’importation de samedi : rejette tout ce qui est flou, retiens les cinq meilleures et donne-leur cinq étoiles. »
• « Trouve les rafales de la dernière importation et garde l’image la plus nette de chacune, avec tout le monde les yeux ouverts. »
• « Quelles photos du mariage sont nettement surexposées ? »
• « Importe les nouveaux RAF de mon dossier d’importation dans un album appelé Lisbonne. »
• « Mets mes photos retenues de la dernière importation dans un nouvel album appelé Lisbonne. »

Appareils et recettes

• « Avec quels appareils ai-je photographié, et quelles simulations de film manquent à mon X-T3 ? »
• « Enregistre la recette de ma photo DSCF1234 sous le nom Golden Hour, avec un peu plus de grain. »
• « Qu’y a-t-il dans les réglages personnalisés de mon appareil ? Enregistre ceux que je n’ai pas encore. »
• « Mets ma recette Golden Hour dans C4 sur mon appareil. »
• « Donne-moi un lien pour partager ma recette Kodachrome. »
• « Lis la recette de cette capture d’écran dans mon dossier d’importation et enregistre-la. »
• « Exporte ma recette Golden Hour en profil X RAW Studio pour mon X-T5. »

Exporter et annuler

• « Exporte toutes les photos retenues de l’album Blog en 2048 pixels dans un dossier blog. »
• « Qu’as-tu modifié dans mes photos jusqu’ici ? Annule la dernière modification. »

Si l’agent cherche ailleurs

Les agents de code comme Codex et Claude Code peuvent aussi lire les fichiers du dossier dans lequel ils travaillent. Face à un simple nom de fichier comme « DSCF1234 », Codex risque de chercher dans ce dossier. Dire photo (« ma photo DSCF1234 ») suffit généralement ; nommer RAF Film Lab suffit toujours.

Pour régler la question une fois pour toutes, dites-le une fois à votre app d’agent. Ajoutez cette ligne à ses instructions permanentes : ~/.codex/AGENTS.md pour Codex, ~/.claude/CLAUDE.md pour Claude Code, ou vos instructions personnelles ou de projet dans Claude Desktop :

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

L’agent voit chaque photo à travers des aperçus que l’app produit pour lui : il juge donc l’aspect de la photo, pas seulement ses réglages.

Les agents se connectent via le Model Context Protocol (MCP), un standard ouvert pris en charge par Claude Desktop, Claude Code, Codex et de nombreuses autres apps d’IA. Le serveur MCP fait partie de l’app Mac. Sur iPhone et iPad, les mêmes actions sont disponibles dans Raccourcis.

Activer les agents

Les agents sont désactivés tant que vous ne les activez pas. Ouvrez Réglages (⌘,) et repérez Agents :

• Autoriser les agents IA à utiliser la bibliothèque active le serveur.
• Les agents peuvent définit jusqu’où ils peuvent aller :
  • Lecture seule (par défaut) : rechercher, lire les réglages et voir les aperçus.
  • Voir et modifier : en plus, changer les rendus, recettes et modifications, ajouter des masques et des courbes, conserver des instantanés et des copies virtuelles, noter, marquer, étiqueter, créer et renommer des albums, enregistrer et modifier des recettes, enregistrer des recettes dans un appareil connecté, et importer des RAF depuis un dossier de votre choix.
  • Voir, modifier et exporter : en plus, exporter des photos et des fichiers de recette, dans un dossier de votre choix.
  • Voir, modifier, exporter et supprimer : en plus, supprimer des albums, des recettes et des instantanés, et retirer des photos de la bibliothèque.
  Un agent connecté voit immédiatement le nouveau niveau ; ce qui ne lui est pas permis ne lui est pas proposé.
• État indique si le serveur est prêt et quel agent est connecté.

Connecter Claude, Codex et d’autres clients

RAF Film Lab inclut un petit programme, raffilmlab-mcp, à l’intérieur de l’app. Les apps d’IA le lancent pour dialoguer avec la bibliothèque, et il ouvre RAF Film Lab en arrière-plan s’il n’est pas déjà lancé. Réglages › Agents propose des boutons qui copient la configuration exacte selon l’emplacement de votre app ; utilisez-les plutôt que de saisir le chemin. Choisissez votre app d’agent :

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

Ce que les agents peuvent faire

Ce qu’un agent peut faire dépend de ce que vous autorisez dans Réglages. Les identifiants de photo proviennent de search_photos, et les modifications peuvent porter sur 500 photos à la fois.

Les agents ne modifient jamais vos fichiers RAF originaux, et ne lisent des fichiers que dans le dossier d’importation que vous choisissez. Ils ne peuvent ni peindre des masques au pinceau ni corriger des défauts : il faut pour cela une main sur la photo.

Rendus et recettes

Un nouveau rendu ou une nouvelle recette est redéveloppé en arrière-plan, sur votre Mac, comme avec Développer avec Film Lab, pour que la bibliothèque et les exportations en tiennent compte. Les aperçus montrent le changement immédiatement, avant la fin de ce développement. Pour obtenir plutôt le rendu de l’appareil lui-même, branchez l’appareil qui a pris les photos avec CONNECTION MODE réglé sur USB RAW CONV./BACKUP RESTORE et demandez à l’agent de développer dans l’appareil : une modification peut y être développée directement, ou develop_photos peut y développer des photos ensuite. Le développement s’affiche dans le panneau de développement, où vous pouvez aussi le mettre en pause ou l’arrêter.

Annulation et sécurité

• Les changements s’affichent en temps réel. Une photo ouverte dans l’éditeur se met à jour sous vos yeux, et les vignettes de la bibliothèque suivent.
• Les changements apportés aux photos et aux recettes peuvent être annulés. Demandez à l’agent d’annuler ou, pour la photo ouverte dans l’éditeur, appuyez sur ⌘Z : une modification d’agent est une étape d’annulation comme les vôtres. Si vous avez modifié une photo ou une recette entre-temps, l’annulation ne touche pas à votre modification.
• Tout comme les nouveaux albums, importations, copies virtuelles et suppressions. L’annulation supprime un album ou une copie virtuelle créé par un agent, retire une importation de la bibliothèque, et restaure un album, une recette ou un instantané supprimé.
• Trois choses échappent à l’annulation. Le retrait de photos de la bibliothèque : c’est pourquoi les agents ne peuvent le faire qu’une fois la suppression autorisée, et doivent confirmer à chaque fois. Une nouvelle recette reste jusqu’à ce que vous la supprimiez dans Recettes. Une recette enregistrée dans votre appareil remplace le contenu de l’emplacement ; celui-ci est d’abord sauvegardé sur votre Mac, et l’agent vous signale si l’appareil n’a pas conservé un réglage.
• L’annulation dure tant que l’app est ouverte. Elle mémorise les 50 derniers changements effectués par les agents.
• Les agents peuvent vérifier d’abord. Chaque changement peut être testé à blanc, ce qui indique ce qui changerait sans rien changer. Un changement portant sur plus de 100 photos à la fois est refusé, sauf si l’agent le confirme.
• Les changements se synchronisent avec vos autres appareils comme vos propres modifications, lorsque la synchronisation iCloud est activée.

Exportation

Les agents n’exportent que dans un dossier de votre choix : réglez Les agents peuvent sur Voir, modifier et exporter, puis cliquez sur Choisir… à côté de Dossier d’exportation. Les agents peuvent y créer des sous-dossiers, mais ne peuvent rien écrire ailleurs.

• Les exportations ne remplacent jamais un fichier. Si DSCF1234.jpg existe déjà, le nouveau s’appelle DSCF1234 2.jpg.
• Une exportation s’exécute en arrière-plan. L’agent peut la suivre et l’arrêter ; les fichiers déjà écrits sont conservés.
• Les exportations des agents sont décomptées des exportations gratuites comme les autres, et une exportation dépassant ce qui reste est refusée avant de commencer.

Importation

Les agents n’importent que depuis un dossier de votre choix : réglez Les agents peuvent sur Voir et modifier ou plus, puis cliquez sur Choisir… à côté de Dossier d’importation. Une carte mémoire ou le dossier où arrivent les photos de votre appareil conviennent très bien.

• Une importation équivaut à celle que vous faites avec le bouton Importer : les RAF déjà présents dans la bibliothèque sont ignorés, et les nouveaux forment la Dernière importation. Sur votre Mac, ils restent à leur emplacement.
• Les agents peuvent importer tout le dossier, ses sous-dossiers ou des fichiers isolés, et ne peuvent rien atteindre en dehors.
• Les fichiers de recette et les images de recettes présents dans le dossier peuvent être lus avec read_recipe.

Requêtes et ressources

Certains clients proposent les prompts MCP comme des tâches toutes prêtes, souvent depuis un menu ou une commande / :

• Match a Look : donner à des photos l’aspect d’une photo de référence, puis affiner chacune.
• Cull Photos : noter, retenir et rejeter selon vos critères, en partant des rafales et des mesures de mise au point, d’exposition et de visages.
• Apply a Recipe from Text : lire une recette rédigée dans une publication ou une note, la vérifier et l’appliquer.

Les clients qui prennent en charge les ressources peuvent joindre des photos et des listes à une conversation : photo://{id} pour les détails d’une photo, photo://{id}/preview pour son aperçu, et library://looks, library://albums et library://recipes.

Raccourcis et Siri

Sur iPhone, iPad et Mac, RAF Film Lab ajoute des actions à l’app Raccourcis : Rechercher des photos, Définir le rendu, Appliquer une recette, Noter des photos, Marquer des photos, Ajouter des photos à l’album, Exporter des photos et Annuler la dernière modification de la bibliothèque. Enchaînez-les : trouvez les photos retenues de la dernière importation, appliquez-leur un rendu, exportez-les, et enregistrez les fichiers là où l’action suivante les place. Certaines fonctionnent aussi avec Siri, comme « Rechercher des photos dans RAF Film Lab ».

Les raccourcis ne dépendent pas du réglage Agents ; c’est vous qui les créez. Leurs changements peuvent être annulés de la même façon.

Confidentialité

• Le serveur n’est pas sur le réseau. Il n’écoute que les programmes de votre Mac, et seulement quand les agents sont activés.
• Ce qu’un agent lit, y compris les aperçus qu’il demande, est transmis au service d’IA qu’utilise votre app d’agent, comme Anthropic pour Claude ou OpenAI pour Codex, selon les conditions de ce service. RAF Film Lab ne nous envoie rien, et les agents ne reçoivent jamais vos fichiers RAF.
• La mesure des photos, la détection des rafales et la lecture des recettes à partir d’images se font sur votre Mac, avec Vision d’Apple.
• Lecture seule permet à un agent de voir votre bibliothèque sans pouvoir la modifier.

Consultez la politique de confidentialité.

Dépannage

« RAF Film Lab n’accepte pas les agents »

L’agent n’a pas pu joindre l’app. Vérifiez que Autoriser les agents IA à utiliser la bibliothèque est activé dans Réglages › Agents, puis reconnectez le serveur dans votre app d’agent (dans Claude Code ou Codex, /mcp ; dans Claude Desktop, redémarrez-le).

L’agent dit qu’il ne peut pas modifier, exporter ou supprimer

Augmentez Les agents peuvent dans Réglages › Agents. L’agent en est informé et voit les nouveaux outils.

« Aucun dossier d’exportation n’est défini » ou « Aucun dossier d’importation n’est défini »

Choisissez-en un à côté de Dossier d’exportation ou de Dossier d’importation dans Réglages › Agents.

Un aperçu ne montre pas encore une modification de recette dans la bibliothèque

La photo est encore en cours de développement en arrière-plan. Son état de développement dans get_photo indique developing jusqu’à la fin, et les exportations l’attendent.

Vous avez déplacé l’app ?

Le chemin de l’utilitaire change avec elle. Copiez à nouveau la commande ou la configuration depuis Réglages › Agents et mettez à jour votre app d’agent.