プロンプトひとつで写真ライブラリを操作する

imagic MaxにはMCPサーバーが付属するので、Claude Code、Claude Desktop、Cursor、Codexが、撮影のスキャン、セレクト、各コマのグレーディング、採用写真の書き出しを行えます。その間、ブラウザーのライブ画面で、すべての編集が反映される様子を見られます。

RAWホバーでimagicの編集を見る
編集: imagic タップでRAWを見る

実際の様子

夕暮れの、実際の711枚の撮影の記録されたセッション。編集前と後の画像は本物のimagicのレンダリングで、調整値も実際に適用されたものです。ライブラリには、その撮影のシーンのコマが並んでおり、どれをクリックしても、その編集内容を確認できます。

ライブセッション imagic
↵
Bypass permissions MCP
imagicのライブプレビュー +
← →127.0.0.1:8765
imagicAIエージェントからのライブ 待機中
編集中—
エージェントが写真の編集を始めるのを待っています。
編集前編集後
ライブラリ
セッション全体を再生中

セットアップ

四つの手順で、約五分です。最初の二つは一度だけで済みます。

imagicをインストールして認証する

MCPサーバーはimagic Maxに含まれます。エクスポート500回の無料トライアルにも含まれるので、購入前にこの手順を試せます。アプリを一度起動してキーを入力してください。エージェントはその認証を再利用し、認証がない間は、ヘッドレス実行は拒否されます。

エージェントにimagicを登録する

コマンドは一つ。インストール済みのアプリを--mcpフラグで指定します。

macOS
claude mcp add imagic -- /Applications/imagic.app/Contents/MacOS/imagic --mcp
Windows
claude mcp add imagic -- "C:\Program Files\imagic\imagic.exe" --mcp
pip install
claude mcp add imagic -- imagic-mcp

Cursor、Codex、Copilot、Claude Desktopも、それぞれの設定ファイルで同じコマンドと引数を使います。設定リファレンスをご覧ください。

やりたいことを頼む

普通の言葉で大丈夫です。ツールはエージェントが選ぶので、名前を指定する必要はありません。

この撮影をセレクトして、会場の照明に合わせて採用写真をグレーディングして、
元ファイルの隣のフォルダーに書き出して。

スキャンし、すべてのコマを採点して、採用・要確認・除外に仕分けし、そのあと編集と書き出しを行います。大きな撮影では、先に分析させて、確定する前に枚数を見せてもらうようにしてください。

動きを見る

サーバーが起動すると同時に、ローカルのプレビューが開きます。何もアップロードされません。表示はお使いのパソコンから行われます。

http://127.0.0.1:8765

すべてのコマが、フル解像度の編集前後スライダーと、エージェントが呼び出したツールのログとともに表示されます。編集が思わぬ方向へ進んでいるのを、まだ軌道修正できるうちに見つけるには、これが最も早い方法です。

ChatGPTやClaude.aiからimagicを使う

この二つは、ローカルの設定ファイルでは動きません。imagicは常時稼働する小さな中継を通じてペアリングするため、ブラウザーでの手順と、6桁のコードを使います。

imagicでリモートコントロールをオンにする

imagicのホーム画面で、リモートコントロールをオンにします。6桁のコードが表示されます。作業中は、imagicを開いたままにしてください。

imagicをカスタムアプリまたはコネクターとして追加する

ChatGPT(ウェブ、chatgpt.com):Settings › Security and login › Developer modeの順に進み、Plugins › Add › Create MCP Appで、URLにhttps://mcp.imagic.ink/mcp、AuthenticationにOAuthを指定します。Claude.ai:Settings › Connectors › Add custom connectorで、同じURLを指定します。

コードを入力する

imagicのページが開き、ステップ一で表示された6桁のコードを求められます。入力すると、二つがペアリングされます。ChatGPTはメッセージの合間にアプリを外してしまうことがあるので、imagicが見えないと言われたら、+メニューでもう一度チェックを入れてください。

imagic 1.4以降と、Maxプランまたは有効なトライアルが必要です(上記のローカルクライアントと同じです)。詳しい手順:ChatGPTの設定 · Claude.aiの設定。

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

二十一個のツールを、用途別に分けました。名前で呼ぶことはほとんどありません。これらは、エージェントが選ぶ候補です。

段階ツール内容
取り込みscan_directoryRAWまたはJPEGのフォルダーをライブラリに取り込みます。再スキャンしても安全です。
セレクトanalyze_photos, reselect_photosシャープネス、露出、構図を採点し、重複を見つけ、採用・要確認・除外に仕分けます。選び直しは、保存済みのスコアからすぐに順位を付け直します。
確認list_photos, get_photo, set_photo_status, get_library_stats確認と上書きができます。手動での採用/除外の判断は、再セレクトしても必ず残ります。
編集apply_adjustments, apply_preset, list_presets, get_photo_editsコマごとのスライダー調整や、名前の付いたルック。すべてimagicの通常の編集履歴に入るので、確認も取り消しもできます。
スタイルstart_style_calibration, record_style_calibration, learn_style_from_library, apply_my_style, get_style_profile, match_style_from_examples短いキャリブレーションセッション、またはすでに編集した写真から、あなたの編集のしかたをimagicに教えます。
品質check_score_freshness, reanalyze_stale_photos古いバージョンのAIで採点された写真を見つけて、再実行します。
書き出しexport_photos編集内容を、指定したフォルダーに書き出します。

知っておきたいこと

何もパソコンの外に出ません。MCPサーバー、プレビュー、レンダリングは、すべてローカルで動きます。エージェントが送るのは指示だけで、写真はそのままです。
編集は非破壊です。エージェントが行う調整は、デスクトップのエディターであなたが行う調整と同じ方法で保存されます。あとでimagicで写真を開いて、気に入らない部分を変更できます。
iCloudの写真は、先にダウンロードされます。撮影データがiCloud同期のフォルダーにあり、ファイルが退避されている場合、macOSは読み取る前に一つずつ取得するため、大量の読み込みが止まったように見えます。先にFinderでフォルダーを選び、今すぐダウンロードを実行してください。
自動化の前に認証を。ヘッドレスとMCPの実行には、認証済みのimagic Maxライセンスが必要です。エージェントからライセンスが未認証だと報告されたら、imagicアプリを一度開いて認証し、もう一度試してください。

ご自身の撮影データで試す

エクスポート500回のトライアルは、MCPサーバーも含むimagic Maxの全機能です。カードは不要です。

無料トライアルを始める