Immich MCP mit Microsoft Copilot 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 + Microsoft Copilot

Lass deine KI deine Immich-Fotobibliothek lesen: wie viele Fotos und Videos du hast, deine Alben und mit wem sie geteilt sind, 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 nichts hoch, bearbeitet nichts und 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 dessen Speicherkontingent und -nutzung.

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 werden alle Assets gezählt, die nicht im Papierkorb liegen, einschließlich archivierter; visibility=timeline entspricht der Haupt-Timeline); Alben und mit wem sie geteilt sind (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 die mit diesem Benutzer geteilten Alben, und das bedeutet deren Fotos, Gesichter und Standorte. Weise diesen Connector nur MCP-Servern zu, deren Benutzer diese Bibliothek sehen dürfen. Dateipfade des Servers, 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“ bezieht sich auf 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 name bei einer Personen- oder Ortssuche 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, favorisiert, archiviert oder löscht sie nicht und verschiebt sie nicht in den Papierkorb, ä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 Microsoft Copilot 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/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Immich-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

Verfügbare Tools

FAQ

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Landingpage
• Mit Claude verbinden
• Mit ChatGPT verbinden