Logo Performance HubPerformance Hub
Bagian situs: Dokumentasi

Integrasi & MCP

Di halaman ini

CCTV / VSaaS menyediakan datanya secara terprogram melalui MCP (Model Context Protocol) — antarmuka integrasi yang sama yang digunakan di seluruh Performance Hub. Cara yang disarankan untuk membangun di atas platform adalah melalui perangkat Agen AI, yang menggunakan MCP secara native, memegang konteks fasilitas, dan dapat bereaksi terhadap peristiwa secara real-time.

Dua jalur masuk

JalurPenjelasanKapan
Perangkat Agen AI (disarankan)Agen AI fasilitas Anda terhubung ke Performance Hub melalui MCP secara langsung tanpa konfigurasi tambahan. Ajukan pertanyaan ("siapa yang ada di fasilitas pukul 6 pagi ini?"), buat otomatisasi yang bereaksi terhadap peristiwa, dan biarkan agen menghubungkan data CCTV dengan semua hal lain yang diketahuinyaHampir semua hal — tanpa kode, real-time, dan berbasis percakapan
MCP langsungKlien atau agen apa pun yang mendukung MCP dan terhubung dengan kunci MCP Performance HubPerangkat lunak kustom, platform agen eksternal, integrasi berbasis skrip

Jalur Agen AI lebih disarankan karena peristiwa mengalir ke agen saat terjadi — deteksi orang, perangkat yang menjadi offline — sehingga integrasi yang dibangun di sana bersifat reaktif, bukan berbasis polling. Detail tentang cara menghubungkan Agen AI ada di Menghubungkan ke Performance Hub.

Autentikasi dan cakupan

Akses MCP langsung diautentikasi dengan kunci MCP pribadi (token phk_…) yang dibuat dari profil Performance Hub Anda. Setiap panggilan alat dibatasi oleh aturan yang sama dengan UI:

  • Anda hanya dapat mengkueri fasilitas yang dapat diakses akun Anda.
  • Alat dibatasi per modul: alat vision dan orang mengharuskan fasilitas mengaktifkan CCTV dan fitur orang; alat perangkat memerlukan Manajemen Perangkat.
  • Panggilan tunduk pada standar audit yang sama dengan bagian platform lainnya.

Perlakukan kunci MCP seperti kata sandi — batasi pada akun layanan jika memungkinkan dan rotasikan saat terjadi pergantian staf.

Antarmuka alat

Katalog lengkap alat MCP yang selalu terkini — nama, parameter, dan apa yang dikembalikan masing-masing — ada di dokumentasi MCP di bagian Menggunakan dengan AI, sehingga hanya ada satu sumber acuan untuk dirujuk. Untuk modul ini, kategori yang relevan adalah:

  • Alat CCTV — kamera dan Edge Processor, serta pencarian rekaman berdasarkan makna, pencarian yang sama dengan yang dijalankan halaman CCTV.
  • Alat AI Insights & People — antarmuka data orang: mencari di linimasa deteksi, mencari orang dan aktivitas kunjungannya, riwayat check-in, dan snapshot laporan fasilitas.
  • Alat Manajemen Perangkat — mencantumkan Edge Processor dan kamera beserta statusnya, dan mengirim perintah jarak jauh ke perangkat.

Antarmuka MCP yang sama juga mencakup bagian Performance Hub lainnya — kontrol pintu dan gerbang, pencarian profil pengguna dan fasilitas, dan lainnya — sehingga satu integrasi dapat mencakup beberapa modul: "saat orang yang tidak dikenal terdeteksi di luar jam operasional, periksa log pintu dan beri tahu manajer" adalah satu otomatisasi Agen AI, bukan tiga sistem.

Pola yang berfungsi dengan baik

  • Pemantauan di luar jam operasional — otomatisasi Agen AI pada peristiwa deteksi di luar jam buka, yang memberi tahu staf beserta kamera dan stempel waktunya.
  • Ringkasan harian — otomatisasi terjadwal yang merangkum hari kemarin: kunjungan, jam tersibuk, kesehatan kamera, tumpukan unggahan.
  • Pemantauan armada perangkat dalam skala besar — operator multi-fasilitas melakukan polling pada alat daftar perangkat di seluruh fasilitas dari perangkat NOC mereka, atau membiarkan Agen AI memantau dan melakukan eskalasi.
  • Asisten investigasi — "tampilkan semua orang yang masuk antara pukul 5 dan 6 sore" dijawab secara percakapan melalui alat pencarian linimasa deteksi, alih-alih menelusuri secara manual.

Yang tidak dapat dilakukan integrasi

Antarmuka MCP adalah akses data dan control plane. Video itu sendiri — aliran langsung dan pemutaran rekaman — disajikan ke browser melalui modul dan tautan berbagi tamu, bukan melalui MCP. Untuk menyerahkan rekaman kepada pihak eksternal, buat tautan berbagi.