Fala com a tua biblioteca de fotos: Immich, PixelUnion e o Model Context Protocol

A maioria dos assistentes de IA sabe muito sobre o mundo e nada sobre as tuas fotos. Pede a um que encontre as fotos do primeiro passeio de bicicleta da tua filha e só consegue pedir desculpa. Um pequeno projeto open source muda isso para o Immich e, como a PixelUnion funciona com o Immich, também funciona com a tua biblioteca da PixelUnion.

O projeto chama-se ImmichMCP e foi criado pelo utilizador barryw no GitHub. Não foi feito por nós nem pela equipa do Immich. Testámo-lo, gostamos do rumo que está a tomar e queremos explicar o que faz antes de lhe entregares as chaves das tuas fotos.

O que é o MCP, e porque é importante

MCP significa Model Context Protocol. A Anthropic apresentou-o em novembro de 2024 como uma norma aberta para ligar assistentes de IA a ferramentas e dados externos. Um ano depois, passou para a Linux Foundation, pelo que já nenhuma empresa é dona dele. O Claude, o ChatGPT, o Gemini, o VS Code, o Cursor e o LM Studio suportam-no de alguma forma.

A ideia é simples. Um servidor MCP fica entre um assistente de IA e um serviço. Diz ao assistente que ações existem, por exemplo “pesquisar fotos” ou “criar álbum”, e executa essas ações através da API normal do serviço. O assistente decide que ferramenta usar. O servidor faz o trabalho.

Antes do MCP, cada fornecedor de IA criava os seus próprios plugins para cada serviço, no seu próprio formato. É assim que começa a dependência de um fornecedor. Com um único protocolo aberto, um só servidor funciona com qualquer assistente que fale MCP. Podes trocar o Claude por um modelo local no próximo mês e manter a mesma ligação às tuas fotos. Para uma empresa como a nossa, é essa a parte que importa. Não queremos a tua biblioteca de fotos presa à empresa americana de IA que estiver à frente neste trimestre.

O ImmichMCP disponibiliza 49 ferramentas: pesquisa inteligente (“pôr do sol na praia”), pesquisa por data, local, câmara ou pessoa, álbuns, etiquetas, pessoas, links partilhados, comentários e carregamentos. Na prática, podes escrever “cria um álbum chamado Islândia 2026 com todas as fotos de fevereiro” e o assistente descobre os passos. Tudo o que é destrutivo, como apagar fotos, exige um sinalizador de confirmação explícito. O assistente não consegue apagar por acidente sem que o pedido o diga.

Como configurar com a PixelUnion

Executas o ImmichMCP no teu próprio computador. Liga-se à tua instância da PixelUnion com uma chave de API. A versão curta:

1. Cria uma chave de API na PixelUnion em Configurações da conta → Chaves de API. Dá-lhe só as permissões de que precisas. Começa com permissões de leitura.
2. Instala o Docker Desktop.
3. Adiciona o ImmichMCP à configuração MCP do teu cliente de IA, com o teu endereço da PixelUnion (https://yourname.pixelunion.eu) e a chave de API.
4. Reinicia o cliente e pergunta-lhe algo sobre as tuas fotos.

O guia completo, passo a passo, incluindo a configuração exata para o Claude Desktop, está no nosso centro de ajuda: Ligar um assistente de IA com MCP.

Agora a contrapartida, porque existe uma. O ImmichMCP é executado localmente, mas o modelo de IA a que o ligas provavelmente não. Se usares o Claude ou o ChatGPT, tudo o que as ferramentas devolvem vai para esse fornecedor: nomes de ficheiros, datas, localizações GPS, os nomes que deste aos rostos e, com algumas definições, até imagens de pré-visualização. São dados que a PixelUnion guarda na Europa. Assim que os envias para um serviço de IA americano, ficam abrangidos pelos termos deles, não pelos nossos. Se isso te incomoda, usa um modelo local através de um cliente como o LM Studio. É mais lento e menos capaz, mas nada sai da tua máquina.

Mais dois pontos. A chave de API fica num ficheiro de configuração em texto simples no teu computador, por isso trata esse ficheiro como uma palavra-passe. E o ImmichMCP é um projeto comunitário recente. Lê o código, ou pelo menos o README, antes de o executares. O open source dá-te essa opção. Não faz a leitura por ti.

O que vem a seguir

Estamos a estudar a possibilidade de oferecer um endpoint MCP como parte da própria PixelUnion. Isso significaria nada de Docker, nada de chave de API num ficheiro de configuração, e um início de sessão que podes revogar nas definições da tua conta. Ainda não decidimos, e queremos acertar no lado da privacidade antes de construirmos o que quer que seja. Se experimentares o ImmichMCP e tiveres opiniões, diz-nos. Esse feedback molda o que fazemos a seguir.

Começa grátis com a PixelUnion →

Foto de capa de Vitaly Gariev no Unsplash.