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

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

Immich + Cursor

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 で、1枚の写真または動画の日付、カメラ、レンズ、露出、GPS、市区町村、国、人物、タグは immich_get_asset で取得します。認識された人物は名前で immich_search_people、場所は名前と座標で immich_search_places を使って検索します。人物、アルバム、タグ、お気に入り別の月ごとの件数は immich_get_timeline_buckets で取得します。すべての ID は UUID です。

プライバシー: ImmichのキーからはキーIDを作成したユーザーのライブラリと、そのユーザーに共有されているアルバムだけが見えます。つまり、そのユーザーの写真、顔、位置情報が対象です。このコネクターは、このライブラリの閲覧を許可されたユーザーがいる 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 — Cursorにコネクターを追加する

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう — エージェントが Immich のツールを呼び出せるようになりました。

利用可能なツール

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい — MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

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