Tích hợp và MCP

Trên trang này

CCTV / VSaaS cung cấp dữ liệu theo chương trình thông qua MCP (Model Context Protocol) — cùng giao diện tích hợp được dùng trên toàn Performance Hub. Cách được ưu tiên để xây dựng trên nền tảng là thông qua thiết bị AI Agent, thiết bị này hỗ trợ MCP nguyên bản, nắm giữ ngữ cảnh của cơ sở và có thể phản ứng với các sự kiện theo thời gian thực.

Hai phương thức truy cập

Phương thứcMô tảKhi nào
Thiết bị AI Agent (ưu tiên)AI Agent của cơ sở bạn kết nối với Performance Hub qua MCP ngay khi xuất xưởng. Đặt câu hỏi cho AI Agent ("ai đã có mặt tại cơ sở lúc 6 giờ sáng nay?"), xây dựng tự động hóa phản ứng với các sự kiện, và để AI Agent đối chiếu dữ liệu CCTV với mọi thông tin khác mà nó biếtHầu hết mọi trường hợp — không cần viết mã, theo thời gian thực và dạng hội thoại
MCP trực tiếpBất kỳ ứng dụng hoặc agent nào hỗ trợ MCP kết nối bằng khóa MCP của Performance HubPhần mềm tùy chỉnh, nền tảng agent bên ngoài, tích hợp bằng script

Phương thức AI Agent được ưu tiên vì các sự kiện được chuyển đến AI Agent ngay khi chúng xảy ra — một lần phát hiện người, một thiết bị chuyển sang ngoại tuyến — vì vậy các tích hợp được xây dựng ở đó mang tính phản ứng, không phải thăm dò định kỳ. Chi tiết về cách kết nối AI Agent có trong Kết nối với Performance Hub.

Xác thực và phạm vi

Truy cập MCP trực tiếp được xác thực bằng khóa MCP cá nhân (một token phk_…) được tạo từ hồ sơ Performance Hub của bạn. Mọi lệnh gọi công cụ đều được giới hạn theo cùng quy tắc như trên giao diện:

  • Bạn chỉ có thể truy vấn các cơ sở mà tài khoản của bạn có quyền truy cập.
  • Các công cụ phụ thuộc vào mô-đun: các công cụ thị giác và con người yêu cầu cơ sở đã bật CCTV và các tính năng về con người; các công cụ thiết bị yêu cầu Quản lý thiết bị.
  • Các lệnh gọi tuân theo cùng chế độ kiểm tra như phần còn lại của nền tảng.

Hãy bảo vệ khóa MCP như mật khẩu — giới hạn khóa cho tài khoản dịch vụ khi có thể và thay khóa khi có thay đổi về nhân sự.

Giao diện công cụ

Danh mục đầy đủ và luôn cập nhật của các công cụ MCP — tên, tham số và dữ liệu mỗi công cụ trả về — nằm trong tài liệu MCP tại mục Sử dụng với AI, để có một nguồn thông tin duy nhất cần tham khảo. Đối với mô-đun này, các nhóm liên quan là:

  • Công cụ CCTV — camera và Edge Processor, và tìm kiếm cảnh quay đã ghi theo ý nghĩa, giống với tìm kiếm mà trang CCTV thực hiện.
  • Công cụ AI Insights & People — giao diện dữ liệu về con người: tìm kiếm dòng thời gian phát hiện, tra cứu người và hoạt động ghé thăm của họ, lịch sử check-in và ảnh chụp nhanh báo cáo của cơ sở.
  • Công cụ Quản lý thiết bị — liệt kê các Edge Processor và camera cùng trạng thái của chúng, và gửi lệnh từ xa đến thiết bị.

Cùng giao diện MCP đó còn bao gồm phần còn lại của Performance Hub — điều khiển cửa và cổng, tra cứu hồ sơ người dùng và cơ sở, và nhiều hơn nữa — vì vậy một tích hợp có thể trải rộng trên nhiều mô-đun: "khi phát hiện một người lạ sau giờ làm việc, hãy kiểm tra nhật ký cửa và thông báo cho người quản lý" là một tự động hóa AI Agent duy nhất, không phải ba hệ thống.

Các mô hình hiệu quả

  • Giám sát ngoài giờ — một tự động hóa AI Agent dựa trên các sự kiện phát hiện ngoài giờ mở cửa, thông báo cho nhân viên kèm camera và dấu thời gian.
  • Bản tóm tắt hằng ngày — một tự động hóa theo lịch tóm tắt ngày hôm qua: lượt ghé thăm, giờ cao điểm, tình trạng camera, lượng dữ liệu tồn đọng chờ tải lên.
  • Giám sát toàn bộ thiết bị ở quy mô lớn — các đơn vị vận hành nhiều cơ sở thăm dò các công cụ liệt kê thiết bị trên các cơ sở từ công cụ NOC của họ, hoặc để một AI Agent theo dõi và báo cáo lên cấp trên.
  • Trợ lý điều tra — câu hỏi "cho tôi xem tất cả những người đã vào trong khoảng từ 5 đến 6 giờ chiều" được trả lời dưới dạng hội thoại thông qua các công cụ tìm kiếm dòng thời gian phát hiện, thay vì tua xem thủ công.

Những gì tích hợp không thể làm

Giao diện MCP cung cấp quyền truy cập dữ liệu và lớp điều khiển. Bản thân video — luồng trực tiếp và phát lại bản ghi — được cung cấp đến trình duyệt thông qua mô-đun và liên kết chia sẻ cho khách, không thông qua MCP. Để cung cấp cảnh quay cho bên ngoài, hãy tạo một liên kết chia sẻ.