对话里查高危、Finding 与门禁：AngusSecurity MCP 怎么接入

连上 AngusSecurity MCP 之后，在 IDE 对话里就能直接问扫描结论：这次有没有高危、某条 Finding 怎么改、门禁会不会挡住、报告出了没有——查高危与告警、解释 Finding、比两次检查、读/下载报告快照；权限与写开关齐全时，还能扫当前仓库、镜像或制品。返回的是脱敏结论，不是再塞一整份原始扫描结果。

主要实用场景：

• 发版前问一句：这次检查有没有 Critical / 高危？
• 点名一条 Finding：规则是什么、该怎么改？
• 两次扫描比一比：多了什么、少了什么、还在不在？
• 按现有策略模拟：门禁会不会挡住这次结果？
• 读已有报告或下载正文；权限够时为已结束的检查出一份报告
• 权限允许时，扫一下当前仓库（或镜像 / 制品）

结论： Security MCP 最多 16 个工具——多数查 Finding、告警、CVE、许可证、门禁与报告；权限与写开关齐全时可扫、可为已结束的检查出报告。不抑制误报、不揭密钥原文、不发布/分享。须用本产品门户签发的用户访问令牌。

控制台与宿主接线见文末参考「通过 MCP 连接 AngusSecurity」。制品坐标在哪个仓、客户端怎么配，见文末参考「AngusRepo MCP」——那边是恒只读八工具；这边答扫描结论、CVE、许可证、门禁与报告快照。统一引擎与报告怎么出，见文末：用一套扫描替换脚本、安全扫描报告怎么出。

1. Agent 常问的六类问题（以及明确不做）

1. 扫当前仓库 / 镜像 / 制品 / 点名文件。
2. 按代码安全、依赖、密钥、许可分组看这次结果。
3. 列出或解释 Finding（密钥片段看不到原文）。
4. 查本机漏洞库某条 CVE；汇总可见许可证。
5. 用已有策略做门禁模拟；对比两次已完成检查。
6. 读已有报告或下载正文；权限齐全时为已结束的检查生成报告。

明确不做： 抑制误报、揭开密钥原文、改告警状态、改策略、发布/分享/删报告、管理凭据与引擎、通用上传整棵未点名目录、导出引擎原始输出。

2. 形态：进程内端点 + 回环

对话侧只看见具名工具；服务端在本进程内回环到已有管理 API，权限与审计不另起一套。

IDE / Agent
  --POST {网关}/security/mcp-->  Boot /mcp
  --回环 Bearer-->  /api/v1/**（白名单语义工具）

再做一个外部 Node 去包 REST，等于复制一份策略。回环没有通用 path 参数，通用上传网关、揭密与发布接口不会被模型拼出来。

限流：每账号每分钟最多 30 次合法调用；超出 rate_limited，稍后再试。

3. 十六个工具（名称以文档为准）

分析师 / 管理员在写开关打开且权限齐全时，tools/list 应恰好 16。只读更少，见 §4。

3.1 发起检查与看这次结果

3.2 日常检索

分页从 1 起，每页最多 20。

3.3 对比、漏洞库与门禁

3.4 报告

不在列表中： 抑制、揭密、发布、分享、删除报告、改策略、通用上传整棵目录、引擎原始输出导出。

报告是生成时刻的快照，不会随下一次扫描改写——与文末「安全扫描报告怎么出」一致。

4. 账号能看见哪些工具

缺权限的工具不会出现在列表；按名硬调 → permission_denied。MCP 不会扩大账号权限。先用同一账号在控制台做同样操作，再怪 MCP。

5. 鉴权边界（容易踩坑）

可见范围 = 该用户在 /api/v1 的范围，与控制台一致。个人令牌：头像 → 我的（/profile）。CI 用服务账号，勿把个人登录态写进仓库。

6. 宿主接入（最小可复制片段）

令牌放环境变量，勿写入仓库：

{
   
  "mcpServers": {
   
    "angus-security": {
   
      "url": "https://<gateway-host>/security/mcp",
      "headers": {
    "Authorization": "Bearer ${ANGUS_SECURITY_TOKEN}" }
    }
  }
}

对外用网关 {host}/security/mcp。私有化直连改为 https://<security-host>/mcp（默认端口 1811，经反代时不必把端口暴露公网）。地址可在控制台 系统 → MCP 接入 复制。

仅 stdio 的宿主用 @anguskit/mcp --product security 转发（读 ANGUS_TOKEN / ANGUS_BASE_URL，与 ANGUS_SECURITY_TOKEN 不是同一变量名）：

{
   
  "mcpServers": {
   
    "angus-security": {
   
      "command": "npx",
      "args": ["-y", "@anguskit/mcp", "--product", "security"],
      "env": {
   
        "ANGUS_BASE_URL": "https://<gateway-host>",
        "ANGUS_TOKEN": "${ANGUS_SECURITY_TOKEN}"
      }
    }
  }
}

ANGUS_BASE_URL 是网关根，不要带 /security/mcp。私有化无产品前缀时改用 --endpoint + https://<security-host>/mcp。默认 npm 源没有该包时，文档建议 https://repo.anguskit.com/npm/npm-public/。完整宿主表见文末 MCP 文档。

6.1 对话示例：用户问 → 工具 → 期望字段

例 A：扫完再问问题

例 B：解释一条已有 Finding

例 C：门禁与报告

连上后也可先 tools/list 对角色表对一下个数，再对控制台里已有 Finding 做一次 security_explain_finding 冒烟。

7. 与业界形态、与 Repo 的对照（极短）

对照说明取舍，不是采购排名。细节以各厂商当日文档为准。

8. 边界与翻车表

连上之后最常见的三种翻车：拿错产品令牌连不上、空 Finding 列表被说成「安全」、扫描或报告还没出完就追问正文——对照下表与 FAQ。

FAQ

MCP 会不会揭开密钥或把误报标掉？

不会。解释与告警保持掩码；抑制、揭密、审批仍在控制台。原因之一：抑制在部分范围会自动批准——模型若把「接受风险」说成修复，会写成一条生效抑制。

写开关关掉还能查 / 下载报告吗？

能查（Reports:VIEW）。下载要 Reports:EXECUTE，不靠写开关。写开关关掉的是 security_scan 与 security_create_report。

和 CLI / CI 什么关系？

CLI 与流水线仍是批量与门禁主路径；MCP 把同一套任务与 Finding 接到 IDE 对话。统一引擎见文末：用一套扫描替换脚本。

为什么不做通用只读网关？

具名工具限制回环白名单，避免把管理 API 整面暴露给模型，并便于投影脱敏。

其他产品令牌 / repod_ 为什么不能连？

MCP 使用本门户用户访问令牌，权限与控制台一致。把自动化或跨产品令牌当成对话身份会扩大面——鉴权前直接 401。

security_license_summary 为什么答不了「这次检查」？

它汇总的是账号当前可见许可证，不能绑 jobId。问某次检查的许可问题用 security_issues。

空列表能不能说成安全？

不能。还要区分：任务未完成、某能力 notScanned=true、筛选没命中。三者都不是「目标安全」。

小结

• 与 Repo MCP 错开：这边是扫描结论 / 门禁 / 报告；写面仅扫 + 创建报告，且受开关与角色约束。
• 接入：网关 /security/mcp + PAT；repod_ 与其他产品令牌不行；密钥掩码；空 ≠ 安全。
• 接入细节对照文档与控制台「系统 → MCP 接入」。

参考文章

• 通过 MCP 连接 AngusSecurity：https://www.anguskit.com/zh/docs/security/get-started/mcp
• 用一套扫描替换 Semgrep、Trivy 和 Gitleaks 脚本：https://www.anguskit.com/zh/blog/replace-semgrep-trivy-gitleaks-with-one-scan
• 安全扫描报告怎么出：https://www.anguskit.com/zh/blog/security-scan-report-snapshot-export
• 按能力出报告：https://www.anguskit.com/zh/blog/capability-security-reports-sast-sca-secret-license
• 内网漏洞库怎么更新：https://www.anguskit.com/zh/blog/intranet-vuln-db-offline-update-rollback
• 等保和审计要留哪些扫描记录：https://www.anguskit.com/zh/blog/compliance-audit-security-scan-evidence
• 用 AI 助手只读查制品库（AngusRepo MCP）：https://www.anguskit.com/zh/blog/angusrepo-mcp-server-design