ガイド ›

AIエージェントとMCP

更新日： 2026-11-04

Macでは、ClaudeやCodexなどのAIエージェントでRAF Film Labを操作できます。エージェントはライブラリを検索し、写真を見て、ルックやレシピ、編集を変更し、選別し、アルバムに整理し、書き出します。すべてアプリ自体と同じ仕組みを通して行われます。変更はその場でアプリに表示され、自分で行った変更と同じように同期され、取り消すこともできます。

依頼できること

エージェントが得意なのは、エディタでは手間のかかる作業です。ルールに基づく作業、たくさんの写真に対する作業、見ては調整することを何度も繰り返す作業など。

自分の言葉で依頼してください。アプリ名を言う必要はありません。RAF Film Labは接続中のエージェントに、写真ライブラリがここにあることを伝えるので、写真、読み込み、レーティング、アルバム、ルック、レシピに関する依頼はRAF Film Labに届きます。

プロンプトの例

探す・見る

• 「最後に読み込んだ写真を5枚見せて」
• 「今週X-T5で撮った写真を何枚読み込んだ？それぞれどのルック？」
• 「写真DSCF1234はどのレシピで撮影した？」

ルックと編集

• 「最後の読み込みから星4の写真を探して、Classic Chromeにして、少し暖かくして。1枚、補正前と補正後を見せて」
• 「このレシピを京都アルバムの写真に適用して：」に続けて、フォーラムの投稿から貼り付けたレシピ、共有リンク、または保存済みのレシピ名を伝えます。
• 「この30枚を、写真DSCF1234と雰囲気をそろえて」
• 「昨日読み込んだ写真をすべて水平補正して、自動トーンをかけて」
• 「土曜日の風景写真の空を少し暗くして、ゆるやかなS字カーブをかけて」
• 「DSCF1234の被写体を明るくして、周りに柔らかいビネットを加えて」
• 「DSCF1234の今の状態をスナップショットとして保存してから、Acrosで試して。比較できるように、Classic Negativeの仮想コピーも作って」

選別と整理

• 「土曜日の読み込みを選別して。ピンぼけはすべて除外、ベスト5を採用にして星5を付けて」
• 「最後の読み込みから連写を見つけて、それぞれ全員の目が開いている一番シャープなコマを残して」
• 「結婚式の写真で、ひどく露出オーバーなのはどれ？」
• 「読み込みフォルダにある新しいRAFを、リスボンというアルバムに読み込んで」
• 「最後の読み込みで採用にした写真を、リスボンという新規アルバムに入れて」

カメラとレシピ

• 「これまでどのカメラで撮ってきた？X-T3にないフィルムシミュレーションはどれ？」
• 「写真DSCF1234のレシピを、グレインを少し強めにしてGolden Hourとして保存して」
• 「カメラのカスタム設定には何が入ってる？まだ持っていないものは保存して」
• 「Golden HourのレシピをカメラのC4に入れて」
• 「Kodachromeのレシピを共有するリンクをちょうだい」
• 「読み込みフォルダにあるこのスクリーンショットのレシピを読み取って保存して」
• 「Golden HourのレシピをX-T5用のX RAW Studioプロファイルとして書き出して」

書き出しと取り消し

• 「Blogアルバムの採用写真をすべて、2048ピクセルでblogフォルダに書き出して」
• 「これまで写真に何を変更した？最後の変更を取り消して」

エージェントが別の場所を探してしまう場合

CodexやClaude Codeのようなコーディングエージェントは、作業中のフォルダにあるファイルも読み取れます。「DSCF1234」のようにファイル名だけを伝えると、Codexはそのフォルダを探すことがあります。たいていは写真と言えば（「写真DSCF1234」）十分で、RAF Film Labと名前を出せば確実です。

これを確実にするには、エージェントアプリに一度伝えておきましょう。常設の指示に次の1行を追加します。Codexなら~/.codex/AGENTS.md、Claude Codeなら~/.claude/CLAUDE.md、Claude Desktopなら個人またはプロジェクトの指示に：

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

エージェントは、アプリがレンダリングしたプレビューを通して各写真を見るので、設定値だけでなく、写真が実際にどう見えるかで判断します。

エージェントはModel Context Protocol（MCP）で接続します。MCPはClaude Desktop、Claude Code、Codexをはじめ多くのAIアプリが対応しているオープンな標準規格です。MCPサーバはMacアプリに組み込まれています。iPhoneとiPadでは、同じアクションをショートカットで使えます。

エージェントをオンにする

エージェントは、オンにするまで使えません。設定（⌘,）を開いてエージェントを探します：

• AIエージェントにライブラリの使用を許可でサーバがオンになります。
• エージェントに許可する操作で、どこまで許可するかを設定します：
  • 表示のみ（デフォルト）：検索、設定の読み取り、プレビューの確認。
  • 表示と編集：上記に加えて、ルック・レシピ・編集の変更、マスクとカーブの追加、スナップショットと仮想コピーの保持、レーティング、フラグ、ラベル、アルバムの作成と名前の変更、レシピの保存と変更、接続中のカメラへのレシピの保存、指定したフォルダからのRAFの読み込み。
  • 表示、編集、書き出し：上記に加えて、指定したフォルダへの写真とレシピファイルの書き出し。
  • 表示、編集、書き出し、削除：上記に加えて、アルバム、レシピ、スナップショットの削除と、ライブラリからの写真の削除。
  接続中のエージェントには、新しいレベルがすぐに反映されます。許可されていない操作は提示されません。
• 状況には、サーバの準備ができているかどうかと、接続中のエージェントが表示されます。

Claude、Codexなどのクライアントを接続する

RAF Film Labには、小さなプログラムraffilmlab-mcpがアプリ内に同梱されています。AIアプリはこれを起動してライブラリとやり取りし、RAF Film Labが起動していなければバックグラウンドで開きます。「設定」›「エージェント」には、アプリのインストール場所に合わせた正確な設定をコピーするボタンがあるので、パスを入力するよりそちらを使ってください。お使いのエージェントアプリを選びます：

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

エージェントができること

エージェントができることは、「設定」で何を許可するかによって決まります。写真のIDはsearch_photosから取得し、変更は一度に最大500枚まで行えます。

エージェントがオリジナルのRAFファイルを変更することはなく、ファイルを読み取るのはあなたが選んだ読み込みフォルダからだけです。ブラシマスクを描いたり、スポットを修復したりはできません。それには写真に直接手を加える必要があるからです。

ルックとレシピ

新しいルックやレシピは、「Film Labで現像」と同じようにMac上のバックグラウンドで改めて現像されるので、ライブラリと書き出しに反映されます。プレビューには、現像が終わる前でもすぐに変更が表示されます。カメラ自身のレンダリングが欲しい場合は、写真を撮影したカメラをCONNECTION MODEをUSB RAW CONV./BACKUP RESTOREに設定して接続し、カメラで現像するようエージェントに依頼してください。変更をそのままカメラで現像することも、後からdevelop_photosでカメラで現像することもできます。現像の様子は「現像」パネルに表示され、そこで一時停止や停止もできます。

取り消しと安全性

• 変更はその場で表示されます。エディタで開いている写真は目の前で更新され、ライブラリのサムネールも追従します。
• 写真とレシピへの変更は取り消せます。エージェントに取り消しを頼むか、エディタで開いている写真なら⌘Zを押します。エージェントの編集は、自分の編集と同じく1つの取り消しステップです。その後で自分が写真やレシピを変更していた場合、取り消してもあなたの変更はそのまま残ります。
• 新規アルバム、読み込み、仮想コピー、削除も取り消せます。取り消すと、エージェントが作ったアルバムや仮想コピーは削除され、読み込みはライブラリから取り除かれ、削除されたアルバム、レシピ、スナップショットは元に戻ります。
• 取り消せないものが3つあります。1つ目はライブラリからの写真の削除です。そのため、エージェントがこれを行えるのは削除を許可した場合だけで、毎回確認が必要です。2つ目は新しいレシピで、「レシピ」で削除するまで残ります。3つ目はカメラに保存したレシピで、スロットにあった内容を置き換えます。置き換え前の内容はまずMacにバックアップされ、カメラが保持しなかった設定があればエージェントが知らせます。
• 取り消しはアプリを開いている間有効です。エージェントによる最後の50件の変更を記憶しています。
• エージェントは事前に確認できます。どの変更もドライランとして試すことができ、実際には変更せずに何が変わるかを示します。一度に100枚を超える写真を変更しようとすると、エージェントが確認しない限り拒否されます。
• 変更は同期されます。iCloud同期がオンなら、自分の編集と同じようにほかのデバイスにも反映されます。

書き出し

エージェントが書き出せるのは、あなたが選んだフォルダだけです。エージェントに許可する操作を表示、編集、書き出しに設定し、書き出しフォルダの横にある選択…をクリックします。エージェントはその中にフォルダを作れますが、それ以外の場所には書き込めません。

• 書き出しでファイルが置き換えられることはありません。DSCF1234.jpgがすでにある場合、新しいファイルはDSCF1234 2.jpgになります。
• 書き出しはバックグラウンドで行われます。エージェントは進行状況を確認したり停止したりでき、すでに書き出されたファイルは残ります。
• エージェントによる書き出しも、ほかの書き出しと同じく無料書き出し枠に数えられます。残り枠を超える書き出しは、開始前に拒否されます。

読み込み

エージェントが読み込めるのは、あなたが選んだフォルダからだけです。エージェントに許可する操作を表示と編集以上に設定し、読み込みフォルダの横にある選択…をクリックします。メモリーカードや、カメラの写真が保存されるフォルダを指定するとよいでしょう。

• 読み込みは「読み込む」ボタンで行うものと同じです。すでにライブラリにあるRAFはスキップされ、新しいものが「最後の読み込み」になります。Macでは、ファイルは元の場所に置かれたままです。
• エージェントはフォルダ全体、その中のフォルダ、個別のファイルを読み込めますが、フォルダの外にあるものにはアクセスできません。
• フォルダ内のレシピファイルやレシピの画像は、read_recipeで読み取れます。

プロンプトとリソース

一部のクライアントでは、MCPのプロンプトを、メニューや/コマンドから使える既製のタスクとして提供しています：

• Match a Look：写真を参照写真の雰囲気に合わせ、1枚ずつ微調整します。
• Cull Photos：連写と、測定したピント・露出・顔を手がかりに、指定した基準でレーティング、採用、除外を行います。
• Apply a Recipe from Text：投稿やメモにテキストで書かれたレシピを読み取り、確認してから適用します。

リソースに対応したクライアントでは、会話に写真やリストを添付できます。写真の詳細はphoto://{id}、プレビューはphoto://{id}/preview、そのほかlibrary://looks、library://albums、library://recipesがあります。

ショートカットとSiri

iPhone、iPad、Macで、RAF Film Labはショートカットアプリにアクションを追加します：写真を探す、ルックを設定、レシピを適用、写真をレーティング、写真にフラグを付ける、写真をアルバムに追加、写真を書き出す、ライブラリの最後の変更を取り消す。これらをつなげて、最後の読み込みの採用写真を探し、ルックを設定し、書き出して、次のアクションが指定する場所にファイルを保存する、といったことができます。「RAF Film Labで写真を探す」のように、Siriで使えるものもあります。

ショートカットは「エージェント」の設定に左右されません。自分で作るものだからです。ショートカットによる変更も、同じように取り消せます。

プライバシー

• サーバはネットワーク上にはありません。Mac上のプログラムからの接続だけを、エージェントがオンの間だけ受け付けます。
• エージェントが読み取った内容（要求したプレビューを含む）は、ClaudeならAnthropic、CodexならOpenAIなど、お使いのエージェントアプリが利用するAIサービスに、そのサービスの規約に従って送られます。RAF Film Labから当社に送られるものは何もなく、エージェントがRAFファイルを受け取ることもありません。
• 写真の測定、連写の検出、画像からのレシピの読み取りは、AppleのVisionを使ってMac上で行われます。
• 「表示のみ」なら、エージェントはライブラリを見ることはできても変更はできません。

プライバシーポリシーをご覧ください。

トラブルシューティング

「RAF Film Lab isn't accepting agents」と表示される

エージェントがアプリに接続できませんでした。「設定」›「エージェント」でAIエージェントにライブラリの使用を許可がオンになっていることを確認し、エージェントアプリでサーバに再接続してください（Claude CodeやCodexでは/mcp、Claude Desktopでは再起動）。

エージェントが変更・書き出し・削除できないと言う

「設定」›「エージェント」でエージェントに許可する操作のレベルを上げてください。エージェントに通知され、新しいツールが使えるようになります。

「No export folder is set」または「No import folder is set」と表示される

「設定」›「エージェント」で、書き出しフォルダまたは読み込みフォルダの横から選択してください。

プレビューに表示されたレシピの変更が、ライブラリにまだ反映されない

写真はまだバックグラウンドで現像中です。完了するまで、get_photoの現像状況はdevelopingと表示され、書き出しは完了を待ちます。

アプリを移動しましたか？

ヘルパーのパスもアプリと一緒に変わります。「設定」›「エージェント」からコマンドまたは設定をもう一度コピーし、エージェントアプリを更新してください。