Einen KI-Assistenten mit MCP verbinden

Mit dem Model Context Protocol (MCP) können Sie einen KI-Assistenten mit Ihrer PixelUnion-Bibliothek verbinden. Danach können Sie zum Beispiel fragen: „Finde Fotos vom Strand aus dem letzten Sommer“ oder „Erstelle ein Album namens Island 2026 mit allen Fotos aus dem Februar“, und der Assistent erledigt das für Sie.

Diese Anleitung verwendet ImmichMCP, ein kostenloses Open-Source-Projekt. Es ist ein Community-Projekt und wird weder von PixelUnion noch vom Immich-Team entwickelt oder unterstützt. Bei Problemen mit ImmichMCP selbst können wir nicht helfen, bei allem, was PixelUnion betrifft, helfen wir Ihnen aber gern.

Bevor Sie beginnen

Bitte lesen Sie dies zuerst. Wenn Sie einen Cloud-KI-Dienst wie Claude oder ChatGPT nutzen, werden die Informationen, die der Assistent aus Ihrer Bibliothek liest, an diesen Dienst gesendet. Dazu können Dateinamen, Daten, Standorte, Namen von Personen und manchmal Vorschaubilder gehören. PixelUnion speichert Ihre Fotos in Europa, aber sobald diese Daten den KI-Dienst erreichen, gelten dessen Datenschutzbedingungen. Wenn alles auf Ihrem eigenen Computer bleiben soll, verwenden Sie ein lokales Modell, zum Beispiel über LM Studio.

Sie benötigen:

• Ihre PixelUnion-Adresse (z. B. https://ihrname.pixelunion.eu)
• Docker Desktop, installiert und gestartet
• Eine KI-App, die MCP unterstützt, wie Claude Desktop oder LM Studio

Schritt 1: API-Schlüssel erstellen

1. Melden Sie sich bei Ihrer PixelUnion-Domain an (z. B. https://ihrname.pixelunion.eu)
2. Klicken Sie auf Ihr Profilsymbol (oben rechts) und gehen Sie zu Kontoeinstellungen
3. Navigieren Sie zu API-Schlüssel und klicken Sie auf Neuer API-Schlüssel
4. Vergeben Sie einen Namen, zum Beispiel „KI-Assistent“
5. Wählen Sie die Berechtigungen. Wir empfehlen, mit reinem Lesezugriff zu beginnen: asset.read, asset.view, album.read, person.read und tag.read. Sie können später einen neuen Schlüssel mit mehr Berechtigungen erstellen, zum Beispiel album.create, damit der Assistent Alben anlegen kann.
6. Klicken Sie auf Erstellen und kopieren Sie den Schlüssel

Sie sehen den Schlüssel nur einmal. Bewahren Sie ihn an einem sicheren Ort auf, zum Beispiel in einem Passwortmanager.

Schritt 2: ImmichMCP zu Claude Desktop hinzufügen

1. Öffnen Sie Claude Desktop
2. Gehen Sie zu Einstellungen → Entwickler und klicken Sie auf Konfiguration bearbeiten
3. Es öffnet sich eine Datei namens claude_desktop_config.json. Fügen Sie Folgendes ein und ersetzen Sie dabei die Adresse und den Schlüssel durch Ihre eigenen:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

{
  "mcpServers": {
    "immich": {
      "command": "docker",
      "args": ["run", "-i", "--rm",
               "-e", "IMMICH_BASE_URL=https://ihrname.pixelunion.eu",
               "-e", "IMMICH_API_KEY=your-api-key",
               "ghcr.io/barryw/immichmcp:latest", "--stdio"]
    }
  }
}

4. Speichern Sie die Datei und starten Sie Claude Desktop vollständig neu

Wenn Claude wieder startet, sehen Sie immich in der Liste der Connectors oder Tools. Der erste Start kann eine Minute dauern, weil Docker ImmichMCP im Hintergrund herunterlädt.

Andere MCP-Apps verwenden eine ähnliche Konfiguration. In der Dokumentation Ihrer App finden Sie, wo Sie einen MCP-Server hinzufügen.

Schritt 3: ausprobieren

Starten Sie einen neuen Chat und stellen Sie eine Frage zu Ihren Fotos, zum Beispiel:

• „Wie viele Fotos habe ich in PixelUnion?“
• „Finde Fotos von einem Sonnenuntergang am Strand“
• „Welche Alben habe ich?“

Der Assistent fragt Sie um Erlaubnis, bevor er ein Tool zum ersten Mal verwendet. Sobald Sie es erlauben, sehen Sie die Ergebnisse im Chat.

Tipps

• Löschen ist geschützt. ImmichMCP löscht Fotos oder Alben nur, wenn die Anfrage dies ausdrücklich bestätigt. Lesen Sie trotzdem, was der Assistent vorhat, bevor Sie einen Tool-Aufruf genehmigen.
• Ihr API-Schlüssel wird im Klartext in der Konfigurationsdatei gespeichert. Geben Sie diese Datei nicht weiter und verwenden Sie diese Einrichtung nicht auf einem gemeinsam genutzten Computer.
• Beenden Sie den Zugriff jederzeit, indem Sie den API-Schlüssel unter Kontoeinstellungen → API-Schlüssel löschen. Der Assistent verliert sofort den Zugriff.
• Es passiert nichts? Prüfen Sie, ob Docker Desktop läuft und ob Ihre PixelUnion-Adresse mit https:// beginnt.

Wir prüfen, ob wir MCP künftig direkt über PixelUnion anbieten, ohne Docker oder API-Schlüssel in einer Datei. Entschieden haben wir das noch nicht. Wenn Sie Feedback haben, kontaktieren Sie uns.