Anslut en AI-assistent med MCP

Med Model Context Protocol (MCP) kan du ansluta en AI-assistent till ditt PixelUnion-bibliotek. Du kan sedan be om saker som “hitta foton från stranden förra sommaren” eller “skapa ett album som heter Island 2026 med alla foton från februari”, och assistenten gör det åt dig.

Den här guiden använder ImmichMCP, ett gratis open source-projekt. Det är ett communityprojekt som inte är byggt eller supportat av PixelUnion eller Immich-teamet. Vi kan inte hjälpa till med problem i själva ImmichMCP, men vi hjälper gärna till med PixelUnion-delen.

Innan du börjar

Läs det här först. När du använder en AI-tjänst i molnet, som Claude eller ChatGPT, skickas informationen som assistenten läser från ditt bibliotek till den tjänsten. Det kan omfatta filnamn, datum, platser, namn på personer och ibland förhandsbilder. PixelUnion lagrar dina foton i Europa, men när den här datan når AI-tjänsten gäller deras integritetsvillkor. Om du vill att allt ska stanna på din egen dator, använd en lokal modell, till exempel via LM Studio.

Du behöver:

• Din PixelUnion-adress (t.ex. https://dittnamn.pixelunion.eu)
• Docker Desktop installerat och igång
• En AI-app som stöder MCP, som Claude Desktop eller LM Studio

Steg 1: skapa en API-nyckel

1. Logga in på din PixelUnion-domän (t.ex. https://dittnamn.pixelunion.eu)
2. Klicka på din profilikon (uppe till höger) och gå till Kontoinställningar
3. Gå till API-nycklar och klicka på Ny API-nyckel
4. Ge den ett namn, till exempel “AI-assistent”
5. Välj behörigheterna. Vi rekommenderar att du börjar med enbart läsåtkomst: asset.read, asset.view, album.read, person.read och tag.read. Du kan skapa en ny nyckel med fler behörigheter senare, till exempel album.create för att låta assistenten skapa album.
6. Klicka på Skapa och kopiera nyckeln

Du ser nyckeln bara en gång. Förvara den på ett säkert ställe, till exempel i en lösenordshanterare.

Steg 2: lägg till ImmichMCP i Claude Desktop

1. Öppna Claude Desktop
2. Gå till Settings → Developer och klicka på Edit Config
3. En fil som heter claude_desktop_config.json öppnas. Klistra in följande och ersätt adressen och nyckeln med dina egna:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

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

4. Spara filen och starta om Claude Desktop helt

När Claude startar igen ser du immich i listan över kopplingar eller verktyg. Den första starten kan ta en minut, eftersom Docker laddar ner ImmichMCP i bakgrunden.

Andra MCP-appar använder en liknande konfiguration. Se dokumentationen för din app för var du lägger till en MCP-server.

Steg 3: prova

Starta en ny chatt och fråga något om dina foton, till exempel:

• “Hur många foton har jag i PixelUnion?”
• “Hitta foton av en solnedgång på stranden”
• “Vilka album har jag?”

Assistenten ber om din tillåtelse innan den använder ett verktyg för första gången. När du har godkänt det ser du resultaten i chatten.

Tips

• Radering är skyddad. ImmichMCP raderar bara foton eller album när begäran uttryckligen bekräftar det. Läs ändå vad assistenten tänker göra innan du godkänner ett verktygsanrop.
• Din API-nyckel lagras i klartext i konfigurationsfilen. Dela inte den filen, och använd inte den här konfigurationen på en delad dator.
• Stoppa åtkomsten när som helst genom att radera API-nyckeln under Kontoinställningar → API-nycklar. Assistenten förlorar åtkomsten omedelbart.
• Händer ingenting? Kontrollera att Docker Desktop är igång och att din PixelUnion-adress börjar med https://.

Vi undersöker möjligheten att erbjuda MCP direkt från PixelUnion i framtiden, utan Docker eller API-nycklar i en fil. Vi har inte bestämt oss än. Om du har feedback, kontakta oss.