集成与 MCP
本页内容
CCTV / VSaaS 通过 **MCP（Model Context Protocol）**以程序化方式提供其数据，这与整个 Performance Hub 使用的集成接口相同。在平台上进行构建的首选方式是借助人工智能代理设备，它原生支持 MCP，掌握设施上下文，并且能够实时响应事件。
两种接入方式
| 方式 | 说明 | 适用情况 |
|---|---|---|
| 人工智能代理设备（首选） | 您设施的人工智能代理开箱即可通过 MCP 连接到 Performance Hub。您可以向它提问（“今天早上 6 点谁在设施里？”），构建响应事件的自动化，并让它将 CCTV 数据与其掌握的其他所有信息关联起来 | 几乎所有场景：无需编写代码、实时、对话式 |
| 直接 MCP | 任何支持 MCP 的客户端或代理，使用 Performance Hub MCP 密钥连接 | 自定义软件、外部代理平台、脚本化集成 |
之所以首选人工智能代理方式，是因为事件会在发生时流向它（例如检测到人员、设备离线），因此在其上构建的集成是响应式的，而不是轮询式的。连接人工智能代理的详细信息请参阅连接到 Performance Hub。
身份验证与范围
直接 MCP 访问使用从您的 Performance Hub 个人资料生成的个人 MCP 密钥（phk_… 令牌）进行身份验证。每次工具调用都遵循与界面相同的范围规则：
- 您只能查询您的账户可以访问的设施。
- 工具按模块控制：视觉和人员工具要求设施已启用 CCTV 和人员功能；设备工具需要设备管理。
- 调用遵循与平台其他部分相同的审计机制。
请像对待密码一样对待 MCP 密钥：尽可能将其限定于服务账户，并在人员变动时轮换密钥。
工具接口
完整且始终最新的 MCP 工具目录（名称、参数以及每个工具的返回内容）位于与 AI 配合使用下的 MCP 文档中，因此只需查阅这一个权威来源。对于本模块，相关的类别包括：
- CCTV 工具：摄像头和 Edge Processor，以及按含义搜索已录制的视频，与 CCTV 页面运行的搜索相同。
- AI Insights & People 工具：人员数据接口：搜索检测时间线、查找人员及其到访活动、签到历史以及设施报告快照。
- 设备管理工具：列出 Edge Processor 和摄像头及其状态，并向设备发送远程命令。
同一 MCP 接口还承载 Performance Hub 的其余部分（门和闸机控制、用户资料和设施查询等），因此一个集成可以跨越多个模块：*“在非营业时间检测到未知人员时，检查门禁日志并通知经理”*只是一个人工智能代理自动化，而不是三个系统。
行之有效的模式
- 非营业时间监控：在营业时间以外的检测事件上运行人工智能代理自动化，向员工发送包含摄像头和时间戳的通知。
- 每日摘要：一个定时自动化，汇总昨天的情况：到访、最繁忙的时段、摄像头运行状况、上传积压。
- 大规模设备群监控：多设施运营商从其 NOC 工具中跨设施轮询设备列表工具，或让人工智能代理进行监视并上报。
- 调查助手：通过检测时间线搜索工具，以对话方式回答“显示下午 5 点到 6 点之间进入的所有人”，而无需手动拖动浏览。
集成无法执行的操作
MCP 接口提供的是数据和控制平面访问。视频本身（实时视频流和录像回放）通过本模块和访客共享链接提供给浏览器，而不是通过 MCP。如需将视频交给外部方，请生成共享链接。
相关页面
- 人工智能代理：代理功能和自动化
- 安全与隐私：集成所沿用的审计机制
- 访问控制与权限