用途：在 HaloPSA / HaloITSM（同一产品与 REST API，资产在 API 中称为 Device）中，围绕一台设备建立完整运维视图：查看资产详情、关联工单以及 CMDB/CI 依赖关系，全程只读，不做任何修改。
主要能力（工具）：halo_list_assets（按 customer、assettype_id、search 列出/搜索资产）；halo_get_asset（按名称、库存编号或 id 读取单个资产详情、字段与工单数量）；halo_get_asset_tickets（列出资产关联工单，可用 open_only 只看未关闭项，是核心上下文工具）；halo_get_asset_relationships（读取资产的 CMDB/CI 层级与关系）；halo_list_clients（将 Halo Client 名称解析为 id）；halo_list_sites（在客户内缩小到站点）。
使用方式：通过 MCP 服务器 halo-mcp（mcp-servers/halo-mcp/）运行，命令为 python3 -u mcp-servers/halo-mcp/halo_mcp_server.py（stdio 传输）。认证使用 OAuth2 client-credentials，依赖 HALO_CLIENT_ID / HALO_CLIENT_SECRET 与 HALO_BASE_URL。需要 Python 3.10+，依赖 fastmcp、httpx、python-dotenv。典型流程：先用 halo_list_assets(customer="<client>", search="<name/serial/model>") 定位资产，再调用 halo_get_asset 查看详情，之后用 halo_get_asset_tickets 拉取历史与未关闭工单，最后用 halo_get_asset_relationships 梳理上下游依赖并给出资产上下文总结与建议。
适用场景：调查某台 Halo 资产、核对设备历史与依赖、在多客户 MSP 租户中按客户边界审查设备，并与其他技能配合做审计记录、变更交接或与网络事实源比对。
限制：本技能全部只读，不修改 Halo；整个 halo-mcp 服务器中唯一的写入是 halo_create_change_request（属于 halo-change-request 技能）。需要变更时应交接给该技能（预览 -> 确认 -> 提交），不要从本技能写入。在多客户租户中应通过 customer 参数限定客户边界。资产可按名称、库存编号或 id 解析，无需先查数字 id。若工具调用出现认证或连接错误，应先检查 HALO_BASE_URL、HALO_CLIENT_ID、HALO_CLIENT_SECRET 是否设置且有效；出现超时、主机不可达或响应格式错误时，应如实报告错误信息，不得编造结果。