SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor

Jak połączyć Claude z Home Assistant przez MCP

Skonfiguruj integrację MCP w Home Assistant od wersji 2025.2, aby sterować domem przez Claude. Poznaj kroki konfiguracji OAuth, wyboru bezpiecznego adresu i uprawnień.

Jak połączyć Claude z Home Assistant za pomocą MCP

Aby połączyć Claude z Home Assistant przy użyciu MCP, należy włączyć wbudowaną integrację Model Context Protocol w Home Assistant i dodać jej adres do Claude jako niestandardowy konektor. Claude loguje się następnie poprzez własny mechanizm OAuth w Home Assistant. OAuth to otwarty standard umożliwiający aplikacji uzyskanie dostępu bez udostępniania hasła. Home Assistant wymaga najpierw publicznego adresu HTTPS. Konfiguracja tego adresu stanowi większość pracy, ponieważ Claude łączy się z domem z chmury Anthropic, nawet w przypadku korzystania z aplikacji Claude Desktop.

MCP (Model Context Protocol) to otwarty standard pozwalający klientowi AI wywoływać narzędzia na innym serwerze. Home Assistant udostępnia integrację MCP Server od wersji 2025.2. Narzędzia te mogą odczytywać stan domu oraz, przy odpowiednich opcjach, sterować nim. Kluczową kwestią jest zatem bezpieczeństwo. Kto ma dostęp do udostępnionego adresu i jakie uprawnienia posiada przypisane do niego konto? Jeśli trwa jeszcze proces ustalania miejsca MCP wśród innych metod rozszerzania możliwości Claude, warto zacząć od porównania MCP z umiejętnościami agentów i plikami reguł.

Niniejszy przewodnik został zweryfikowany na podstawie dokumentacji Home Assistant, Anthropic, Tailscale, Caddy oraz Nabu Casa w dniu 22 listopada 2026 r. Aktualna wersja Home Assistant w tym dniu to 2026.11.2. Niektóre z poniższych opcji wprowadzono niedawno, dlatego przed rozpoczęciem pracy należy zaktualizować Home Assistant.

Dlaczego Claude wymaga dostępu do Home Assistant przez publiczny internet

Artykuł pomocy Anthropic dotyczący niestandardowych konektorów (custom connectors) stwierdza to wprost: „Claude łączy się z Twoim zdalnym serwerem MCP z infrastruktury chmurowej Anthropic, a nie z Twojego urządzenia lokalnego”. Dokumentacja Home Assistant mówi to samo o aplikacji desktopowej: „Claude łączy się z Twoim serwerem MCP z chmury, również wtedy, gdy korzystasz z Claude Desktop”.

Wynikają z tego dwa wymagania. Twój serwer musi być osiągalny przez publiczny internet z zakresów adresów IP Anthropic. Musi również odpowiadać na standardowym porcie HTTPS, czyli 443. Dlatego http://homeassistant.local:8123 nigdy nie zadziała jako adres URL konektora. Serwery Anthropic nie potrafią rozwiązać nazwy, która istnieje tylko w Twojej sieci domowej, a port 8123 nie jest portem 443.

Claude Desktop posiada również drugi mechanizm. Lokalne serwery MCP wymienione w claude_desktop_config.json korzystają z Twojej sieci lokalnej. Są one oddzielone od konektorów i nie są dostępne w claude.ai ani w sesjach Cowork, które działają w chmurze. Dokumentacja Home Assistant opisuje tylko ścieżkę konektora dla Claude Desktop, dlatego ten przewodnik wykorzystuje właśnie tę metodę.

Claude Code działa inaczej. Uruchamia się na Twoim własnym komputerze lub serwerze i samodzielnie otwiera połączenie MCP, więc adres URL musi być osiągalny tylko z poziomu tej maszyny. Home Assistant zaznacza, że „Claude Code łączy się z serwerami MCP wyłącznie przez HTTPS”. Prywatny adres HTTPS wewnątrz Twojej własnej sieci zatem również zadziała. Różnica między Tailscale Serve a Tailscale Funnel polega właśnie na tym wyborze: Serve udostępnia prywatny adres HTTPS w Twojej sieci tailnet, a Funnel udostępnia adres publiczny.

Niestandardowe konektory są dostępne w planach Free, Pro, Max, Ultra, Team oraz Enterprise. Użytkownicy planu Free są ograniczeni do jednego niestandardowego konektora. Jest to jeden z limitów omówionych w co zawiera plan Claude Free.

Włączanie integracji serwera MCP

  1. W Home Assistant przejdź do Ustawienia > Urządzenia i usługi i wybierz Dodaj integrację.
  2. Wybierz Model Context Protocol z listy i postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.
  3. Przejdź do Ustawienia > System > AI. Jeśli karta Model Context Protocol zawiera przycisk Włącz, wybierz go.
  4. Skopiuj Główny adres URL. Jego ścieżka to /api/mcp.

Pełny adres URL konektora to publiczna nazwa hosta wraz z tą ścieżką, na przykład https://ha.example.com/api/mcp. Nazwa hosta zależy od ścieżki dostępu wybranej w dalszej części dokumentacji.

Co domyślnie udostępnia główny URL

Główny URL posiada trzy opcje, które dotyczą wyłącznie /api/mcp. Należy zapoznać się z nimi przed nawiązaniem połączenia.

  • Expose all AI tools (Udostępnij wszystkie narzędzia AI) jest domyślnie włączone. Główny URL udostępnia wtedy każdy zestaw narzędzi, w tym zestawy dodawane później przez integracje. Jeden z zestawów nosi nazwę Home Assistant. Może on odczytywać wszystkie encje, dzienniki i historię oraz wykonywać dowolne akcje.
  • Require an administrator account (Wymagaj konta administratora) jest domyślnie włączone. Gdy główny URL udostępnia zestaw Home Assistant, konto administratora jest wymagane zawsze, niezależnie od ustawienia tego przełącznika.
  • Read-only (Tylko do odczytu) jest domyślnie wyłączone. Po włączeniu tej opcji główny URL udostępnia tylko te narzędzia, które są oznaczone jako niepowodujące zmian, na przykład pobieranie bieżącego stanu domu.
  • Starsze konfiguracje utrzymują dwa z tych przełączników w pozycji wyłączonej. W przypadku Expose all AI tools dokumentacja podaje, że „pozostaje wyłączone, aby klienci zachowali wybrane zestawy narzędzi AI”. Przełącznik administratora „pozostaje wyłączony, aby klienci nadal działali”. Jeśli wpis MCP Server jest starszy niż te opcje, należy otworzyć jego ustawienia i sprawdzić je.

Wyłącz Expose all AI tools, aby wybierać zestawy narzędzi pojedynczo. Zestaw Device control zapewnia AI te same narzędzia, co asystent głosowy i „uzyskuje dostęp tylko do encji udostępnionych asystentom głosowym”. Zestaw Home Assistant nie posiada takiego ograniczenia.

Istnieją również oddzielne adresy URL dla pojedynczych zestawów narzędzi. /api/mcp/assist udostępnia tylko Device control. Te adresy URL ignorują trzy powyższe opcje. Nigdy nie działają w trybie tylko do odczytu. Wszystkie z nich, z wyjątkiem adresu URL Device control, wymagają konta administratora.

Sprawdź, do czego ma dostęp Device control, zanim nadasz mu zaufanie. Assist domyślnie udostępnia nowe encje, co obejmuje również osłony (covers). Dokumentacja Home Assistant jest precyzyjna: „Osłony obejmują bramy garażowe i wjazdowe, więc Home Assistant udostępnia je automatycznie”. Zamki, panele alarmowe i skrypty nie są udostępniane automatycznie. Otwórz ustawienia udostępniania Assist i usuń każdą encję, której otwarcia przez okno czatu chcesz uniknąć.

Używaj dedykowanego konta, a nie właściciela

Po wybraniu opcji Connect w Claude następuje logowanie do Home Assistant w przeglądarce. Dostęp, który otrzymuje Claude, należy do konta, za pomocą którego się zalogowano. Jeśli zalogujesz się jako właściciel, Claude działa jako właściciel, posiadając wszystkie jego uprawnienia.

Utwórz w Home Assistant osobnego użytkownika z własnym loginem i używaj go wyłącznie dla Claude. Aby później cofnąć dostęp Claude, usuwasz to jedno konto, a Twój własny login pozostaje nienaruszony. Następnie wybierz jedną z dwóch konfiguracji.

Wąska: Claude steruje kilkoma urządzeniami. Pozostaw konto jako zwykłego użytkownika, nie administratora. W głównych opcjach URL wyłącz Expose all AI tools, wybierz tylko Device control i wyłącz Require an administrator account. Claude uzyska wtedy dostęp tylko do encji udostępnionych głosowo. Włącz również Read-only, jeśli Claude ma jedynie raportować stan. Możesz zamiast tego użyć /api/mcp/assist, co nie wymaga administratora. Ten URL ignoruje jednak przełącznik Read-only.

Szeroka: Claude odczytuje logi i historię. Zestaw narzędzi Home Assistant zawsze wymaga konta administratora. Ustaw dedykowane konto jako administratora, zachowaj je oddzielnie od właściciela i włącz Read-only. Claude może wtedy odczytywać encje, logi oraz historię. Narzędzia zmieniające stan nie są udostępniane.

Podczas kroku Connect sprawdź, na jakie konto się logujesz. Wykonanie tego kroku w oknie prywatnym przeglądarki sprawia, że przypadkowe użycie sesji właściciela staje się trudniejsze.

Nie polegaj na monitach o zatwierdzenie w kliencie jako na swojej ochronie. W procesie łączenia dokumentacja Home Assistant wskazuje, że Claude prosi o pozwolenie przed wywołaniem narzędzi, chyba że wybierzesz opcję zawsze zezwalaj. Claude Code działa inaczej. Od wersji v2.1.283 tryb auto jest domyślnym trybem uprawnień dla sesji interaktywnego terminala oraz VS Code, a tryb auto nie pyta o zgodę przed każdą akcją. Home Assistant samodzielnie egzekwuje uprawnienia konta oraz przełącznik Read-only, niezależnie od decyzji klienta.

W jaki sposób chmura Claude powinna łączyć się z Home Assistant?

Dalsza część tej sekcji stanowi model zagrożeń niniejszego przewodnika, opracowany na podstawie dokumentacji poszczególnych usług. Poniższe porównania bezpieczeństwa należy traktować jako analizę, a nie zapewnienia dostawców.

Każda z poniższych metod ma jedną wspólną cechę: każdy, kto uzyska dostęp do adresu URL, może wyświetlić stronę logowania Home Assistant. Dlatego w pierwszej kolejności należy skonfigurować zabezpieczenia logowania. W Ustawienia > System > Sieć, w sekcji Serwer HTTP, należy włączyć Włącz blokowanie IP. Następnie należy ustawić Liczba prób logowania przed zablokowaniem, która przyjmuje wartości od 1 do 1000 i pojawia się tylko wtedy, gdy opcja nieograniczonej liczby prób logowania jest wyłączona. W przypadku korzystania z dowolnego proxy lub tunelu należy również włączyć Ufaj nagłówkowi X-Forwarded-For i dodać adres proxy do Zaufane proxy. Dokumentacja Home Assistant ostrzega: „Żądania z reverse proxy są blokowane, jeśli te opcje nie zostaną ustawione”. Przed wersją Home Assistant 2026.8 ustawienia te znajdowały się w bloku http: pliku configuration.yaml.

Poniższe przykłady wykorzystują port 8123 systemu Home Assistant. Od wersji Home Assistant 2026.8 wartością domyślną jest 80 w Home Assistant Operating System oraz 8123 w wersji Container, dlatego w każdym miejscu należy zastąpić 8123 własnym skonfigurowanym portem.

Usługa Nabu Casa nosi obecnie nazwę Home Assistant Link (wcześniej Home Assistant Cloud). Według stanu na 15 listopada 2026 r. cennik wskazywał 6,50 USD miesięcznie lub 65,00 USD rocznie, bez podatku. Dostępny jest również 31-dniowy bezpłatny okres próbny niewymagający karty płatniczej. Zdalny dostęp jest jedną z wymienionych korzyści.

Co jest wystawiane: cały interfejs WWW i strona logowania Home Assistant pod publicznym adresem HTTPS. Czego to nie obejmuje: słabego hasła do konta używanego przez Claude lub tokena, który wyciekł z innego źródła. Dokumentacja wsparcia Nabu Casa podaje, że zdalny dostęp wykorzystuje szyfrowanie end-to-end, a klucz prywatny jest przechowywany wyłącznie w systemie Home Assistant, więc przekaźnik usługi nie ma wglądu w dane użytkownika.

Tailscale Funnel

Funnel kieruje ruch z publicznego Internetu do usługi lokalnej; według Tailscale usługa ta jest dostępna we wszystkich planach. Wymaga ona Tailscale w wersji 1.38.3 lub nowszej, MagicDNS, ważnych certyfikatów HTTPS dla tailnetu oraz atrybutu funnel node w pliku polityki tailnetu. Usługa może nasłuchiwać tylko na portach 443, 8443 oraz 10000. Port 443 jest tym, którego potrzebuje Claude. Jeśli te wymagania są nowe, wyjaśnienie czym jest Tailscale i jak działa tailnet zawiera szczegółowe informacje. Na maszynie, na której działa Home Assistant, należy wykonać:

sudo tailscale funnel 8123

Tailscale wyświetli publiczny adres https://<machine>.<tailnet>.ts.net, który przekazuje ruch do http://127.0.0.1:8123. Należy użyć tej nazwy hosta w adresie URL konektora. Należy dodać 127.0.0.1 do Zaufanych proxy w Home Assistant, ponieważ każde żądanie pochodzi teraz z lokalnego proxy Tailscale. Polecenie działa w pierwszym planie do momentu naciśnięcia Ctrl+C.

Co jest wystawiane: cały port Home Assistant dla każdego użytkownika Internetu. Odwiedzający korzystający z Funnel nie potrzebują Tailscale, więc prywatny tailnet nie stanowi dla nich dodatkowej bariery. Ruch przez Funnel podlega również limitom przepustowości, których nie można konfigurować.

Cloudflare Tunnel

Cloudflare Tunnel wykorzystuje połączenie wychodzące. Demon cloudflared wewnątrz sieci łączy się z Cloudflare, dzięki czemu nie trzeba otwierać żadnych portów przychodzących ani posiadać publicznego adresu IP w domu.

Co jest wystawiane: opublikowana nazwa hosta dla całego Internetu, chyba że przed nią zostaną dodane reguły. Reguła wymuszająca logowanie w Cloudflare musi przepuszczać opublikowane zakresy IP firmy Anthropic. Chmura Claude nie potrafi wypełnić strony logowania, więc jej żądania MCP zostałyby zatrzymane na poziomie Cloudflare. Należy dodać adres, którego cloudflared używa do połączenia z Home Assistant, do Zaufanych proxy.

Reverse proxy na VPS

W tym modelu użytkownik kontroluje serwer wystawiony na Internet. Mały VPS (wirtualny serwer prywatny) z publicznym adresem IP uruchamia reverse proxy, które łączy się z domowym Home Assistant przez prywatne łącze, takie jak tailnet. Żaden zasób w domu nie jest otwarty na Internet. Można również ograniczyć dostęp do samego proxy.

Anthropic publikuje adresy IP używane do żądań wychodzących, „na przykład podczas wywoływania narzędzi MCP do zewnętrznych serwerów”. Według stanu na 15 listopada 2026 r. strona wymieniała dwa zakresy IPv4 dla ruchu wychodzącego w formacie CIDR i brak zakresów IPv6. Należy skopiować aktualne zakresy ze strony adresów IP Anthropic w dniu konfiguracji. Strona wymienia również stare adresy, które nie są już używane, dlatego należy pobrać tylko te aktualne.

Po zainstalowaniu Caddy na VPS, /etc/caddy/Caddyfile może odrzucać każde połączenie, które nie pochodzi z tych zakresów:

ha.example.com {
    @blocked not remote_ip <anthropic-range-1> <anthropic-range-2> 203.0.113.25
    abort @blocked
    reverse_proxy 100.101.102.103:8123
}

Należy zastąpić <anthropic-range-1> i <anthropic-range-2> zakresami IPv4 wychodzącymi ze strony Anthropic, 203.0.113.25 własnym publicznym adresem IP, a 100.101.102.103 adresem Home Assistant w tailnecie. Własny adres IP znajduje się na liście, ponieważ krok Connect otwiera stronę logowania Home Assistant w przeglądarce. To żądanie pochodzi od użytkownika, a nie od Anthropic. Jeśli Connect zawiesza się na stronie, która się nie ładuje, oznacza to brak własnego adresu na liście. Caddy domyślnie ustawia nagłówki X-Forwarded-For, X-Forwarded-Proto oraz X-Forwarded-Host i obsługuje połączenia WebSocket. Pobiera również certyfikat TLS (transport layer security) dla nazwy hosta, o ile rekord DNS wskazuje na VPS, a Caddy może ukończyć wyzwanie weryfikacyjne urzędu certyfikacji.

caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy

caddy validate powinno zakończyć się bez błędu. Z adresu spoza listy curl -I https://ha.example.com/ nie powinno otrzymać żadnej odpowiedzi HTTP, ponieważ abort zamyka połączenie. Na koniec należy dodać adres tailnet serwera VPS do Zaufanych proxy w Home Assistant.

Przed czym to nie chroni: każdy użytkownik Claude współdzieli zakresy IP Anthropic. Lista dozwolonych adresów chroni jedynie przed przypadkowymi skanerami. Każdy, kto pozna adres URL i doda go jako własny konektor, nadal uzyska dostęp do strony logowania, dlatego hasło do konta i blokowanie IP pozostają kluczowe. Użytkownik musi również samodzielnie dbać o aktualizacje systemu VPS.

Którą ścieżkę wybrać

Nabu Casa to najszybsza konfiguracja, niewymagająca własnego serwera. Funnel i Cloudflare Tunnel pozwalają uniknąć otwierania portów w domu, ale oba wystawiają pełną stronę logowania na otwarty Internet. Proxy na VPS wymaga najwięcej pracy, ale zapewnia najmniejszą ekspozycję, ponieważ tylko zakresy Anthropic i własny adres mogą nawiązać połączenie. W każdej z metod dedykowane konto oraz przełącznik „Tylko do odczytu” zapewniają lepszą ochronę niż sam wybór metody połączenia.

Dodawanie konektora w Claude

  1. W serwisie claude.ai otwórz Customize > Connectors i wybierz + Add > Add custom connector. W aplikacji Claude Desktop, zgodnie z dokumentacją Home Assistant, przejdź do Settings > Connectors, a następnie wybierz Add > Add custom connector.
  2. Nadaj mu nazwę Home Assistant i wklej pełny adres URL, na przykład https://ha.example.com/api/mcp. Prześlij adres URL, aby Claude sprawdził serwer i wyświetlił ustawienia uwierzytelniania.
  3. Ustaw Authentication na Sign in now, a OAuth client na Use Claude's published identity, po czym wybierz Add.
  4. Na stronie nowego konektora wybierz Connect i zaloguj się do Home Assistant przy użyciu dedykowanego konta.

W planach Team lub Enterprise właściciel (Owner) dodaje konektor w sekcji Organization settings > Connectors. Każdy członek zespołu znajduje go następnie w Customize > Connectors i wybiera Connect, dzięki czemu każdy użytkownik przechodzi proces logowania do Home Assistant.

Wybór opublikowanej tożsamości (published identity) wynika ze sposobu obsługi OAuth przez Home Assistant. Home Assistant implementuje OAuth 2.0 z mechanizmem PKCE (proof key for code exchange). Obsługuje dokumenty metadanych OAuth Client ID, dzięki czemu identyfikator klienta (client ID) oraz adres URL wywołania zwrotnego (callback URL) są konfigurowane automatycznie. Home Assistant nie korzysta z klucza tajnego klienta (client secret). Nie wspiera również dynamicznej rejestracji klientów zgodnie z RFC 7591, a dokumentacja wskazuje, że klienci wymagający tego standardu „nie mogą zarejestrować się automatycznie”. W przypadku innych klientów MCP dokumentacja podaje, że identyfikator klienta musi być bazowym adresem URL aplikacji klienckiej, a „nigdy adresem URL instancji Home Assistant”.

Dodawanie Home Assistant do Claude Code

claude mcp add --transport http home-assistant https://ha.example.com/api/mcp
claude mcp login home-assistant

claude mcp login uruchamia proces OAuth serwera z poziomu powłoki. Obsługuje również --no-browser w przypadku sesji SSH na zdalnym serwerze. Domyślnie claude mcp add korzysta z zakresu lokalnego, co ogranicza serwer do bieżącego projektu na tej maszynie. Należy dodać --scope user, aby udostępnić go w każdym projekcie. Wewnątrz Claude Code polecenie /mcp wskazuje, czy serwer jest połączony. Jeśli Claude Code działa w systemie Linux i konfiguracja nie została jeszcze przeprowadzona, instalację opisano w uruchamianiu Claude na pulpicie Linux oraz w CLI.

Tokeny długoterminowe czy OAuth: co oznaczają starsze poradniki?

Starsze poradniki zalecają tworzenie długoterminowych tokenów dostępu (Long-lived access token). Było to poprawne w momencie ich publikacji. Żadne pojedyncze wydanie Home Assistant nie wprowadziło nagłej zmiany z tokenów na OAuth. Zmiana następowała etapami:

  • Pierwsza dokumentacja MCP Server, przygotowana dla wersji 2025.2, zawierała informację: "Na ten moment do kontroli dostępu do API można użyć długoterminowego tokenu dostępu".
  • Metoda PKCE z algorytmem S256 pojawiła się w kodzie źródłowym Home Assistant w wersji 2026.10.0. W wersji 2026.9.0 nie była jeszcze dostępna.
  • Obecna strona dokumentacji MCP Server nie wspomina o tokenach długoterminowych.

Poradnik, który instruuje wklejenie tokenu do nagłówka żądania, opisuje starszą konfigurację. Należy korzystać z aktualnych kroków dotyczących OAuth opisanych powyżej.

Kiedy serwer ha-mcp społeczności jest lepszym wyborem?

ha-mcp to osobny projekt na licencji MIT. Plik README w wersji v9.2.0 wymienia 87 narzędzi. README w domyślnej gałęzi również wskazuje na 87; wcześniejsza wersja v9.3.0.dev3663 podawała 86, więc liczba ta zmienia się między kompilacjami. Wybierz ha-mcp, jeśli potrzebujesz większego, wyspecjalizowanego zestawu narzędzi niż te oferowane wbudowane i akceptujesz inny model uwierzytelniania.

Zalecaną metodą instalacji w wersji v9.2.0 jest integracja HA-MCP. Działa ona wewnątrz Home Assistant i wymaga wersji Home Assistant 2026.8.0 lub nowszej. W wersjach od 2026.8 do 2026.10 instalację przeprowadza się przez HACS (Home Assistant Community Store). Od wersji 2026.11 znajduje się ona w Settings > Marketplace. Po restarcie dodaj HA-MCP Server w sekcji Settings > Devices & services > Add Integration. Integracja działa z uprawnieniami administratora, a dokumentacja projektu zaleca utworzenie dedykowanego konta dla HA-MCP. Projekt dostarcza również obraz Docker, pakiet PyPI oraz aplikację (dodatek) dla Home Assistant, a jego README opisuje tryb lokalny stdio przeznaczony wyłącznie do testów.

Przypinanie stabilnego wydania

W dniu 22 listopada 2026 najnowszym stabilnym wydaniem była wersja v9.2.0, opublikowana 11 listopada. Kompilacje deweloperskie (.devN) są publikowane przy każdym wypchnięciu do gałęzi master. Zalecenie projektu jest jasne: "Wydania deweloperskie (.devN) mogą zawierać błędy. Do zastosowań produkcyjnych należy korzystać ze stabilnych wydań". Zainstaluj wydanie v9.2.0, a nie kompilację .devN. Tagi :latest oraz :stable obrazu Docker śledzą stabilne wydania i nigdy nie wskazują na kompilacje deweloperskie. Jeśli uruchamiasz go za pomocą uvx, polecenie z README kończy się na @latest. Zastąp je przez @9.2.0, ponieważ składnia @ narzędzia uv wymaga podania dokładnej wersji. Pakiet PyPI wymaga środowiska Python 3.13 lub 3.14.

Adres private_ URL jako hasło

Wbudowany serwer wymusza logowanie do Claude. W trybie tajnego adresu URL serwera ha-mcp logowanie nie jest wymagane. W sieci lokalnej adres wygląda jak http://<ha-ip>:9584/private_<random>. Zdalnie jest to adres webhook, na przykład https://<your-ha-domain>/api/webhook/<webhook-id>. Dokumentacja projektu stwierdza, że "ścieżka jest poświadczeniem" i zaleca: "Traktuj ten adres URL jak hasło: nie udostępniaj go ani nie wklejaj w miejscach, gdzie mógłby zostać zapisany w logach". Każdy, kto posiada pełny adres URL, uzyskuje dostęp do serwera MCP, a po drodze nie ma strony logowania.

Zmienia to model zagrożeń. Adres URL wklejony do współdzielonego czatu lub pozostawiony w logach proxy daje pełny dostęp. W przypadku wycieku należy wygenerować nowy identyfikator webhooka, aby go zastąpić. Dodaj /readonly na końcu punktu końcowego, aby uzyskać połączenie, które ukrywa narzędzia do zapisu i blokuje wywołania zapisu. Te same poświadczenia nadal działają w standardowym punkcie końcowym, więc ten przyrostek nie ogranicza uprawnień osoby posiadającej adres URL. Dostęp zdalny działa przez Nabu Casa remote UI lub własny reverse proxy. W przypadku Cloudflare Tunnel, README odsyła do kreatora konfiguracji (Setup Wizard).

ha-mcp posiada również tryb OAuth, oznaczony jako beta. Nadal wymaga on od każdego użytkownika wklejenia długoterminowego tokena dostępu Home Assistant do formularza zgody. Jest to mechanizm odmienny od logowania wbudowanego serwera. Integracja oferuje również ha_auth, który wykorzystuje własny system logowania Home Assistant i akceptuje wyłącznie konta administratorów.

Dlaczego konektor nie może się zalogować?

Strona logowania się nie pojawia lub Claude zgłasza brak możliwości połączenia z serwerem. Chmura Anthropic nie ma dostępu do podanego adresu URL. Należy przetestować dostępność na porcie 443 z sieci zewnętrznej oraz sprawdzić listę dozwolonych adresów (allowlist), jeśli jest stosowana.

Logowanie kończy się błędami OAuth za proxy. Dokumentacja Home Assistant wskazuje przyczynę: brak nagłówków reverse-proxy (X-Forwarded-Host, X-Forwarded-Proto) lub ich niezgodność. Dokumentacja dodaje, że „zgodne klienty OAuth odrzucają te metadane”. Adres URL generowany przez Home Assistant musi być identyczny z nazwą hosta i schematem używanym przez Claude. Należy poprawić nagłówki proxy oraz ustawienie Trusted proxies.

Żądanie do /register zwraca błąd 404. Klient próbował użyć Dynamic Client Registration, czego Home Assistant nie obsługuje. W ustawieniach Claude należy skonfigurować klienta OAuth na Use Claude's published identity.

Znany otwarty problem. W dniu 15 listopada 2026 r. w zgłoszeniu #183050 odnotowano problem z działaniem konektora claude.ai w połączeniu z /api/mcp na wersji Core 2026.11.0. Zgłoszenie jest otwarte i wymaga dodatkowych informacji; nie potwierdzono żadnego rozwiązania. Przed rozpoczęciem pracy z konektorem należy przeprowadzić testy.

FAQ

Czy Claude Desktop łączy się z Home Assistant z mojego komputera?

Nie w przypadku niestandardowego konektora. Zarówno Anthropic, jak i Home Assistant podają, że Claude łączy się z chmury Anthropic, również w aplikacji Claude Desktop. Dlatego Home Assistant wymaga publicznego adresu HTTPS na porcie 443. Wyjątkiem są serwery lokalne w claude_desktop_config.json oraz Claude Code, które łączą się bezpośrednio z Twojej maszyny.

Czy Claude może otworzyć bramę garażową przez Home Assistant MCP?

Tak, jeśli konto i zestaw narzędzi na to pozwalają. Assist domyślnie udostępnia nowe osłony (covers), a kategoria ta obejmuje bramy garażowe i wjazdowe, więc zestaw narzędzi Device control zazwyczaj ma do nich dostęp. Zestaw narzędzi Home Assistant może wykonać dowolną akcję. Jeśli Claude nie powinien nimi sterować, usuń te encje z udostępniania w Assist lub włącz tryb Read-only dla głównego adresu URL.

Czy nadal potrzebuję długowiecznego tokena dostępu (long-lived access token) dla serwera Home Assistant MCP?

Nie w przypadku wbudowanego serwera. Obecna dokumentacja wykorzystuje OAuth 2.0 z PKCE i nie wspomina o tokenach długowiecznych. Tokeny były metodą opisaną w pierwszej dokumentacji 2025.2. Społecznościowy serwer ha-mcp działa inaczej: jego tryb beta OAuth nadal wymaga wklejenia tokena długowiecznego.

Zostałem zablokowany w Home Assistant po kilku nieudanych próbach połączenia przez konektor. Co się stało?

Mechanizm IP banning zablokował adres, z którego logowanie zakończyło się niepowodzeniem. Dokumentacja Home Assistant wskazuje, że najczęstszą przyczyną jest błędny szczegół OAuth, taki jak client ID lub adres URL Home Assistant. Otwórz ip_bans.yaml w katalogu konfiguracyjnym Home Assistant, usuń wpis dotyczący zablokowanego adresu i zrestartuj Home Assistant. Przed ponowną próbą popraw ustawienia konektora.

Czy ten artykuł był przydatny?

#claude#mcp#home-assistant#smart-home#remote-access