update_endpoint_auth — 更新端点授权配置

`update_endpoint_auth` — 更新端点授权配置

修改声明的授权器或门，避免意外清除省略字段。

适用于稳定版 Viat 1.1.0。先阅读 MCP 配置与结果处理。以下为合成的、从源码推导的预期形状，不是已执行的响应。编写本页没有访问服务、提供方或设备。

前提与权限

需要编辑权限：项目 Owner、Admin 或 Developer；Viewer 被拒绝。PAT 所有者须具有该项目角色，且 PAT 范围允许访问该路由。

使用已激活的隔离实例，配置服务器和 bearer；除 list_projects 外须有 mcp-lab 项目。示例中的现有资产和 ID 以概览夹具为前提，用夹具实际返回 ID 替换合成 ID；示例不会自行创建依赖。

完整输入字段

必填表示导出输入合约的结构要求，不等于完整条件 API 验证。可选字段的显式 JSON null 与省略同样反序列化，包括未限定类型的 JSON 字段。空字符串、数组或对象是实际值，不是省略。数值 format 表示序列化边界，运行时限制和默认值另算。args 的模式 default:null 不等于其运行时默认 {}。

字段	类型	必填	省略 / 显式 null	约束和含义
`allowed_authorizers`	array<string> / null	否（可能条件必填）	保留现值；null 等同省略。	本节点声明的授权器名称，[] 是显式值。
`authz_gates`	array<JSON> / null	否（可能条件必填）	保留现值；null 等同省略。	{type,action} 门对象数组，[] 不等于继承。
`id`	string	是	无默认值，缺失或 null 无效。	端点节点 UUID，不是树或脚本 ID。
`inherit_authz_gates`	boolean / null	否（可能条件必填）	false；null 等同省略。	true 向 API 发送 null 表示继承，默认 false，与门声明互斥。
`override_authorizers`	boolean / null	否（可能条件必填）	保留现值；null 等同省略。	已存储授权器覆盖开关，更新省略时保留现值。
`project`	string / null	否（可能条件必填）	VIAT_PROJECT / current_project；否则 project_required；null 等同省略。	项目 slug；省略或 null 使用 VIAT_PROJECT/current_project，否则 project_required。

行为与验证

先 GET 节点，再回传省略的 allowed_authorizers 与 override_authorizers，并保留未暴露的 override_permissions。使用 authz_gates:[{type,action}] 声明门，inherit_authz_gates:true 向 API 发送 null 以继承，两者都不传则保留。MCP 显式 null 等同省略，因此 authz_gates:null 不会清除门。门与 inherit_authz_gates:true 不能同时传。空数组仅声明本层无门，祖先门仍可能生效。每个门都需要模型验证过的字符串 type 和 action。

输出与分页

端点对象包含字符串 id、path、segment、tree_id、kind；可选字符串 method、parent_id、script_name、workflow_name、proxy_resource_name；可选对象 ws_routes（路由 → 脚本字符串）及 authz_gates 数组（{type, action}）。可选字段省略而非返回 null。此投影不包含授权器列表、overrides 或完整 CRUD 配置，不能用作完整备份。

无分页或续页游标。

值会序列化成 JSON，放进一个 MCP content 文本块。请把 result.content[0].text 解析为 JSON。不承诺 structuredContent 或 outputSchema；注明省略的可选字段不能假定以 null 存在。

合成请求与预期形状

完成 MCP initialize/initialized 后，通过 stdio 以单行 JSON 发送此 tools/call 请求（此处格式化仅为便于阅读）。

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "update_endpoint_auth",
    "arguments": {
      "project": "mcp-lab",
      "id": "00000000-0000-4000-8000-000000000001",
      "authz_gates": [],
      "inherit_authz_gates": false
    }
  }
}

预期 MCP 外层形状（ID、时间戳、头和计算值均为示意，不是确定值断言）。

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"id\":\"00000000-0000-4000-8000-000000000001\",\"method\":\"GET\",\"path\":\"/mcp-demo\",\"segment\":\"mcp-demo\",\"tree_id\":\"00000000-0000-4000-8000-000000000001\",\"script_name\":\"mcp_demo\",\"kind\":\"script\",\"authz_gates\":[]}"
      }
    ],
    "isError": false
  }
}

文本块内解码后的 JSON 值：

{
  "id": "00000000-0000-4000-8000-000000000001",
  "method": "GET",
  "path": "/mcp-demo",
  "segment": "mcp-demo",
  "tree_id": "00000000-0000-4000-8000-000000000001",
  "script_name": "mcp_demo",
  "kind": "script",
  "authz_gates": []
}

失败与恢复

互斥门参数返回 bad_input；节点不存在或系统节点受保护时返回 API 404/403。该读改写不是 compare-and-swap，应避免并发编辑同一节点。

所有上游工具都可能因令牌过期或撤销、PAT 范围、项目权限、激活、网络或超时失败。无项目及默认值时为 project_required；控制面非 2xx 为 http_4xx/http_5xx。详见公共错误外层及重试规则。输入反序列化或未知工具可能在进入工具层前成为 JSON-RPC 协议错误，不要假定每个失败都有 isError。retryable 标志不保证幂等。

副作用、验证与清理

修改草稿安全配置；已发布授权要到发布才改变。先保存原声明，结束后用本工具恢复，上线前审阅发布计划。返回投影不足以备份全部授权器设置。

验证应以观察为主：检查本文结果字段，获准修改前后使用对应读取工具。不要通过生产请求或删除无关对象来验证。

维护依据

输入清单：contracts/1.1.0/mcp-tools.json，工具 update_endpoint_auth. 固定产品源码中的实现和测试： endpoints.rs; handlers/endpoints.rs; tests/it/tool_update_endpoint.rs. 工具模块文件名相对 crates/viat-mcp/src/tools/，API handler 相对 crates/viat-api/src/handlers/。公共传输和错误依据为 crates/viat-mcp/src/tools/service.rs、http.rs、error.rs；本次仅阅读测试，没有运行测试。