概要
AIがImmichのフォトライブラリを読み取れるようにします。写真と動画の数、アルバムとその共有先、写真の日付・場所・カメラ・写っている人物、Immichが認識した人物、毎月の撮影枚数を取得できます。読み取り専用で、アップロード、編集、削除は一切行いません。セルフホスト版のImmich 3.0以降で動作します。
ガイド付きセットアップ
Immich を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Immich を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Immich のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要: cloud.anythingmcp.com をそのまま使えます。 サインインして Connectors → Immich をクリックし、認証情報を貼り付けて MCP API キーを発行するだけです。Docker も
git cloneもローカルサーバーも不要です。
Immich + Microsoft Copilot
AIがImmichのフォトライブラリを読み取れるようにします。写真と動画の数、アルバムとその共有先、写真の日付・場所・カメラ・写っている人物、Immichが認識した人物、毎月の撮影枚数を取得できます。読み取り専用で、アップロード、編集、削除は一切行いません。セルフホスト版のImmich 3.0以降で動作します。
前提条件
コネクターに組み込まれているセットアップ手順の全文をご確認ください(コネクターを選択すると、アプリ内ストアに表示されます)。このコネクターに必要な環境変数は次のとおりです。
IMMICH_URL, IMMICH_API_KEY
ステップ1 — 認証情報を取得する
セットアップには約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 で、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 — Microsoft Copilotにコネクターを追加する
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。
- Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name（例:
AnythingMCP）、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
Immichのツールが必要になる依頼をしてみましょう。 - Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。
ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| ツール | 機能 |
|---|---|
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 | 月ごとのアセット数を数えます: アセットがある月ごとに {timeBucket, count} を新しい順に返します。timeBucket は月の初日です… |
immich_search_places | Immichに組み込まれたジオコーディングデータから場所を名前で検索します: 名前、地域(admin1name、admin2name)、緯度と経度。たとえば場所を特定するときに… |
FAQ
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?