Collegare un assistente IA con MCP

Con il Model Context Protocol (MCP) puoi collegare un assistente IA alla tua libreria PixelUnion. Puoi quindi chiedere cose come “trova le foto della spiaggia dell’estate scorsa” o “crea un album chiamato Islanda 2026 con tutte le foto di febbraio”, e l’assistente lo fa per te.

Questa guida usa ImmichMCP, un progetto open source gratuito. È un progetto della community, non sviluppato né supportato da PixelUnion o dal team di Immich. Non possiamo aiutarti con problemi di ImmichMCP stesso, ma ti aiutiamo volentieri con la parte di PixelUnion.

Prima di iniziare

Leggi prima questa parte. Quando usi un servizio di IA nel cloud come Claude o ChatGPT, le informazioni che l’assistente legge dalla tua libreria vengono inviate a quel servizio. Possono includere nomi dei file, date, posizioni, nomi di persone e a volte immagini di anteprima. PixelUnion conserva le tue foto in Europa, ma una volta che questi dati raggiungono il servizio di IA, valgono i suoi termini sulla privacy. Se vuoi che tutto resti sul tuo computer, usa un modello locale, per esempio tramite LM Studio.

Ti servirà:

• Il tuo indirizzo PixelUnion (es. https://tuonome.pixelunion.eu)
• Docker Desktop installato e in esecuzione
• Un’app di IA che supporta MCP, come Claude Desktop o LM Studio

Passo 1: creare una chiave API

1. Accedi al tuo dominio PixelUnion (es. https://tuonome.pixelunion.eu)
2. Clicca sull’icona del profilo (in alto a destra) e vai su Impostazioni account
3. Vai su Chiavi API e clicca su Nuova chiave API
4. Dalle un nome, per esempio “Assistente IA”
5. Scegli i permessi. Ti consigliamo di iniziare con l’accesso in sola lettura: asset.read, asset.view, album.read, person.read e tag.read. In seguito puoi creare una nuova chiave con più permessi, per esempio album.create per permettere all’assistente di creare album.
6. Clicca su Crea e copia la chiave

Vedrai la chiave una sola volta. Conservala in un posto sicuro, come un gestore di password.

Passo 2: aggiungere ImmichMCP a Claude Desktop

1. Apri Claude Desktop
2. Vai su Impostazioni → Sviluppatore e clicca su Modifica configurazione
3. Si apre un file chiamato claude_desktop_config.json. Incolla quanto segue, sostituendo l’indirizzo e la chiave con i tuoi:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

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

4. Salva il file e riavvia completamente Claude Desktop

Quando Claude si riavvia, vedrai immich nell’elenco dei connettori o degli strumenti. Il primo avvio può richiedere un minuto, perché Docker scarica ImmichMCP in background.

Altre app MCP usano una configurazione simile. Consulta la documentazione della tua app per sapere dove aggiungere un server MCP.

Passo 3: provalo

Avvia una nuova chat e fai una domanda sulle tue foto, per esempio:

• “Quante foto ho in PixelUnion?”
• “Trova foto di un tramonto in spiaggia”
• “Quali album ho?”

L’assistente ti chiederà il permesso prima di usare uno strumento per la prima volta. Una volta che lo consenti, vedrai i risultati nella chat.

Suggerimenti

• L’eliminazione è protetta. ImmichMCP elimina foto o album solo quando la richiesta lo conferma esplicitamente. Anche così, leggi cosa intende fare l’assistente prima di approvare una chiamata a uno strumento.
• La tua chiave API è salvata in chiaro nel file di configurazione. Non condividere quel file e non usare questa configurazione su un computer condiviso.
• Blocca l’accesso in qualsiasi momento eliminando la chiave API in Impostazioni account → Chiavi API. L’assistente perde l’accesso immediatamente.
• Non succede niente? Verifica che Docker Desktop sia in esecuzione e che il tuo indirizzo PixelUnion inizi con https://.

Stiamo valutando di offrire MCP direttamente da PixelUnion in futuro, senza Docker né chiavi API in un file. Non abbiamo ancora deciso. Se hai un feedback, contattaci.