통합 및 MCP

이 페이지의 내용

CCTV / VSaaS는 Performance Hub 전반에서 사용하는 것과 같은 통합 인터페이스인 **MCP(Model Context Protocol)**를 통해 데이터를 프로그래밍 방식으로 제공합니다. 플랫폼을 기반으로 구축하는 권장 방법은 AI 에이전트 어플라이언스를 사용하는 것입니다. AI 에이전트 어플라이언스는 MCP를 기본적으로 지원하고, 시설 컨텍스트를 보유하며, 이벤트에 실시간으로 대응할 수 있습니다.

두 가지 접근 방법

경로	설명	사용 시기
AI 에이전트 어플라이언스(권장)	시설의 AI 에이전트는 별도 설정 없이 MCP를 통해 Performance Hub에 연결됩니다. 질문을 하고("오늘 아침 6시에 시설에 누가 있었습니까?"), 이벤트에 대응하는 자동화를 구축하고, CCTV 데이터를 에이전트가 알고 있는 다른 모든 정보와 연관 지을 수 있습니다	거의 모든 경우 — 코드 없이, 실시간으로, 대화형으로 사용
직접 MCP	Performance Hub MCP 키로 연결하는 MCP 지원 클라이언트 또는 에이전트	맞춤형 소프트웨어, 외부 에이전트 플랫폼, 스크립트 기반 통합

AI 에이전트 경로가 권장되는 이유는 사람 감지나 기기 오프라인 전환 같은 이벤트가 발생하는 즉시 에이전트에 전달되므로, 여기에서 구축한 통합이 폴링 방식이 아닌 반응형으로 작동하기 때문입니다. AI 에이전트 연결에 대한 자세한 내용은 Performance Hub에 연결을 참조하십시오.

인증 및 범위 지정

직접 MCP 접근은 Performance Hub 프로필에서 생성한 개인 MCP 키(phk_… 토큰)로 인증합니다. 모든 도구 호출에는 UI와 같은 규칙에 따라 범위가 지정됩니다.

계정이 접근할 수 있는 시설만 조회할 수 있습니다.
도구는 모듈에 따라 제한됩니다. 비전 및 사람 도구를 사용하려면 시설에서 CCTV와 사람 관련 기능이 활성화되어 있어야 하며, 기기 도구에는 Device Management가 필요합니다.
호출은 플랫폼의 나머지 부분과 같은 감사 기준을 따릅니다.

MCP 키는 비밀번호처럼 취급하십시오. 가능하면 서비스 계정으로 범위를 제한하고, 직원이 바뀌면 키를 교체하십시오.

도구 인터페이스

MCP 도구의 전체 최신 카탈로그(이름, 매개변수, 각 도구가 반환하는 내용)는 AI와 함께 사용의 MCP 문서에 있으므로, 참조할 수 있는 단일 정보 출처가 있습니다. 이 모듈과 관련된 범주는 다음과 같습니다.

CCTV 도구 — 카메라와 엣지 프로세서, 그리고 CCTV 페이지에서 실행하는 것과 같은 의미 기반 녹화 영상 검색.
AI Insights & People 도구 — 사람 데이터 인터페이스: 감지 타임라인 검색, 사람과 방문 활동 조회, 체크인 기록, 시설 보고서 스냅샷.
Device Management 도구 — 엣지 프로세서와 카메라의 상태와 함께 목록을 조회하고 기기에 원격 명령을 전송합니다.

같은 MCP 인터페이스로 출입문 및 게이트 제어, 사용자 프로필 및 시설 조회 등 Performance Hub의 나머지 기능도 사용할 수 있으므로, 통합이 여러 모듈에 걸쳐 작동할 수 있습니다. *"영업시간 이후 알 수 없는 사람이 감지되면 출입문 로그를 확인하고 관리자에게 알린다"*는 세 개의 시스템이 아니라 하나의 AI 에이전트 자동화입니다.

효과적인 패턴

영업시간 외 모니터링 — 운영 시간 외의 감지 이벤트에 대한 AI 에이전트 자동화로, 카메라와 타임스탬프를 포함하여 직원에게 알립니다.
일일 요약 — 전날의 방문, 가장 바쁜 시간대, 카메라 상태, 업로드 백로그를 요약하는 예약된 자동화입니다.
대규모 전체 기기 모니터링 — 다중 시설 운영자가 NOC 도구에서 여러 시설에 걸쳐 기기 목록 도구를 폴링하거나, AI 에이전트가 모니터링하고 에스컬레이션하도록 합니다.
조사 도우미 — "오후 5시에서 6시 사이에 들어온 모든 사람을 보여 줘"와 같은 질문에 수동으로 영상을 훑어보는 대신 감지 타임라인 검색 도구를 통해 대화형으로 답합니다.

통합으로 할 수 없는 작업

MCP 인터페이스는 데이터 및 제어 영역 접근입니다. 실시간 스트림과 녹화 재생 같은 영상 자체는 MCP가 아니라 모듈과 게스트 공유 링크를 통해 브라우저에 제공됩니다. 외부 당사자에게 영상을 전달하려면 공유 링크를 생성하십시오.