用途:在 HaloPSA / HaloITSM(同一产品与 REST API,工单在 API 中称 Fault)中只读地收集解决一个工单所需的全部上下文,包括工单详情、完整动作/备注历史、涉及资产以及相关知识库运行手册。
主要能力:提供 halo_get_ticket(读取单个工单的摘要、详情、状态、优先级、客户/站点/用户及关联资产)、halo_get_ticket_actions(工单动作/备注时间线)、halo_list_tickets(按类型、客户、资产、状态或自由文本查找工单)、halo_get_asset(读取工单上的关联资产)、halo_list_kb_articles(搜索知识库)与 halo_get_kb_article(读取文章正文)。
使用方式:通过 MCP 服务器 halo-mcp 提供,命令为 python3 -u mcp-servers/halo-mcp/halo_mcp_server.py(stdio 传输),使用 OAuth2 客户端凭据认证,需配置 HALO_CLIENT_ID / HALO_CLIENT_SECRET 与 HALO_BASE_URL,Python 3.10+,依赖 fastmcp、httpx、python-dotenv。典型流程:先用 halo_list_tickets 找到工单数字 id,再 halo_get_ticket 读取详情,halo_get_ticket_actions 重建时间线,halo_get_asset 检查关联资产,halo_list_kb_articles 与 halo_get_kb_article 查找运行手册,最后输出解决上下文摘要。
适用场景:需要理解并解决某个 Halo 工单时,快速汇总已诊断内容、已尝试操作、受影响设备与可用运行手册。
限制:整个技能为只读,不修改 Halo;工单仅以数字 id 寻址,不可按名称解析;如需变更须交由 halo-change-request(预览→确认→提交)。所有查询须记录到 GAIT 审计轨迹。工具调用失败时应直接报告错误,不猜测结果;超时不能证明操作失败,需先检查状态再重试。