Immich MCPをChatGPTに接続：写真とアルバム

💡 インストール不要。cloud.anythingmcp.com をそのままご利用いただけます。 サインインして Connectors → Immich をクリックし、認証情報を貼り付けて MCP APIキーを発行するだけです。Docker も git clone もローカルサーバーも不要です。

Immich + ChatGPT

AIにImmichのフォトライブラリを読み取らせましょう。写真と動画の数、アルバムとその共有先、写真の日付・場所・カメラ・写っている人物、Immichが認識した人物、毎月撮影された写真の枚数を確認できます。読み取り専用で、アップロード、編集、削除は一切行いません。セルフホスト版のImmich 3.0以降で動作します。

前提条件

コネクタに組み込まれているセットアップ手順の全文を参照してください(アプリ内ストアでコネクタを選択すると表示されます)。このコネクタに必要な環境変数は次のとおりです。

IMMICH_URL, IMMICH_API_KEY

ステップ 1 — 認証情報を取得する

セットアップには約3分かかります。Immich 3.0以降と、AIに読み取らせたいライブラリを持つユーザーのAPIキーが必要です。管理者アカウントは不要です。

1. IMMICH_URL には、Immichを開くときのアドレスを設定します。/api や末尾のスラッシュは付けません。例: https://photos.example.com や http://192.168.1.10:2283(デフォルトのポートは2283です)。
2. そのユーザーとして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 ヘッダーで送信されます。
3. コネクタをインストールして 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のキーからはキーをUndefined作成したユーザーのライブラリと、そのユーザーに共有されたアルバムのみが見えます。つまり、そのユーザーの写真、顔、位置情報が対象です。このコネクタは、このライブラリを閲覧してよいユーザーが使う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キー管理へのアクセスは行いません。

ステップ 2 — アダプターをインストールする

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

ステップ 3 — ChatGPTにコネクタを追加する

あなたのサーバーURL: AnythingMCPで MCP Servers を開き、このコネクタが属するサーバーのURL(https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドで YOUR_SERVER_ID と書かれている箇所では、そのURLを使用してください。

ChatGPTでは、MCPサーバーを Plugins ページからプラグインとして追加します。Web版かつ有料プランで利用できます。開発者モードはもう必要ありません。Businessワークスペースでは、追加できるのは管理者とオーナーのみです。EnterpriseとEduでは、管理者が Create plugins with MCPs 権限を付与できます。

1. chatgpt.com/plugins にアクセスし、Add をクリックして、Add custom MCP server を選択します。
2. 名前を入力します。例: Name: Immich。
3. Connection の下で、Server URL に https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力し、Authentication は OAuth のままにします。
4. I understand and want to continue を選択し、Create as a plugin をクリックします。ChatGPTから求められたら、AnythingMCPにサインインしてアクセスを許可します。
5. 新しいプラグインを個人用プラグインからインストールし、チャットで @ を入力して選択します。

利用可能なツール

FAQ

無料のChatGPTプランでカスタムMCPサーバーは使えますか? OpenAIのドキュメントでは、カスタムMCPサーバーは有料プランのみが対象で、Freeプランは対象に含まれていません。

次のステップ

• コネクタのランディングページ
• Claudeに接続する