Połącz asystenta AI przez MCP

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, 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.

Czego będziesz potrzebować:

• Adresu PixelUnion (np. https://twojanazwa.pixelunion.eu)
• Zainstalowanego i uruchomionego Docker Desktop
• Aplikacji AI, która obsługuje MCP, takiej jak Claude Desktop 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:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

{
  "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.