---
title: "Połącz asystenta AI przez MCP"
description: "Użyj tworzonego przez społeczność serwera ImmichMCP, aby wyszukiwać i organizować zdjęcia w PixelUnion z poziomu asystenta AI, takiego jak Claude"
url: "https://pixelunion.eu/pl/help/immich/mcp-ai-assistants/"
weight: 8
---


Dzięki Model Context Protocol (MCP) możesz połączyć asystenta AI ze swoją biblioteką PixelUnion. Możesz wtedy prosić na przykład „znajdź zdjęcia z plaży z zeszłego lata” albo „utwórz album o nazwie Islandia 2026 ze wszystkimi zdjęciami z lutego”, a asystent zrobi to za Ciebie.

Ten przewodnik korzysta z [ImmichMCP](https://github.com/barryw/ImmichMCP), darmowego projektu open source. To projekt społecznościowy, nie jest tworzony ani wspierany przez PixelUnion ani zespół Immich. Nie możemy pomóc w problemach z samym ImmichMCP, ale chętnie pomożemy w sprawach dotyczących PixelUnion.

## Zanim zaczniesz

Przeczytaj to najpierw. Gdy korzystasz z chmurowej usługi AI, takiej jak Claude lub ChatGPT, informacje, które asystent odczytuje z Twojej biblioteki, są wysyłane do tej usługi. Mogą to być nazwy plików, daty, lokalizacje, imiona osób, a czasem podglądy zdjęć. PixelUnion przechowuje Twoje zdjęcia w Europie, ale gdy te dane trafią do usługi AI, obowiązują jej zasady prywatności. Jeśli chcesz, żeby wszystko zostało na Twoim komputerze, użyj lokalnego modelu, na przykład przez [LM Studio](https://lmstudio.ai).

Czego będziesz potrzebować:

- Adresu PixelUnion (np. `https://twojanazwa.pixelunion.eu`)
- Zainstalowanego i uruchomionego [Docker Desktop](https://www.docker.com/products/docker-desktop/)
- Aplikacji AI, która obsługuje MCP, takiej jak [Claude Desktop](https://claude.ai/download) lub LM Studio

## Krok 1: utwórz klucz API

1. Zaloguj się do swojej domeny PixelUnion (np. `https://twojanazwa.pixelunion.eu`)
2. Kliknij ikonę profilu (w prawym górnym rogu) i przejdź do **Ustawień konta**
3. Przejdź do **Klucze API** i kliknij **Nowy klucz API**
4. Nadaj mu nazwę, na przykład „Asystent AI”
5. Wybierz uprawnienia. Zalecamy zacząć od dostępu tylko do odczytu: **asset.read**, **asset.view**, **album.read**, **person.read** i **tag.read**. Później możesz utworzyć nowy klucz z większymi uprawnieniami, na przykład **album.create**, aby asystent mógł tworzyć albumy.
6. Kliknij **Utwórz** i skopiuj klucz

Klucz zobaczysz tylko raz. Przechowuj go w bezpiecznym miejscu, na przykład w menedżerze haseł.

## Krok 2: dodaj ImmichMCP do Claude Desktop

1. Otwórz Claude Desktop
2. Przejdź do **Settings → Developer** i kliknij **Edit Config**
3. Otworzy się plik o nazwie `claude_desktop_config.json`. Wklej poniższą treść, zastępując adres i klucz własnymi:

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

4. Zapisz plik i całkowicie uruchom ponownie Claude Desktop

Gdy Claude uruchomi się ponownie, zobaczysz **immich** na liście konektorów lub narzędzi. Pierwsze uruchomienie może potrwać minutę, ponieważ Docker pobiera ImmichMCP w tle.

Inne aplikacje MCP używają podobnej konfiguracji. Sprawdź w dokumentacji swojej aplikacji, gdzie dodać serwer MCP.

## Krok 3: wypróbuj

Rozpocznij nowy czat i zapytaj o coś na temat swoich zdjęć, na przykład:

- „Ile mam zdjęć w PixelUnion?”
- „Znajdź zdjęcia zachodu słońca na plaży”
- „Jakie mam albumy?”

Asystent poprosi o Twoją zgodę, zanim po raz pierwszy użyje narzędzia. Gdy na to pozwolisz, zobaczysz wyniki w czacie.

## Wskazówki

- **Usuwanie jest chronione.** ImmichMCP usunie zdjęcia lub albumy tylko wtedy, gdy polecenie wyraźnie to potwierdza. Mimo to przeczytaj, co asystent zamierza zrobić, zanim zatwierdzisz użycie narzędzia.
- **Twój klucz API jest przechowywany jako zwykły tekst** w pliku konfiguracyjnym. Nie udostępniaj tego pliku i nie używaj tej konfiguracji na współdzielonym komputerze.
- **Możesz w każdej chwili odebrać dostęp**, usuwając klucz API w **Ustawienia konta → Klucze API**. Asystent natychmiast traci dostęp.
- **Nic się nie dzieje?** Sprawdź, czy Docker Desktop jest uruchomiony i czy Twój adres PixelUnion zaczyna się od `https://`.

Rozważamy w przyszłości udostępnienie MCP bezpośrednio przez PixelUnion, bez Dockera i bez kluczy API w pliku. Jeszcze nie podjęliśmy decyzji. Jeśli masz uwagi, [skontaktuj się z nami](/pl/help/contact/).