Ligar um assistente de IA com MCP

Com o Model Context Protocol (MCP), pode ligar um assistente de IA à sua biblioteca da PixelUnion. Depois, pode pedir coisas como “encontra fotos da praia do verão passado” ou “cria um álbum chamado Islândia 2026 com todas as fotos de fevereiro”, e o assistente faz isso por si.

Este guia utiliza o ImmichMCP, um projeto open source gratuito. É um projeto da comunidade, não foi criado nem é suportado pela PixelUnion ou pela equipa do Immich. Não podemos ajudar com problemas no próprio ImmichMCP, mas ajudamos com todo o gosto no que diz respeito à PixelUnion.

Antes de começar

Leia isto primeiro. Quando utiliza um serviço de IA na nuvem, como o Claude ou o ChatGPT, a informação que o assistente lê da sua biblioteca é enviada para esse serviço. Isto pode incluir nomes de ficheiros, datas, localizações, nomes de pessoas e, por vezes, imagens de pré-visualização. A PixelUnion guarda as suas fotos na Europa, mas assim que estes dados chegam ao serviço de IA, aplicam-se os termos de privacidade desse serviço. Se quiser que tudo fique no seu próprio computador, utilize um modelo local, por exemplo através do LM Studio.

Vai precisar de:

• O seu endereço da PixelUnion (por exemplo, https://yourname.pixelunion.eu)
• O Docker Desktop instalado e em execução
• Uma aplicação de IA que suporte MCP, como o Claude Desktop ou o LM Studio

Passo 1: criar uma chave de API

1. Inicie sessão no seu domínio da PixelUnion (por exemplo, https://yourname.pixelunion.eu)
2. Clique no ícone do seu perfil (canto superior direito) e vá para Configurações da conta
3. Navegue até Chaves de API e clique em Nova chave de API
4. Dê-lhe um nome, por exemplo “Assistente de IA”
5. Escolha as permissões. Recomendamos começar com acesso só de leitura: asset.read, asset.view, album.read, person.read e tag.read. Mais tarde, pode criar uma nova chave com mais permissões, por exemplo album.create para deixar o assistente criar álbuns.
6. Clique em Criar e copie a chave

Só vai ver a chave uma vez. Guarde-a num local seguro, como um gestor de palavras-passe.

Passo 2: adicionar o ImmichMCP ao Claude Desktop

1. Abra o Claude Desktop
2. Vá para Settings → Developer e clique em Edit Config
3. Abre-se um ficheiro chamado claude_desktop_config.json. Cole o seguinte, substituindo o endereço e a chave pelos seus:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

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

4. Guarde o ficheiro e reinicie o Claude Desktop por completo

Quando o Claude voltar a abrir, verá immich na lista de conectores ou ferramentas. O primeiro arranque pode demorar um minuto, porque o Docker transfere o ImmichMCP em segundo plano.

Outras aplicações MCP utilizam uma configuração semelhante. Consulte a documentação da sua aplicação para saber onde adicionar um servidor MCP.

Passo 3: experimentar

Inicie uma nova conversa e pergunte algo sobre as suas fotos, por exemplo:

• “Quantas fotos tenho na PixelUnion?”
• “Encontra fotos de um pôr do sol na praia”
• “Que álbuns tenho?”

O assistente pede a sua autorização antes de utilizar uma ferramenta pela primeira vez. Depois de autorizar, verá os resultados na conversa.

Dicas

• Apagar está protegido. O ImmichMCP só apaga fotos ou álbuns quando o pedido o confirma explicitamente. Mesmo assim, leia o que o assistente pretende fazer antes de aprovar a utilização de uma ferramenta.
• A sua chave de API fica guardada em texto simples no ficheiro de configuração. Não partilhe esse ficheiro e não utilize esta configuração num computador partilhado.
• Pode retirar o acesso a qualquer momento apagando a chave de API em Configurações da conta → Chaves de API. O assistente perde o acesso de imediato.
• Não acontece nada? Verifique se o Docker Desktop está em execução e se o seu endereço da PixelUnion começa por https://.

Estamos a estudar a possibilidade de oferecer MCP diretamente a partir da PixelUnion no futuro, sem Docker nem chaves de API num ficheiro. Ainda não decidimos. Se tiver feedback, contacte-nos.