Integracje: Asystenci AI

Agent DVR może być używany bezpośrednio z asystentami AI, takimi jak Claude, ChatGPT, Cursor i VS Code Copilot. Pytaj w zwykłym języku - "jakie alerty miałem ostatniej nocy?", "pokaż mi, co się stało na kamerze na podjeździe tego ranka", "wyłącz kamery w garażu" - a asystent odpowiada na podstawie twoich kamer na żywo, nagrań i dziennika alertów, w tym obrazów.

To działa poprzez Model Context Protocol (MCP), otwarty standard, który asystenci używają do łączenia się z zewnętrznymi narzędziami. Agent DVR udostępnia serwer MCP w dwóch miejscach i łączysz swojego asystenta z tym, który odpowiada tobie:

• Wbudowany w Agent DVR (Lokalny punkt końcowy): obsługiwany przez twój własny serwer w sieci lokalnej. Nie jest wymagane konto ani subskrypcja. Dla asystentów działających na tym samym komputerze lub sieci LAN.
• Poprzez iSpyConnect.com (Punkt końcowy chmury): dociera do twoich serwerów poprzez ten sam dostęp zdalny, który używają portal internetowy i aplikacje mobilne, z dowolnego miejsca, bez przekierowania portów. Wymaga subskrypcji iSpyConnect. To ten, który należy używać dla claude.ai, ChatGPT i telefonów.

Oba udostępniają ten sam zestaw narzędzi. Wymaga Agent DVR 8.0.3 lub nowszej.

Każdy serwer Agent DVR obsługuje MCP na ścieżce /mcp na swoim lokalnym Serwerze WWW, dlatego jeśli otworzysz interfejs Agent DVR pod adresem http://localhost:8090, punkt końcowy to http://localhost:8090/mcp (użyj adresu i portu serwera z innego komputera w sieci lokalnej, na przykład http://192.168.1.10:8090/mcp). Jest włączony domyślnie i można go wyłączyć za pomocą opcji AI Assistant (MCP) Endpoint w Ustawienia serwera - Serwer lokalny.

Dostęp przestrzega dokładnie tych samych reguł co pozostała część lokalnego API: z twojej własnej sieci logowanie nie jest wymagane, chyba że Zabezpiecz API jest włączone, w którym to przypadku asystent musi wysłać nazwę użytkownika i hasło administratora (większość klientów MCP pozwala na dodanie Nagłówka autoryzacji). Połączenia spoza twojej sieci dodatkowo wymagają licencji, takiej samej jak dostęp przez przekierowanie portów do interfejsu.

Claude Code

claude mcp add --transport http agentdvr http://localhost:8090/mcp

Cursor

Dodaj do .cursor/mcp.json (lub poprzez Ustawienia - MCP):

{ "mcpServers": { "agentdvr": { "url": "http://localhost:8090/mcp" } } }

VS Code (Copilot)

Dodaj do .vscode/mcp.json:

{ "servers": { "agentdvr": { "type": "http", "url": "http://localhost:8090/mcp" } } }

Claude Desktop

Aplikacja Claude Desktop nie może bezpośrednio wywoływać serwera na twoim komputerze, więc używa małego rozszerzenia, które robi to za ciebie. Pobierz AgentDVR.mcpb, a następnie w Claude Desktop otwórz Ustawienia - Rozszerzenia i przeciągnij plik na stronę. Instaluje się z włączonym stanem i łączy się z http://localhost:8090/mcp; kliknij Konfiguruj tylko jeśli twój serwer znajduje się na innym komputerze lub ma włączone Zabezpiecz API. Claude prosi o pozwolenie za pierwszym razem, gdy każde narzędzie jest używane - wybierz "Zawsze zezwól", aby zatrzymać monity.

Inne asystenci

Dowolny klient obsługujący MCP przez HTTP ("Streamable HTTP") może używać tego samego adresu URL. Szukaj "Serwerów MCP", "łączników" lub "narzędzi" w ustawieniach asystenta.

Aplikacja webowa Claude i aplikacje mobilne, a także ChatGPT, nie mogą w ogóle dotrzeć do serwera w twojej sieci; używają Punktu końcowego Chmury.

W przypadku subskrypcji iSpyConnect, twoje serwery są również dostępne na:

https://www.ispyconnect.com/mcp

Dodaj ten adres URL jako łącznik niestandardowy lub serwer MCP w swoim asystencie (na przykład Ustawienia - Łączniki w claude.ai i aplikacjach Claude, lub odpowiednik w ChatGPT i Cursor). Asystent otwiera stronę logowania iSpyConnect; zaloguj się, wybierz, czy zezwolić na kontrolę oraz przeglądanie, i kliknij Zezwól. Nic więcej nie wymaga konfiguracji: każdy serwer Agent DVR połączony z twoim kontem z włączonym dostępem zdalnym jest dostępny, a asystent zapyta, który masz na myśli, jeśli masz więcej niż jeden.

Żądania przesyłane są przez to samo przekierowanie, które wykorzystuje portal internetowy, więc nie jest wymagane przekierowanie portów i twój serwer nigdy nie jest narażony na internet. Dostęp zatrzymuje się, gdy twoja subskrypcja wygasa, a dostęp każdego asystenta można usunąć z ustawień łącznika asystenta w dowolnym momencie.

Twój serwer musi być uruchomiony i połączony z iSpyConnect (ikona kłódki w lokalnym interfejsie użytkownika pokazuje stan połączenia zdalnego). Blokuj dostęp zewnętrzny w Ustawienia serwera blokuje również ten punkt końcowy.

Asystenci mają dostęp do małego zestawu specjalistycznych narzędzi zamiast surowego API, dlatego odpowiedzi pozostają szybkie i tanie:

• Wyświetlanie: wyświetl listę swoich serwerów i urządzeń (wraz z lokalizacją i stanem zdrowotnym), uzyskaj podsumowanie aktywności (Nagrania i Alerty na kamerę na godzinę, z informacją o tym, co zostało Wykryto), wyświetl listę nagrań w oknie czasowym, zobacz całe okno na pierwszy rzut oka jako siatkę klatek, zobacz kamerę przez dzień jako Oś czasu klatek, pobierz próbki klatek z jednego nagrania, zrób żywe zdjęcie kamery, przeczytaj dziennik alertów i uzyskaj łącze do otwarcia nagrania w interfejsie internetowym.
• Sterowanie: włącz i wyłącz serwer, zastosuj profile, włącz lub wyłącz urządzenia, zmień tryby nagrywania, przełącz alerty i detektory wł. lub wył., przesuń kamery PTZ do ustawień wstępnych i inne zmiany stanu z API.
• Wszystko inne: katalog dalszych poleceń odczytu i sterowania, które asystent może wywołać, gdy żadne dedykowane narzędzie nie pasuje (statystyka systemu, pełny status urządzenia, ustawienia wstępne PTZ itd.).

Asystent nie może usuwać nagrań ani zdjęć, zmieniać konfiguracji urządzenia lub serwera, dodawać ani usuwać urządzeń ani restartować serwera: te polecenia są celowo niedostępne, niezależnie od używanego punktu końcowego. W punkcie końcowym chmury wyświetlanie i sterowanie to oddzielne uprawnienia, które przyznasz na stronie logowania, a użycie jest ograniczone szybkością, aby chronić przekaźnik.

Przykładowe instrukcje

• "Czy ktoś był u drzwi wejściowych w ciągu ostatnich 24 godzin? Pokaż mi."
• "Jakie ptaki odwiedziły karmnik tego ranka?"
• "Jak ruchliwe były podjazd dzisiaj i kiedy?"
• "Pokaż mi ogród z tyłu przez cały dzień. Kiedy zaczęło padać?"
• "Jakie Alerty miałem wczoraj i czy któreś z nich dotyczyły Ludzi?"
• "Kto jest teraz u drzwi wejściowych?"
• "Które kamery są w trybie offline?"
• "Wychodzimy - aktywuj wszystko z Profilem Nieobecności."
• "Wyłącz wszystkie kamery w lokalizacji domu."
• "Wyślij mi łącze do klipu z kurierem."

Gotowe przepływy pracy

Serwer oferuje także szablony poleceń które asystenci z obsługą poleceń (Claude Desktop, Claude Code, Cursor i inni) wyświetlają jako polecenia ukośnikowe lub w menu. Każdy z nich uruchamia kompletny wieloetapowy przepływ pracy i raportuje Wynik:

• morning_briefing - co kamery zarejestrowały od ostatniego wieczoru: Aktywność, Alerty, godne uwagi Ludzie, pojazdy i zwierzęta oraz stan zdrowotny kamery.
• door_report - kto przyszedł do kamery u drzwi, z podaniem godzin, co każdy odwiedzający robił i łącze do każdego klipu.
• wildlife_report - jakie zwierzęta i ptaki kamera nagrała, zidentyfikowane tak dokładnie, jak pozwala na to materiał filmowy.
• camera_health - każdy serwer i kamera sprawdzeni pod kątem dostępności, Wyłączenia, błędów i kamer, które milczą.
• day_in_review - kamera przez cały dzień jako Oś czasu klatek, z opisem zmian w scenie.

• Asystent nie może się połączyć z lokalnym punktem końcowym: sprawdź adres URL w przeglądarce - http://localhost:8090/mcp powinien odpowiedzieć (komunikat o błędzie jest w porządku; "connection refused" nie). Upewnij się, że port jest zgodny z Ustawienia serwera - Serwer lokalny i że punkt końcowy jest tam włączony.
• 401 Unauthorized: Zabezpiecz API jest włączone, więc asystent musi wysłać poświadczenia użytkownika administracyjnego albo łączysz się spoza sieci.
• 403 Forbidden: łączenie się spoza sieci bez licencji. Zamiast tego użyj Punktu końcowego chmury.
• 404 Not found: punkt końcowy jest wyłączony w Ustawienia serwera albo serwer jest starszy niż 8.0.3.
• Punkt końcowy chmury mówi, że serwer jest offline: serwer nie jest połączony z iSpyConnect. Sprawdź ikonę kłódki w lokalnym interfejsie i że Blokuj dostęp zewnętrzny jest wyłączone.
• Widzenie, co robi asystent: ustaw opcję Logowanie na Debugowanie w Ustawienia serwera i otwórz dzienniki z Menu serwera. Na lokalnym punkcie końcowym każde żądanie i wywołanie narzędzia jest rejestrowane z prefiksem "MCP", łącznie z Argumenty i czasem trwania. Za pośrednictwem punktu końcowego Chmura narzędzia działają na iSpyConnect.com, a serwer widzi tylko poszczególne Polecenia, które wysyłają, zarejestrowane z prefiksem "RelayApi".