Een AI-assistent koppelen met MCP

Met het Model Context Protocol (MCP) kun je een AI-assistent koppelen aan je PixelUnion-bibliotheek. Je kunt dan dingen vragen als “zoek foto’s van het strand van afgelopen zomer” of “maak een album met de naam IJsland 2026 met alle foto’s uit februari”, en de assistent doet het voor je.

Deze handleiding gebruikt ImmichMCP, een gratis open-sourceproject. Het is een communityproject, niet gebouwd of ondersteund door PixelUnion of het Immich-team. We kunnen niet helpen met problemen in ImmichMCP zelf, maar we helpen je graag met de kant van PixelUnion.

Voordat je begint

Lees dit eerst. Als je een AI-dienst in de cloud gebruikt, zoals Claude of ChatGPT, wordt de informatie die de assistent uit je bibliotheek leest naar die dienst gestuurd. Dat kan gaan om bestandsnamen, datums, locaties, namen van personen en soms voorbeeldafbeeldingen. PixelUnion bewaart je foto’s in Europa, maar zodra deze gegevens bij de AI-dienst aankomen, gelden hun privacyvoorwaarden. Wil je dat alles op je eigen computer blijft, gebruik dan een lokaal model, bijvoorbeeld via LM Studio.

Wat je nodig hebt:

• Je PixelUnion-adres (bijv. https://jouwnaam.pixelunion.eu)
• Docker Desktop, geïnstalleerd en actief
• Een AI-app die MCP ondersteunt, zoals Claude Desktop of LM Studio

Stap 1: een API-sleutel aanmaken

1. Log in op je PixelUnion-domein (bijv. https://jouwnaam.pixelunion.eu)
2. Klik op je profielicoon (rechtsboven) en ga naar Accountinstellingen
3. Ga naar API-sleutels en klik op Nieuwe API-sleutel
4. Geef hem een naam, bijvoorbeeld “AI-assistent”
5. Kies de machtigingen. We raden aan te beginnen met alleen-lezentoegang: asset.read, asset.view, album.read, person.read en tag.read. Je kunt later een nieuwe sleutel met meer machtigingen aanmaken, bijvoorbeeld album.create zodat de assistent albums kan maken.
6. Klik op Aanmaken en kopieer de sleutel

Je ziet de sleutel maar één keer. Bewaar hem op een veilige plek, zoals een wachtwoordmanager.

Stap 2: ImmichMCP toevoegen aan Claude Desktop

1. Open Claude Desktop
2. Ga naar Settings → Developer en klik op Edit Config
3. Er opent een bestand met de naam claude_desktop_config.json. Plak hierin het volgende en vervang het adres en de sleutel door die van jou:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

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

4. Sla het bestand op en herstart Claude Desktop volledig

Als Claude opnieuw start, zie je immich in de lijst met connectors of tools. De eerste keer opstarten kan een minuut duren, omdat Docker ImmichMCP op de achtergrond downloadt.

Andere MCP-apps gebruiken een vergelijkbare configuratie. Kijk in de documentatie van je app waar je een MCP-server toevoegt.

Stap 3: probeer het uit

Start een nieuwe chat en vraag iets over je foto’s, bijvoorbeeld:

• “Hoeveel foto’s heb ik in PixelUnion?”
• “Zoek foto’s van een zonsondergang op het strand”
• “Welke albums heb ik?”

De assistent vraagt om je toestemming voordat hij een tool voor het eerst gebruikt. Zodra je dat toestaat, zie je de resultaten in de chat.

Tips

• Verwijderen is beveiligd. ImmichMCP verwijdert alleen foto’s of albums als het verzoek dat expliciet bevestigt. Lees toch wat de assistent van plan is voordat je een toolaanroep goedkeurt.
• Je API-sleutel staat als platte tekst in het configuratiebestand. Deel dat bestand niet en gebruik deze opstelling niet op een gedeelde computer.
• Stop de toegang op elk moment door de API-sleutel te verwijderen onder Accountinstellingen → API-sleutels. De assistent verliest direct de toegang.
• Gebeurt er niets? Controleer of Docker Desktop actief is en of je PixelUnion-adres begint met https://.

We kijken ernaar om in de toekomst MCP rechtstreeks vanuit PixelUnion aan te bieden, zonder Docker of API-sleutels in een bestand. We hebben nog niets besloten. Heb je feedback, neem dan contact met ons op.