가이드 ›

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으로 바꾸고 조금 따뜻하게 해 줘. 하나는 전후 비교로 보여 줘.”
• “이 레시피를 교토 앨범의 사진에 적용해 줘:” 뒤에 포럼 게시물에서 복사한 레시피, 공유 링크, 또는 저장한 레시피 이름을 붙이세요.
• “이 사진 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을 언급하면 항상 해결됩니다.

확실히 해 두려면 에이전트 앱에 한 번만 알려 주세요. 상시 지침에 다음 줄을 추가하세요. 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.

에이전트는 앱이 렌더링한 미리보기로 각 사진을 보므로, 설정값만이 아니라 사진이 실제로 어떻게 보이는지 판단합니다.

에이전트는 Claude Desktop, Claude Code, Codex를 비롯한 많은 AI 앱이 지원하는 개방형 표준인 Model Context Protocol(MCP)로 연결됩니다. 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를 누르세요. 에이전트의 편집도 직접 한 편집처럼 하나의 실행 취소 단계입니다. 그 뒤에 사진이나 레시피를 직접 변경했다면, 실행 취소는 내 변경을 건드리지 않습니다.
• 새 앨범, 가져오기, 가상 사본, 삭제도 마찬가지입니다. 실행 취소하면 에이전트가 만든 앨범이나 가상 사본이 삭제되고, 가져온 사진이 라이브러리에서 빠지며, 삭제된 앨범, 레시피, 스냅샷이 복원됩니다.
• 실행 취소가 적용되지 않는 세 가지. 라이브러리에서 사진 제거: 그래서 에이전트는 삭제를 허용한 경우에만 할 수 있고, 매번 확인해야 합니다. 새 레시피: 레시피에서 삭제할 때까지 남아 있습니다. 카메라에 저장한 레시피: 슬롯의 기존 내용을 대체하며, 기존 내용은 먼저 Mac에 백업되고, 카메라가 유지하지 않은 설정이 있으면 에이전트가 알려 줍니다.
• 실행 취소는 앱이 열려 있는 동안 유지됩니다. 에이전트가 한 최근 50개의 변경을 기억합니다.
• 에이전트는 먼저 확인할 수 있습니다. 모든 변경은 실제로 바꾸지 않고 무엇이 바뀔지만 알려 주는 시험 실행으로 해 볼 수 있습니다. 한 번에 100장이 넘는 사진을 변경하려면 에이전트가 확인해야 하며, 그렇지 않으면 거부됩니다.
• 변경 사항은 동기화됩니다. iCloud 동기화가 켜져 있으면 직접 한 편집처럼 다른 기기에도 반영됩니다.

내보내기

에이전트는 지정한 폴더로만 내보냅니다. 에이전트 권한을 보기, 편집 및 내보내기로 설정한 다음 내보내기 폴더 옆의 선택…을 클릭하세요. 에이전트는 그 안에 폴더를 만들 수 있지만, 다른 곳에는 쓸 수 없습니다.

• 내보내기는 파일을 절대 덮어쓰지 않습니다. DSCF1234.jpg가 이미 있으면 새 파일은 DSCF1234 2.jpg가 됩니다.
• 내보내기는 백그라운드에서 실행됩니다. 에이전트는 진행 상황을 확인하고 중단할 수 있으며, 이미 저장된 파일은 그대로 남습니다.
• 에이전트의 내보내기도 다른 내보내기와 마찬가지로 무료 내보내기 횟수에 포함되며, 남은 횟수보다 많은 내보내기는 시작 전에 거부됩니다.

가져오기

에이전트는 지정한 폴더에서만 가져옵니다. 에이전트 권한을 보기 및 편집 이상으로 설정한 다음 가져오기 폴더 옆의 선택…을 클릭하세요. 메모리 카드나 카메라 사진이 저장되는 폴더를 지정하면 편리합니다.

• 가져오기 버튼으로 가져올 때와 같습니다. 이미 라이브러리에 있는 RAF는 건너뛰고, 새 RAF가 마지막 가져오기가 됩니다. Mac에서는 파일이 원래 위치에 그대로 있습니다.
• 에이전트는 폴더 전체, 하위 폴더, 개별 파일을 가져올 수 있으며, 폴더 밖의 항목에는 접근할 수 없습니다.
• 폴더에 있는 레시피 파일과 레시피 사진은 read_recipe로 읽을 수 있습니다.

프롬프트와 리소스

일부 클라이언트는 MCP 프롬프트를 미리 만들어진 작업으로 제공하며, 주로 메뉴나 / 명령으로 실행합니다.

• Match a Look: 사진을 참조 사진처럼 보이게 한 다음 한 장씩 미세 조정합니다.
• 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에 있는 프로그램의 요청만, 그리고 에이전트가 켜져 있는 동안에만 수신합니다.
• 에이전트가 읽는 내용은 요청한 미리보기를 포함해, 에이전트 앱이 사용하는 AI 서비스(예: Claude는 Anthropic, Codex는 OpenAI)로 해당 서비스의 약관에 따라 전송됩니다. 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으로 표시되며, 내보내기는 현상이 끝날 때까지 기다립니다.

앱을 옮겼나요?

도우미의 경로도 함께 바뀝니다. 설정 › 에이전트에서 명령이나 구성을 다시 복사해 에이전트 앱을 업데이트하세요.