用途:读取并切换 Salesforce ITSM 组织上的 Incident Management 主开关(组织级总开关)。启用主开关会在服务端一并启用其子功能,因此完整启用只需对主开关做一次操作。
主要能力:读取主开关当前状态;启用或禁用主开关。写入幂等——当前状态与请求状态一致时跳过写入;始终先读后写;任何变更前需显式确认。
不在范围内:Incident 默认字段校验、Incident 优先级矩阵、子事件自动关闭、Email-to-Incident 子开关、Problem/Change/Case Management、ITSM External Client App 设置、其他 ITSM 偏好项,以及 Incident/Problem/ChangeRequest 记录的创建或配置。
使用方式:所有操作通过托管的 headless-360 MCP 服务器执行,工具命名空间为 mcp__headless-360__<tool-name>。流程为:预检(describe/discover)→ 加载 schema(describe)→ 读取当前状态(dispatch_readonly)→ 决定操作并确认写入(AskUserQuestion,需显式“yes”)→ 应用变更(dispatch)→ 验证(dispatch_readonly)→ 报告前后状态。读取用 dispatch_readonly,写入用 dispatch;服务器拒绝通过 dispatch_readonly 执行变更。dispatch 与 dispatch_readonly 接收 {"url": ..., "method": ..., "body"?: ..., "query_params"?: ...}。若用户只说“toggle”而未指明方向,需先询问方向,不得从当前状态推断。
前置条件:组织上激活 MCP 服务器(Setup → MCP Servers → headless-360 → Activate,激活最长约 2 分钟);配置 External Client App(OAuth 范围 mcp_api 与 refresh_token,启用 JWT 访问令牌,要求 PKCE,传播最长约 30 分钟);API v67.0+;MCP 客户端注册 additionalServers.headless-360 指向正确环境 URL。前置条件不满足时首次调用会返回 401/403/404,应原样上报原始错误并停止,不得编造状态。
限制:仅控制主开关;禁用主开关后子功能保留最后一次设置值;不得在 dispatch 参数中放入 orgId 或 Core URL,服务器从 JWT 签发者推导目标组织。具体 URL、请求/响应结构与示例见 references/mcp-invocation.md,运行时以 describe 返回为准。