インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Immich をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
AI に Immich の写真ライブラリを読み取らせましょう。写真と動画の件数、アルバムとその共有先、写真の日付・場所・カメラ・写っている人物、Immich が認識した人物、月ごとの撮影枚数などを取得できます。読み取り専用で、アップロード、編集、削除は一切行いません。セルフホストの Immich 3.0 以降に対応しています。
こう聞いてみよう
Immich のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要。cloud.anythingmcp.com をそのままお使いください。 サインインし、Connectors → Immich をクリックして認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要です。
Immich
AI に Immich の写真ライブラリを読み取らせましょう。写真と動画の件数、アルバムとその共有先、写真の日付・場所・カメラ・写っている人物、Immich が認識した人物、月ごとの撮影枚数などを取得できます。読み取り専用で、アップロード、編集、削除は一切行いません。セルフホストの Immich 3.0 以降に対応しています。
セットアップ
セットアップには約 3 分かかります。Immich 3.0 以降と、AI に読み取らせたいライブラリを持つユーザーの API キーが必要です。管理者アカウントは不要です。
IMMICH_URLに、Immich を開くときのアドレスを設定します。/apiや末尾のスラッシュは付けません。例:https://photos.example.comやhttp://192.168.1.10:2283（デフォルトのポートは 2283 です）。- そのユーザーとして Immich にログインし、Account Settings → API Keys → New API Key を開いて、
user.read、asset.read、asset.statistics、album.read、person.readのみを付与します。キーをIMMICH_API_KEYにコピーします。Immich がキーを表示するのは一度きりです。キーはx-api-keyヘッダーで送信されます。 - コネクターをインストールして
immich_get_my_userを実行します。キーに紐づくユーザーと、そのストレージのクォータおよび使用量が表示されます。
Immich の動作場所: セルフホストの AnythingMCP では、Immich は通常、自宅サーバーや NAS（http://192.168.x.x:2283）で動いています。外向きの SSRF ガードはデフォルトでプライベートアドレスとローカルアドレスをブロックするため、管理者が SSRF_ALLOWED_HOSTS または管理設定の許可リストでそのホストを許可する必要があります。AnythingMCP Cloud から接続できるのは、リバースプロキシの背後などで、公開インターネット上に HTTPS で公開されている Immich サーバーのみです。プライベート IP やローカルホスト名は拒否され、Cloud では許可リストを変更できません。
読み取れる内容: immich_get_asset_statistics による写真と動画の件数（フィルターなしの場合、ゴミ箱以外のすべてのアセットがアーカイブ済みも含めてカウントされます。visibility=timeline はメインのタイムラインと一致します）、アルバムとその共有先（immich_list_albums、immich_get_album）、日付・カメラ・レンズ・露出・GPS・市区町村・国・人物・タグを含む 1 件の写真または動画（immich_get_asset）、名前による認識済み人物（immich_search_people）、座標付きの場所名による検索（immich_search_places）、人物・アルバム・タグ・お気に入り別の月ごとの件数（immich_get_timeline_buckets）です。すべての ID は UUID です。
プライバシー: Immich のキーから見えるのは、そのキーを作成したユーザーのライブラリと、そのユーザーに共有されたアルバムだけです。つまり、そのユーザーの写真、顔、位置情報が対象です。このコネクターは、このライブラリを閲覧してよいユーザーが使う MCP サーバーにのみ割り当ててください。サーバー上のファイルパス、チェックサム、thumbhash、OAuth ID、ライセンスキーは回答から除外されます。
よくあるエラー: 401 はキーが間違っているか削除されたことを意味します。401 "Elevated permission is required" は、API キーでは読み取れないロックされたフォルダーを指します。403 "Missing required permission" は、キーに 5 つの権限のいずれかが不足していることを意味します。400 "Not found or no ... access" は、このライブラリにその ID のアセットまたはアルバムが存在しないことを意味します（Immich は 404 ではなく 400 を返します）。400 "Validation failed" は、ID が UUID でない、許可されていない値がある、または人物検索や場所検索で name が指定されていないことを意味します。すべての呼び出しで 404 になる場合は、IMMICH_URL が間違っているか、末尾が /api になっています。
このコネクターは読み取り専用です。アセットのアップロード、編集、お気に入り登録、アーカイブ、ゴミ箱への移動、削除、アルバム・タグ・人物の変更、オリジナル・サムネイル・動画のダウンロード、スマート検索やメタデータ検索の実行、ロックされたフォルダー・共有リンク・メモリー・管理者向けエンドポイント・API キー管理へのアクセスは行いません。
前提条件: IMMICH_URL、IMMICH_API_KEY
コネクターをローカルにインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
http://localhost:3000/connectors/store を開き、Immich を選んで、前提条件に記載した環境変数を貼り付けます。
利用可能なツール
| Tool | What it does |
|---|---|
immich_get_my_user | API キーに紐づく Immich ユーザーを取得します: ID、名前、メールアドレス、管理者かどうか、ストレージのクォータと使用量（バイト単位） |
immich_get_asset_statistics | ライブラリ内の写真と動画の件数を取得します: {images, videos, total} |
immich_list_albums | このユーザーが所有する、またはこのユーザーに共有されているアルバムを一覧表示します。ID、名前、説明、アセット数、共有フラグ、日付範囲などに要約されます… |
immich_get_album | ID で 1 つのアルバムを取得します: 名前、説明、アセット数、最初と最後の写真の日付、サムネイルのアセット ID、共有状況、各メンバーとそのロール |
immich_get_asset | ID で 1 件の写真または動画を取得します: ファイル名、種類、撮影日とアップロード日、お気に入り・アーカイブ・ゴミ箱の状態、EXIF データ（カメラ、レンズ… |
immich_search_people | Immich が顔で認識した人物を名前で検索します: ID、名前、生年月日、お気に入りと非表示のフラグ |
immich_get_timeline_buckets | 月ごとのアセット数を取得します: アセットがある月ごとに 1 つの {timeBucket, count} を新しい順に返します。timeBucket はその月の初日です… |
immich_search_places | Immich 内蔵のジオコーディングデータから場所を名前で検索します: 名前、地域（admin1name、admin2name）、緯度と経度。例えば場所を特定するのに… |
次のステップ
このガイドは役に立ちましたか?