---
title: "Connecter un assistant IA avec MCP"
description: "Utilisez le serveur ImmichMCP, développé par la communauté, pour rechercher et organiser vos photos PixelUnion depuis un assistant IA comme Claude"
url: "https://pixelunion.eu/fr/help/immich/mcp-ai-assistants/"
weight: 8
---


Avec le Model Context Protocol (MCP), vous pouvez connecter un assistant IA à votre bibliothèque PixelUnion. Vous pouvez ensuite lui demander par exemple « trouve des photos de la plage de l'été dernier » ou « crée un album Islande 2026 avec toutes les photos de février », et l'assistant s'en charge pour vous.

Ce guide utilise [ImmichMCP](https://github.com/barryw/ImmichMCP), un projet open source gratuit. Il s'agit d'un projet communautaire, qui n'est ni développé ni pris en charge par PixelUnion ou par l'équipe Immich. Nous ne pouvons pas vous aider pour les problèmes liés à ImmichMCP lui-même, mais nous vous aidons volontiers pour tout ce qui concerne PixelUnion.

## Avant de commencer

Lisez d'abord ceci. Lorsque vous utilisez un service d'IA dans le cloud comme Claude ou ChatGPT, les informations que l'assistant lit dans votre bibliothèque sont envoyées à ce service. Il peut s'agir de noms de fichiers, de dates, de lieux, de noms de personnes et parfois d'images d'aperçu. PixelUnion stocke vos photos en Europe, mais une fois que ces données atteignent le service d'IA, ce sont ses conditions de confidentialité qui s'appliquent. Si vous voulez que tout reste sur votre propre ordinateur, utilisez un modèle local, par exemple via [LM Studio](https://lmstudio.ai).

Vous aurez besoin de :

- Votre adresse PixelUnion (ex. : `https://votrenom.pixelunion.eu`)
- [Docker Desktop](https://www.docker.com/products/docker-desktop/) installé et lancé
- Une application d'IA compatible avec MCP, comme [Claude Desktop](https://claude.ai/download) ou LM Studio

## Étape 1 : créer une clé API

1. Connectez-vous à votre domaine PixelUnion (ex. : `https://votrenom.pixelunion.eu`)
2. Cliquez sur votre icône de profil (en haut à droite) et allez dans **Paramètres du compte**
3. Accédez à **Clés API** et cliquez sur **Nouvelle clé API**
4. Donnez-lui un nom, par exemple « Assistant IA »
5. Choisissez les autorisations. Nous vous conseillons de commencer avec un accès en lecture seule : **asset.read**, **asset.view**, **album.read**, **person.read** et **tag.read**. Vous pourrez créer plus tard une nouvelle clé avec davantage d'autorisations, par exemple **album.create** pour permettre à l'assistant de créer des albums.
6. Cliquez sur **Créer** et copiez la clé

La clé ne s'affiche qu'une seule fois. Conservez-la en lieu sûr, par exemple dans un gestionnaire de mots de passe.

## Étape 2 : ajouter ImmichMCP à Claude Desktop

1. Ouvrez Claude Desktop
2. Allez dans **Paramètres → Développeur** et cliquez sur **Modifier la configuration**
3. Un fichier nommé `claude_desktop_config.json` s'ouvre. Collez-y le contenu suivant, en remplaçant l'adresse et la clé par les vôtres :

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

4. Enregistrez le fichier et redémarrez complètement Claude Desktop

Au redémarrage de Claude, vous verrez **immich** dans la liste des connecteurs ou des outils. Le premier démarrage peut prendre une minute, car Docker télécharge ImmichMCP en arrière-plan.

D'autres applications MCP utilisent une configuration similaire. Consultez la documentation de votre application pour savoir où ajouter un serveur MCP.

## Étape 3 : faire un essai

Ouvrez une nouvelle conversation et posez une question sur vos photos, par exemple :

- « Combien de photos ai-je dans PixelUnion ? »
- « Trouve des photos d'un coucher de soleil à la plage »
- « Quels albums ai-je ? »

L'assistant vous demande votre autorisation avant d'utiliser un outil pour la première fois. Une fois que vous l'avez accordée, les résultats s'affichent dans la conversation.

## Conseils

- **La suppression est protégée.** ImmichMCP ne supprime des photos ou des albums que si la demande le confirme explicitement. Lisez tout de même ce que l'assistant prévoit de faire avant d'approuver un appel d'outil.
- **Votre clé API est stockée en texte clair** dans le fichier de configuration. Ne partagez pas ce fichier, et n'utilisez pas cette configuration sur un ordinateur partagé.
- **Coupez l'accès à tout moment** en supprimant la clé API sous **Paramètres du compte → Clés API**. L'assistant perd l'accès immédiatement.
- **Rien ne se passe ?** Vérifiez que Docker Desktop est lancé et que votre adresse PixelUnion commence par `https://`.

Nous étudions la possibilité de proposer MCP directement depuis PixelUnion à l'avenir, sans Docker ni clé API dans un fichier. Nous n'avons pas encore décidé. Si vous avez des retours, [contactez-nous](/fr/help/contact/).