将 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、城市、国家、人物和标签(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 步 — 在 ChatGPT 中添加连接器

你的服务器 URL: 在 AnythingMCP 中,打开 MCP Servers → 此连接器所在的服务器,复制其 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都使用它。

ChatGPT 在其 Plugins 页面上以插件形式添加 MCP 服务器,支持网页端和付费套餐。不再需要开发者模式。在 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. 从你的个人插件中安装新插件,然后在聊天中输入 @ 并选择它。

可用工具

常见问题

免费版 ChatGPT 能使用自定义 MCP 服务器吗? OpenAI 的文档仅说明付费套餐支持自定义 MCP 服务器;免费套餐不在其列表中。

后续步骤

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