Tích hợp: Trợ lý AI

Agent DVR có thể được sử dụng trực tiếp từ các Trợ lý AI như Claude, ChatGPT, Cursor và VS Code Copilot. Hỏi bằng ngôn ngữ thường - "tôi có những Cảnh báo nào đêm qua?", "cho tôi xem điều gì đã xảy ra trên camera lối vào buổi sáng nay", "tắt các Camera trong phòng để xe" - và trợ lý sẽ trả lời từ các camera TRỰC TIẾP, Các bản ghi và nhật ký Cảnh báo của bạn, bao gồm các hình ảnh.

Điều này hoạt động thông qua Model Context Protocol (MCP), tiêu chuẩn mở mà các trợ lý sử dụng để kết nối với dụng cụ bên ngoài. Agent DVR cung cấp máy chủ MCP ở hai vị trí, và bạn kết nối trợ lý của mình với vị trí phù hợp với bạn:

• Tích hợp trong Agent DVR (Điểm cuối cục bộ): được phục vụ bởi Máy chủ của riêng bạn trên mạng cục bộ của bạn. Không cần Tài khoản hoặc đăng ký. Dành cho các trợ lý chạy trên cùng một máy tính hoặc LAN.
• Thông qua iSpyConnect.com (Điểm cuối đám mây): tiếp cận các Máy chủ của bạn qua Truy cập từ xa giống như cổng web và các ứng dụng di động sử dụng, từ bất kỳ nơi nào, mà không cần chuyển tiếp Cổng. Cần đăng ký iSpyConnect. Đây là cái bạn sử dụng cho claude.ai, ChatGPT và điện thoại.

Cả hai expose cùng một bộ dụng cụ. Yêu cầu Agent DVR 8.0.3 trở lên.

Mọi máy chủ Agent DVR phục vụ MCP tại /mcp trên máy chủ Web cục bộ của nó, vì vậy nếu bạn mở giao diện Agent DVR tại http://localhost:8090 thì điểm cuối là http://localhost:8090/mcp (sử dụng địa chỉ và cổng của máy chủ của bạn từ máy tính khác trên LAN, ví dụ http://192.168.1.10:8090/mcp). Nó được bật theo mặc định và có thể được tắt bằng AI Assistant (MCP) Endpoint trong Cài đặt máy chủ - Máy chủ cục bộ.

Quyền truy cập tuân theo chính xác các quy tắc giống như phần còn lại của API cục bộ: từ mạng của riêng bạn không cần đăng nhập, trừ khi Bảo vệ API được bật, trong trường hợp đó trợ lý phải gửi tên người dùng và mật khẩu của người dùng quản trị (hầu hết các máy khách MCP cho phép bạn thêm tiêu đề Authorization). Các kết nối từ bên ngoài mạng của bạn còn yêu cầu giấy phép, giống như việc truy cập UI qua cổng được chuyển tiếp.

Claude Code

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

Cursor

Thêm vào .cursor/mcp.json (hoặc thông qua Cài đặt - MCP):

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

VS Code (Copilot)

Thêm vào .vscode/mcp.json:

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

Claude Desktop

Ứng dụng Claude trên máy tính để bàn không thể gọi trực tiếp một máy chủ trên máy tính của bạn, vì vậy nó sử dụng một tiện ích nhỏ để thực hiện việc đó cho bạn. Tải xuống AgentDVR.mcpb, sau đó trong Claude Desktop mở Cài đặt - Tiện ích và kéo tệp vào trang. Nó được cài đặt với trạng thái đã bật và kết nối tới http://localhost:8090/mcp; chỉ nhấp vào Cấu hình nếu máy chủ của bạn nằm trên một máy tính khác hoặc có Bảo vệ API được bật. Claude yêu cầu quyền lần đầu tiên mỗi công cụ được sử dụng - chọn "Luôn cho phép" để dừng các lời nhắc.

Các trợ lý khác

Bất kỳ máy khách nào hỗ trợ MCP qua HTTP ("Streamable HTTP") đều có thể sử dụng cùng một URL. Tìm "MCP servers", "connectors" hoặc "dụng cụ" trong cài đặt của trợ lý.

Ứng dụng Claude trên web và các ứng dụng di động, cũng như ChatGPT, hoàn toàn không thể truy cập máy chủ trên mạng của bạn; chúng sử dụng Điểm cuối đám mây.

Với đăng ký iSpyConnect, máy chủ của bạn cũng có thể truy cập tại:

https://www.ispyconnect.com/mcp

Thêm URL đó làm trình kết nối tùy chỉnh hoặc máy chủ MCP trong trợ lý của bạn (ví dụ: Cài đặt - Trình kết nối trong claude.ai và các ứng dụng Claude, hoặc tương đương trong ChatGPT và Cursor). Trợ lý mở trang đăng nhập iSpyConnect; đăng nhập, chọn có cho phép kiểm soát cũng như xem hay không, và nhấp Allow. Không cần cấu hình gì khác: mọi máy chủ Agent DVR được kết nối với tài khoản của bạn khi bật truy cập từ xa đều sẵn sàng, và trợ lý sẽ hỏi bạn có ý định sử dụng cái nào nếu bạn có hơn một máy.

Các yêu cầu truyền qua cùng một chuyển tiếp mà cổng web sử dụng, vì vậy không cần chuyển tiếp cổng và máy chủ của bạn không bao giờ bị lộ ra internet. Quyền truy cập dừng lại khi đăng ký của bạn hết hạn, và quyền truy cập của mỗi trợ lý có thể được xóa từ cài đặt trình kết nối riêng của trợ lý bất kỳ lúc nào.

Máy chủ của bạn phải đang chạy và kết nối với iSpyConnect (biểu tượng ổ khóa trong giao diện cục bộ hiển thị trạng thái kết nối từ xa). Chặn truy cập bên ngoài trong Cài đặt máy chủ cũng chặn điểm cuối này.

Trợ lý thấy một bộ dụng cụ được xây dựng cho mục đích cụ thể chứ không phải API thô, vì vậy câu trả lời vẫn nhanh và rẻ:

• Xem: liệt kê các máy chủ và thiết bị của bạn (với vị trí và tình trạng), nhận tóm tắt hoạt động (ghi hình và cảnh báo trên mỗi camera mỗi giờ, với những gì đã phát hiện), liệt kê các bản ghi trong một khoảng thời gian, xem toàn bộ cửa sổ một cách nhanh chóng dưới dạng lưới khung hình, xem một camera qua một ngày dưới dạng dòng thời gian các khung hình, lấy mẫu khung hình từ một bản ghi, chụp ảnh trực tiếp một camera, đọc nhật ký cảnh báo và nhận một liên kết để mở bản ghi trong giao diện web.
• Điều khiển: vũ trang và giải vũ trang máy chủ, áp dụng hồ sơ, bật hoặc tắt thiết bị, thay đổi chế độ ghi hình, bật hoặc tắt cảnh báo và bộ phát hiện, di chuyển camera PTZ đến các cài đặt sẵn, và các thay đổi trạng thái khác từ API.
• Mọi thứ khác: một danh mục các lệnh đọc và điều khiển khác mà trợ lý có thể gọi khi không có dụng cụ chuyên dụng phù hợp (thống kê hệ thống, trạng thái đầy đủ của thiết bị, cài đặt sẵn PTZ, v.v.).

Trợ lý không thể xóa các bản ghi hoặc ảnh, thay đổi cấu hình thiết bị hoặc máy chủ, thêm hoặc xóa thiết bị, hoặc khởi động lại máy chủ: những lệnh đó được cố ý không cung cấp, bất kể điểm cuối nào được sử dụng. Trên điểm cuối đám mây, xem và điều khiển là những quyền hạn riêng biệt mà bạn cấp trên trang đăng nhập, và sử dụng được giới hạn tốc độ để bảo vệ bộ chuyển tiếp.

Các lời nhắc ví dụ

• "Có ai đến cửa phía trước trong 24 giờ qua không? Cho tôi xem."
• "Những con chim nào đã ghé thăm cái chum hôm sáng?"
• "Lối vào nhà bận rộn như thế nào hôm nay, và khi nào?"
• "Cho tôi xem khu vườn phía sau qua cả ngày. Nó bắt đầu mưa khi nào?"
• "Tôi nhận được những cảnh báo nào hôm qua, và có ai trong số đó là người không?"
• "Hiện tại ai ở cửa phía trước?"
• "Camera nào ngoại tuyến?"
• "Chúng tôi sắp ra ngoài - bảo vệ mọi thứ bằng hồ sơ Away."
• "Tắt tất cả camera ở vị trí nhà."
• "Gửi cho tôi một liên kết đến clip của người giao hàng."

Quy trình công việc được chuẩn bị sẵn

Máy chủ cũng cung cấp mẫu lời nhắc mà các trợ lý hỗ trợ lời nhắc (Claude Desktop, Claude Code, Cursor và những trợ lý khác) hiển thị dưới dạng lệnh dấu gạch chéo hoặc trong một trình đơn. Mỗi cái chạy một quy trình công việc hoàn chỉnh gồm nhiều bước và báo cáo kết quả:

• morning_briefing - những gì các camera nhìn thấy kể từ tối qua: hoạt động, cảnh báo, những người, phương tiện và động vật đáng chú ý, và tình trạng camera.
• door_report - ai đến camera cửa, với thời gian, những gì mỗi khách truy cập đã làm và một liên kết đến mỗi clip.
• wildlife_report - những con vật và chim nào mà camera ghi lại, được xác định gần gũi nhất có thể với cách cho phép của cảnh quay.
• camera_health - mỗi máy chủ và camera được kiểm tra ngoại tuyến, đã tắt, lỗi và các camera đã im lặng.
• day_in_review - một camera qua cả ngày dưới dạng dòng thời gian các khung hình, với một câu chuyện về cách cảnh quay thay đổi.

• Trợ lý không thể kết nối với điểm cuối cục bộ: kiểm tra URL trong trình duyệt - http://localhost:8090/mcp phải trả lời (thông báo lỗi là được; "connection refused" thì không). Đảm bảo cổng khớp với "Cài đặt máy chủ" - "Máy chủ cục bộ" và rằng điểm cuối được bật ở đó.
• 401 Unauthorized: Bảo vệ API được bật, vì vậy trợ lý phải gửi thông tin đăng nhập của người dùng quản trị viên, hoặc bạn đang kết nối từ bên ngoài mạng của mình.
• 403 Forbidden: kết nối từ bên ngoài mạng của bạn mà không có giấy phép. Hãy sử dụng Điểm cuối đám mây thay thế.
• 404 Not Found: điểm cuối được tắt trong "Cài đặt máy chủ" hoặc máy chủ cũ hơn 8.0.3.
• Điểm cuối đám mây cho biết máy chủ ngoại tuyến: máy chủ không được kết nối với iSpyConnect. Kiểm tra biểu tượng ổ khóa trong giao diện cục bộ và rằng "Chặn truy cập bên ngoài" được tắt.
• Xem trợ lý đang làm gì: đặt Ghi nhật ký thành Debug trong Cài đặt máy chủ và mở Nhật ký từ Menu máy chủ. Trên điểm cuối cục bộ, mọi yêu cầu và lệnh gọi dụng cụ được ghi lại với tiền tố "MCP", bao gồm Đối số và thời gian thực hiện. Thông qua điểm cuối đám mây, các dụng cụ chạy trên iSpyConnect.com và máy chủ chỉ nhìn thấy các Lệnh riêng lẻ mà chúng gửi, được ghi lại với tiền tố "RelayApi".