Integrasi: Asisten AI

Agent DVR dapat digunakan langsung dari asisten AI seperti Claude, ChatGPT, Cursor dan VS Code Copilot. Tanyakan dalam bahasa biasa - "peringatan apa yang saya alami semalam?", "tunjukkan apa yang terjadi pada kamera jalan masuk pagi ini", "nonaktifkan kamera di garasi" - dan asisten menjawab dari kamera langsung Anda, rekaman dan log peringatan, termasuk gambar.

Ini berfungsi melalui Model Context Protocol (MCP), standar terbuka yang digunakan asisten untuk terhubung ke peralatan eksternal. Agent DVR menyediakan server MCP di dua tempat, dan Anda menghubungkan asisten Anda ke salah satu yang sesuai dengan Anda:

• Bawaan Agent DVR (Titik Akhir Lokal): dilayani oleh server Anda sendiri di jaringan lokal Anda. Tidak memerlukan akun atau langganan. Untuk asisten yang berjalan di komputer atau LAN yang sama.
• Melalui iSpyConnect.com (Titik Akhir Cloud): menjangkau server Anda melalui akses jarak jauh yang sama dengan yang digunakan portal web dan aplikasi seluler, dari mana saja, tanpa penerusan port. Memerlukan langganan iSpyConnect. Ini adalah yang harus digunakan untuk claude.ai, ChatGPT dan ponsel.

Keduanya mengekspos rangkaian peralatan yang sama. Memerlukan Agent DVR 8.0.3 atau lebih baru.

Setiap server Agent DVR melayani MCP di /mcp pada server web lokalnya, jadi jika Anda membuka UI Agent DVR di http://localhost:8090 titik akhirnya adalah http://localhost:8090/mcp (gunakan alamat dan port server Anda dari komputer lain di LAN, misalnya http://192.168.1.10:8090/mcp). Ini diaktifkan secara bawaan dan dapat dimatikan dengan AI Assistant (MCP) Endpoint di Pengaturan Server - Server Lokal.

Akses mengikuti aturan yang sama persis dengan sisa API lokal: dari jaringan Anda sendiri tidak perlu login, kecuali jika Lindungi API diaktifkan, dalam hal ini asisten harus mengirimkan nama pengguna dan kata sandi pengguna admin (sebagian besar klien MCP memungkinkan Anda menambahkan header Otorisasi). Koneksi dari luar jaringan Anda juga memerlukan Lisensi, sama seperti akses ke UI yang diteruskan port.

Claude Code

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

Cursor

Tambahkan ke .cursor/mcp.json (atau melalui Pengaturan - MCP):

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

VS Code (Copilot)

Tambahkan ke .vscode/mcp.json:

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

Claude Desktop

Aplikasi desktop Claude tidak dapat memanggil server di komputer Anda sendiri secara langsung, jadi menggunakan ekstensi kecil yang melakukannya untuk Anda. Unduh AgentDVR.mcpb, kemudian di Claude Desktop buka Pengaturan - Ekstensi dan seret berkas ke halaman. Ini dipasang dengan diaktifkan dan terhubung ke http://localhost:8090/mcp; klik Konfigurasi hanya jika server Anda berada di komputer lain atau memiliki Lindungi API diaktifkan. Claude meminta izin pertama kali setiap alat digunakan - pilih "Selalu izinkan" untuk menghentikan permintaan.

Asisten lainnya

Klien apa pun yang mendukung MCP melalui HTTP ("Streamable HTTP") dapat menggunakan URL yang sama. Cari "server MCP", "konektor" atau "peralatan" di pengaturan asisten.

Aplikasi web Claude dan aplikasi seluler, dan ChatGPT, tidak dapat menjangkau server di jaringan Anda sendiri sama sekali; mereka menggunakan Titik Akhir Cloud.

Dengan langganan iSpyConnect, server Anda juga dapat diakses di:

https://www.ispyconnect.com/mcp

Tambah URL tersebut sebagai konektor kustom atau server MCP di asisten Anda (misalnya Pengaturan - Konektor di claude.ai dan aplikasi Claude, atau yang setara di ChatGPT dan Cursor). Asisten membuka halaman masuk iSpyConnect; masuk, pilih apakah akan mengizinkan kontrol serta penayangan, dan klik Izinkan. Tidak ada yang perlu dikonfigurasi lebih lanjut: setiap server Agent DVR yang terhubung ke akun Anda dengan akses jarak jauh diaktifkan tersedia, dan asisten akan bertanya server mana yang Anda maksud jika Anda memiliki lebih dari satu.

Permintaan perjalanan melalui relai yang sama dengan yang digunakan portal web, jadi tidak diperlukan penerusan port dan server Anda tidak akan pernah terbuka ke internet. Akses berhenti saat langganan Anda berakhir, dan akses setiap asisten dapat dihapus dari pengaturan konektor asisten itu sendiri kapan saja.

Server Anda harus berjalan dan terhubung ke iSpyConnect (ikon gembok di UI lokal menunjukkan status koneksi jarak jauh). Blokir akses eksternal di Pengaturan Server juga memblokir titik akhir ini.

Asisten melihat serangkaian peralatan khusus yang dibuat untuk tujuan tertentu daripada API mentah, sehingga jawaban tetap cepat dan murah:

• Tampilan: daftarkan server dan perangkat Anda (dengan lokasi dan kesehatan), dapatkan ringkasan aktivitas (perekaman dan peringatan per kamera per jam, dengan apa yang terdeteksi), daftarkan rekaman dalam jendela waktu, lihat seluruh jendela sekali pandang sebagai kisi bingkai, lihat kamera sepanjang hari sebagai linimasa bingkai, ambil sampel bingkai dari satu perekaman, ambil tangkapan langsung kamera, baca log peringatan, dan dapatkan tautan untuk membuka perekaman di antarmuka web.
• Kontrol: aktifkan dan nonaktifkan server, terapkan profil, aktifkan atau nonaktifkan perangkat, ubah mode perekaman, nyalakan atau matikan peringatan dan detektor, pindahkan kamera PTZ ke preset, dan perubahan status lainnya dari API.
• Selebihnya: katalog perintah baca dan kontrol lebih lanjut yang dapat dipanggil asisten saat tidak ada peralatan khusus yang sesuai (statistik sistem, status lengkap perangkat, preset PTZ dan sebagainya).

Asisten tidak dapat menghapus rekaman atau foto, mengubah konfigurasi perangkat atau server, menambah atau menghapus perangkat, atau memulai ulang server: perintah tersebut sengaja tidak ditawarkan, terlepas dari titik akhir mana yang digunakan. Pada titik akhir cloud, tampilan dan kontrol adalah izin terpisah yang anda berikan pada halaman masuk, dan penggunaan dibatasi kecepatan untuk melindungi relai.

Contoh petunjuk

• "Apakah ada yang pergi ke pintu depan dalam 24 jam terakhir? Tunjukkan kepada saya."
• "Burung apa saja yang mengunjungi pengumpan pagi ini?"
• "Seberapa sibuk jalan masuk hari ini, dan kapan?"
• "Tunjukkan taman belakang saya sepanjang hari. Kapan mulai hujan?"
• "Apa peringatan yang saya terima kemarin, dan apakah ada yang berupa orang?"
• "Siapa di pintu depan sekarang?"
• "Kamera mana yang luring?"
• "Kami akan pergi - aktifkan semuanya dengan profil Pergi."
• "Nonaktifkan semua kamera di lokasi rumah."
• "Kirimkan saya tautan ke klip kurir."

Alur kerja siap pakai

Server juga menawarkan templat permintaan yang ditampilkan oleh asisten dengan dukungan permintaan (Claude Desktop, Claude Code, Cursor dan lainnya) sebagai perintah garis miring atau dalam menu. Setiap satu menjalankan alur kerja multi-langkah lengkap dan melaporkan hasil:

• morning_briefing - apa yang dilihat kamera sejak kemarin sore: aktivitas, peringatan, orang, kendaraan dan hewan yang penting, serta kesehatan kamera.
• door_report - siapa yang datang ke kamera pintu, dengan waktu, apa yang dilakukan setiap pengunjung dan tautan ke setiap klip.
• wildlife_report - hewan dan burung apa yang ditangkap kamera, diidentifikasi sedekat mungkin yang memungkinkan footage.
• camera_health - setiap server dan kamera diperiksa untuk luring, dinonaktifkan, kesalahan dan kamera yang telah hening.
• day_in_review - kamera sepanjang hari sebagai linimasa bingkai, dengan narasi tentang bagaimana adegan berubah.

• Asisten tidak dapat terhubung ke titik akhir lokal: periksa URL di browser - http://localhost:8090/mcp harus merespons (pesan kesalahan tidak masalah; "koneksi ditolak" tidak). Pastikan port cocok dengan Pengaturan Server - Server Lokal dan bahwa titik akhir diaktifkan di sana.
• 401 Tidak Sah: Lindungi API diaktifkan, jadi asisten harus mengirimkan kredensial pengguna admin, atau Anda terhubung dari luar jaringan Anda.
• 403 Dilarang: terhubung dari luar jaringan Anda tanpa lisensi. Gunakan Titik Akhir Cloud sebagai gantinya.
• 404 Tidak Ditemukan: titik akhir dimatikan di Pengaturan Server, atau server lebih lama dari 8.0.3.
• Titik akhir cloud mengatakan server luring: server tidak terhubung ke iSpyConnect. Periksa ikon gembok di antarmuka lokal dan bahwa Blokir akses eksternal tidak aktif.
• Melihat apa yang dilakukan oleh asisten: atur Pencatatan Log ke Debug dalam Pengaturan Server dan buka log dari menu server. Pada titik akhir lokal setiap permintaan dan panggilan peralatan dicatat dengan awalan "MCP", termasuk Argumen dan berapa lama waktu yang dibutuhkan. Melalui titik akhir cloud peralatan berjalan di iSpyConnect.com dan server hanya melihat Perintah individual yang mereka kirim, dicatat dengan awalan "RelayApi".