Forbind en AI-assistent med MCP

Med Model Context Protocol (MCP) kan du forbinde en AI-assistent med dit PixelUnion-bibliotek. Du kan derefter spørge om ting som “find fotos fra stranden sidste sommer” eller “opret et album, der hedder Island 2026, med alle fotos fra februar”, og assistenten gør det for dig.

Denne guide bruger ImmichMCP, et gratis open source-projekt. Det er et fællesskabsprojekt, som hverken er bygget eller understøttet af PixelUnion eller Immich-teamet. Vi kan ikke hjælpe med problemer i selve ImmichMCP, men vi hjælper gerne med PixelUnion-delen.

Før du begynder

Læs venligst dette først. Når du bruger en AI-tjeneste i skyen som Claude eller ChatGPT, bliver de oplysninger, assistenten læser fra dit bibliotek, sendt til den tjeneste. Det kan omfatte filnavne, datoer, placeringer, navne på personer og nogle gange forhåndsvisningsbilleder. PixelUnion opbevarer dine fotos i Europa, men så snart disse data når AI-tjenesten, gælder deres privatlivsvilkår. Hvis du vil have, at alt bliver på din egen computer, så brug en lokal model, for eksempel via LM Studio.

Du skal bruge:

• Din PixelUnion-adresse (f.eks. https://ditnavn.pixelunion.eu)
• Docker Desktop installeret og kørende
• En AI-app, der understøtter MCP, såsom Claude Desktop eller LM Studio

Trin 1: opret en API-nøgle

1. Log ind på dit PixelUnion-domæne (f.eks. https://ditnavn.pixelunion.eu)
2. Klik på dit profilikon (øverst til højre) og gå til Kontoindstillinger
3. Naviger til API-nøgler og klik på Ny API-nøgle
4. Giv den et navn, for eksempel “AI-assistent”
5. Vælg tilladelserne. Vi anbefaler at starte med skrivebeskyttet adgang: asset.read, asset.view, album.read, person.read og tag.read. Du kan senere oprette en ny nøgle med flere tilladelser, for eksempel album.create, så assistenten kan lave album.
6. Klik på Opret og kopiér nøglen

Du ser kun nøglen én gang. Opbevar den et sikkert sted, som en adgangskodeadministrator.

Trin 2: tilføj ImmichMCP til Claude Desktop

1. Åbn Claude Desktop
2. Gå til Settings → Developer og klik på Edit Config
3. En fil, der hedder claude_desktop_config.json, åbnes. Indsæt følgende, og erstat adressen og nøglen med dine egne:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

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

4. Gem filen og genstart Claude Desktop helt

Når Claude starter igen, ser du immich på listen over connectors eller værktøjer. Første start kan tage et minut, fordi Docker downloader ImmichMCP i baggrunden.

Andre MCP-apps bruger en lignende konfiguration. Se din apps dokumentation for, hvor du tilføjer en MCP-server.

Trin 3: prøv det

Start en ny chat og spørg om noget om dine fotos, for eksempel:

• “Hvor mange fotos har jeg i PixelUnion?”
• “Find fotos af en solnedgang på stranden”
• “Hvilke album har jeg?”

Assistenten beder om din tilladelse, før den bruger et værktøj første gang. Når du har givet lov, ser du resultaterne i chatten.

Tips

• Sletning er beskyttet. ImmichMCP sletter kun fotos eller album, når anmodningen udtrykkeligt bekræfter det. Læs alligevel, hvad assistenten har tænkt sig at gøre, før du godkender et værktøjskald.
• Din API-nøgle gemmes i klartekst i konfigurationsfilen. Del ikke den fil, og brug ikke denne opsætning på en delt computer.
• Stop adgangen når som helst ved at slette API-nøglen under Kontoindstillinger → API-nøgler. Assistenten mister adgangen med det samme.
• Sker der ingenting? Kontrollér, at Docker Desktop kører, og at din PixelUnion-adresse starter med https://.

Vi overvejer at tilbyde MCP direkte fra PixelUnion i fremtiden, uden Docker eller API-nøgler i en fil. Vi har ikke besluttet os endnu. Hvis du har feedback, så kontakt os.