---
title: "Ligar um assistente de IA com MCP"
description: "Utilize o servidor ImmichMCP, criado pela comunidade, para pesquisar e organizar as suas fotos da PixelUnion a partir de um assistente de IA como o Claude"
url: "https://pixelunion.eu/pt/help/immich/mcp-ai-assistants/"
weight: 8
---


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](https://github.com/barryw/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](https://lmstudio.ai).

Vai precisar de:

- O seu endereço da PixelUnion (por exemplo, `https://yourname.pixelunion.eu`)
- O [Docker Desktop](https://www.docker.com/products/docker-desktop/) instalado e em execução
- Uma aplicação de IA que suporte MCP, como o [Claude Desktop](https://claude.ai/download) 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:

```json
{
  "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](/pt/help/contact/).