Immich MCP mit ChatGPT verbinden

💡 Keine Installation? Nutze direkt cloud.anythingmcp.com. Melde dich an, klicke auf Connectors → Immich, füge deine Zugangsdaten ein, erstelle einen MCP-API-Key — fertig. Kein Docker, kein git clone, kein lokaler Server.

Immich + ChatGPT

Lass deine KI deine Immich-Fotobibliothek lesen: wie viele Fotos und Videos du hast, deine Alben und mit wem sie geteilt werden, Datum, Ort, Kamera und Personen eines Fotos, die von Immich erkannten Personen und wie viele Bilder pro Monat aufgenommen wurden. Nur lesend: Es lädt nie etwas hoch, bearbeitet oder löscht nichts. Funktioniert mit self-hosted Immich 3.0 oder neuer.

Voraussetzungen

Die vollständige Einrichtungsanleitung ist im Connector enthalten (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:

IMMICH_URL, IMMICH_API_KEY

Schritt 1 — Zugangsdaten besorgen

Die Einrichtung dauert etwa 3 Minuten. Du brauchst Immich 3.0 oder neuer und einen API-Key des Benutzers, dessen Bibliothek die KI lesen soll. Ein Admin-Konto ist nicht nötig.

1. Setze IMMICH_URL auf die Adresse, unter der du Immich öffnest, ohne /api und ohne abschließenden Schrägstrich, zum Beispiel https://photos.example.com oder http://192.168.1.10:2283 (der Standardport ist 2283).
2. Melde dich bei Immich als dieser Benutzer an, öffne Account Settings → API Keys → New API Key und vergib nur user.read, asset.read, asset.statistics, album.read und person.read. Kopiere den Key in IMMICH_API_KEY; Immich zeigt ihn nur einmal an. Er wird im Header x-api-key gesendet.
3. Installiere den Connector und führe immich_get_my_user aus: Das Tool zeigt den Benutzer hinter dem Key sowie sein Speicherkontingent und den Verbrauch.

Wo Immich läuft: Bei self-hosted AnythingMCP läuft Immich meist auf einem Heimserver oder NAS (http://192.168.x.x:2283). Der ausgehende SSRF-Schutz blockiert standardmäßig private und lokale Adressen, daher muss ein Administrator den Host über SSRF_ALLOWED_HOSTS oder die Allowlist in den Admin-Einstellungen freigeben. AnythingMCP Cloud kann nur einen Immich-Server erreichen, der über HTTPS im öffentlichen Internet erreichbar ist, zum Beispiel hinter einem Reverse Proxy. Eine private IP oder ein lokaler Hostname wird abgelehnt, und die Allowlist kann in der Cloud nicht geändert werden.

Was gelesen wird: Anzahl der Fotos und Videos mit immich_get_asset_statistics (ohne Filter zählt es alle Assets, die nicht im Papierkorb sind, einschließlich archivierter; visibility=timeline entspricht der Haupt-Timeline); Alben und mit wem sie geteilt werden (immich_list_albums, immich_get_album); ein einzelnes Foto oder Video mit Datum, Kamera, Objektiv, Belichtung, GPS, Stadt, Land, Personen und Tags (immich_get_asset); erkannte Personen nach Namen (immich_search_people); Orte nach Namen mit Koordinaten (immich_search_places); und Anzahlen pro Monat nach Person, Album, Tag oder Favoriten (immich_get_timeline_buckets). Alle IDs sind UUIDs.

Datenschutz: Ein Immich-Key sieht nur die Bibliothek des Benutzers, der ihn erstellt hat, plus Alben, die mit diesem Benutzer geteilt wurden – und damit dessen Fotos, Gesichter und Standorte. Weise diesen Connector nur MCP-Servern zu, deren Benutzer diese Bibliothek sehen dürfen. Dateipfade auf dem Server, Prüfsummen, Thumbhashes, OAuth-IDs und Lizenzschlüssel werden aus den Antworten entfernt.

Häufige Fehler: 401 bedeutet, dass der Key falsch ist oder gelöscht wurde; 401 „Elevated permission is required" betrifft den gesperrten Ordner, den ein API-Key nicht lesen kann. 403 „Missing required permission" bedeutet, dass dem Key eine der fünf Berechtigungen fehlt. 400 „Not found or no ... access" bedeutet, dass es in dieser Bibliothek kein Asset und kein Album mit dieser ID gibt (Immich antwortet mit 400, nicht mit 404). 400 „Validation failed" bedeutet, dass eine ID keine UUID ist, ein Wert nicht erlaubt ist oder bei einer Personen- oder Ortssuche name fehlt. 404 bei jedem Aufruf bedeutet, dass IMMICH_URL falsch ist oder auf /api endet.

Der Connector ist nur lesend: Er lädt keine Assets hoch, bearbeitet sie nicht, markiert sie nicht als Favoriten, archiviert sie nicht, verschiebt sie nicht in den Papierkorb und löscht sie nicht, ändert keine Alben, Tags oder Personen, lädt keine Originale, Thumbnails oder Videos herunter, führt keine Smart- oder Metadatensuche aus und öffnet weder den gesperrten Ordner noch geteilte Links, Erinnerungen, Admin-Endpunkte oder die API-Key-Verwaltung.

Schritt 2 — Adapter installieren

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

Schritt 3 — Connector in ChatGPT hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Verwende sie überall dort, wo diese Anleitung YOUR_SERVER_ID zeigt.

ChatGPT fügt MCP-Server als Plugins auf der Seite Plugins hinzu, im Web und in kostenpflichtigen Tarifen. Der Entwicklermodus ist nicht mehr nötig. In einem Business-Workspace können nur Admins und Owner einen hinzufügen; in Enterprise und Edu kann ein Admin die Berechtigung Create plugins with MCPs vergeben.

1. Gehe zu chatgpt.com/plugins, klicke auf Add und dann auf Add custom MCP server.
2. Gib einen Namen ein, z. B. Name: Immich.
3. Gib unter Connection als Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein und lass Authentication auf OAuth.
4. Wähle I understand and want to continue und dann Create as a plugin. Wenn ChatGPT dich dazu auffordert, melde dich bei AnythingMCP an und erlaube den Zugriff.
5. Installiere das neue Plugin aus deinen persönlichen Plugins, tippe dann in einem Chat @ und wähle es aus.

Verfügbare Tools

FAQ

Funktioniert der kostenlose ChatGPT-Tarif mit eigenen MCP-Servern? OpenAI dokumentiert eigene MCP-Server nur für kostenpflichtige Tarife; der Free-Tarif steht nicht auf der Liste.

Nächste Schritte

• Connector-Landingpage
• Mit Claude verbinden