将 Immich MCP 连接到 Microsoft Copilot

💡 不想安装?直接使用 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 或更高版本,以及一个来自用户的 API 密钥,AI 将读取该用户的照片库。无需管理员账号。

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、城市、国家、人物和标签(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" 表示密钥缺少这五项权限之一。400 "Not found or no ... access" 表示此照片库中不存在该 id 对应的资产或相册(Immich 返回的是 400,而不是 404)。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 支持这种方式。

1. 在 Copilot Studio 中打开你的智能体（或新建一个），进入 Tools，选择 Add a tool → New tool → Model Context Protocol。
2. 填写 Server name（例如 AnythingMCP）、说明连接器用途的 Server description，以及 Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。
3. 身份验证选择 API key，把 Type 设为 Header，请求头名称填 X-API-Key，然后选择 Create。
4. 在 Add tool 中选择 Create a new connection，粘贴 AnythingMCP 的 MCP API 密钥（MCP Servers → 你的服务器 → API keys），然后选择 Add to agent。
5. 在智能体的 Test 窗格中试一试：提出需要用到 Immich 的工具的请求。
6. 选择 Publish，然后进入 Channels → Microsoft 365 and Microsoft Teams，保持勾选 Make agent available in Microsoft Copilot，再选择 Add channel。See agent in Teams 会为你安装该智能体；在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。

希望每个用户各自登录？请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥：每个用户会在智能体首次调用时登录 AnythingMCP。

自托管？请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接，因此 localhost 无法使用。

可用工具

常见问题

这适用于哪个 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" 即可使用新版本。

后续步骤

• 连接器落地页
• 连接到 Claude
• 连接到 ChatGPT