Ampio MCP

Najczęściej zadawane pytania

Jak działa Ampio MCP, co obsługuje i co potrafi.

Jak to wygląda w Claude Code

Jak to działa

Czym jest Ampio MCP?

Serwis, który pozwala Claude odczytywać i programować logikę instalacji Ampio. Opisujesz, co ma się dziać w budynku — „po przytrzymaniu przycisku w holu zamknij wszystkie rolety” — a Claude zamienia to na reguły, pokazuje podgląd i zapisuje je dopiero po Twoim zatwierdzeniu.

Jak Claude łączy się z moją instalacją?
  • W sieci instalacji działa niewielki agent (kontener Docker). Komunikuje się z M-SERV przez MQTT i utrzymuje jedno połączenie wychodzące z tym serwerem — bez otwartych portów i przekierowań.
  • Claude łączy się z serwerem jako konektor (MCP przez HTTPS, z logowaniem na Twoje konto przez OAuth).
  • Logika Ampio działa na serwerze; agent przekazuje tylko nieliczne, ściśle określone zapytania serwera, więc nie jest ogólną bramą do Twojej sieci.
  • Dane logowania MQTT (oraz Node-RED, jeśli jest używany) pozostają na agencie.
Co się dzieje, gdy Claude coś zmienia?
  1. Claude przygotowuje podgląd: reguły przed zmianą i po niej, ostrzeżenia oraz zajętość pamięci logiki w module.
  2. Zapoznajesz się z nim i zatwierdzasz — wcześniej nic nie jest zapisywane.
  3. Serwer ponownie odczytuje moduł i odmawia zapisu, jeśli jego logika w międzyczasie się zmieniła, wykonuje kopię zapasową, zapisuje zmiany i odczytuje je ponownie w celu weryfikacji.

Każdą kopię zapasową można później przywrócić; poproś Claude o ich listę.

Jak zacząć?
  1. Załóż konto; aktywuje je administrator.
  2. Dodaj instalację: uruchom wskazanego tam agenta i wpisz jego kod parowania.
  3. Połącz Claude i zaloguj się, gdy Claude o to poprosi.
W jakim języku Claude nadaje nazwy?

W języku wybranym dla instalacji podczas konfiguracji agenta (English lub Polski): w tym języku Claude tworzy opisy reguł, nazwy elementów, zdarzeń, grup i folderów oraz etykiety Node-RED — niezależnie od języka rozmowy. W tym języku są też komunikaty samego agenta.

Czy kilka osób lub firm może pracować na jednej instalacji?

Tak. Każde konto, które doda ten sam M-SERV, otrzymuje własną, niezależną instalację (własnego agenta, kopie zapasowe i licencję). W obrębie jednego konta wszyscy agenci tego samego M-SERV dołączają do tej samej instalacji.

Co jest obsługiwane

Jakie modele AI i aplikacje?
  • Claude — claude.ai, aplikacja desktopowa Claude i Claude Code, z dowolnym modelem Claude używanym przez aplikację (Opus, Sonnet, Haiku). Większe modele najlepiej radzą sobie z długimi, wieloetapowymi zmianami.
  • Aplikacje na Twoim komputerze łączące się przez http://localhost (np. Claude Code) — strona zgody wyraźnie je oznacza.
  • Inne usługi nie mogą się połączyć: autoryzacja jest przekazywana wyłącznie do Claude lub na localhost.
Jakie moduły Ampio?
  • Aktualne oprogramowanie (protokół 25 i nowszy): logika jest odczytywana i zapisywana we własnym formacie modułu, dokładnie tak jak robi to Ampio Designer — przyciski i panele M-DOT, przekaźniki i wyjścia binarne, ściemniacze, wyjścia LED / RGBW / CCT, rolety, HVAC i strefy klimatu, czujniki temperatury, natężenia światła, CO₂ i wilgotności, flagi, czytniki kart, buzzery, panele LCD, zegar RTC, strefy i wyjścia alarmowe, klawiatury PIN oraz audio Arylic.
  • Starsze moduły (protokół poniżej 25): ich logika jest odczytywana i zapisywana osobną ścieżką, z tym samym podglądem, kopią zapasową i weryfikacją zapisu.
  • CAN-net: zdarzenia i grupy jako wyzwalacze oraz akcje reguł.
  • Reguły urządzeń podrzędnych (Satel, RS232, Zamel, Modbus) są wyświetlane; zmienić można tylko ich włączenie, opis i folder.

Format reguł odpowiada wersji Ampio Designer z listopada 2026.

Czy instalacja wymaga czegoś jeszcze?

Wyłącznie Dockera na komputerze w tej samej sieci co M-SERV — dla agenta. M-SERV nie wymaga żadnych zmian.

Możliwości

Logika (reguły)
  • Wyświetlanie i objaśnianie reguł każdego modułu prostym językiem.
  • Tworzenie, zmiana, włączanie / wyłączanie i usuwanie reguł; wiele zmian w jednym module w ramach jednego zapisu.
  • Wyzwalacze z czasami naciśnięcia / przytrzymania, liczbą naciśnięć, wartościami i porównaniami; do trzech bloków wyzwalaczy połączonych AND / OR.
  • Wybór modułu do zapisu reguły, gdy akcją jest grupa lub zdarzenie CAN-net: tam, gdzie są już wyjścia grupy lub powiązane reguły, w tym samym pomieszczeniu, z wolną pamięcią, z równomiernym rozłożeniem logiki.
  • Foldery jak w Designerze; eksport i import pliku reguł Designera; kopiowanie reguły do innego modułu.
  • Jednorazowy test akcji (jak przycisk testu w Designerze) bez zapisywania czegokolwiek.
Nazwy, zdarzenia i grupy
  • Zmiana nazw wejść, wyjść i flag modułu.
  • Tworzenie, zmiana nazw i usuwanie zdarzeń CAN-net.
  • Tworzenie grup CAN-net i zmiana należących do nich wyjść.
Node-RED

Jeśli na M-SERV działa Node-RED (port 1880), Claude może wyświetlać i odczytywać jego przepływy, tworzyć, zmieniać lub usuwać pojedynczy przepływ oraz wyzwalać węzeł inject — z tym samym podglądem, kopią zapasową i weryfikacją zapisu. Ustaw NODERED_URL na agencie, aby wskazać inny adres, lub NODERED_URL=off, aby wyłączyć tę funkcję.

Bezpieczeństwo
  • Nic nie jest zapisywane bez zatwierdzenia podglądu.
  • Kopia zapasowa przed każdym zapisem; każdą z nich można przywrócić.
  • Serwer odmawia zapisu modułu, którego logiki nie rozumie w pełni, lub takiego, który zmienił się od czasu podglądu.
  • Każde konto widzi wyłącznie własne instalacje; administratorzy zatwierdzają konta i dodatkowe instalacje.