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

连上 AngusSecurity MCP 之后在 IDE 对话里就能直接问扫描结论这次有没有高危、某条 Finding 怎么改、门禁会不会挡住、报告出了没有——查高危与告警、解释 Finding、比两次检查、读/下载报告快照权限与写开关齐全时还能扫当前仓库、镜像或制品。返回的是脱敏结论不是再塞一整份原始扫描结果。主要实用场景发版前问一句这次检查有没有 Critical / 高危点名一条 Finding规则是什么、该怎么改两次扫描比一比多了什么、少了什么、还在不在按现有策略模拟门禁会不会挡住这次结果读已有报告或下载正文权限够时为已结束的检查出一份报告权限允许时扫一下当前仓库或镜像 / 制品结论Security MCP 最多16个工具——多数查 Finding、告警、CVE、许可证、门禁与报告权限与写开关齐全时可扫、可为已结束的检查出报告。不抑制误报、不揭密钥原文、不发布/分享。须用本产品门户签发的用户访问令牌。控制台与宿主接线见文末参考「通过 MCP 连接 AngusSecurity」。制品坐标在哪个仓、客户端怎么配见文末参考「AngusRepo MCP」——那边是恒只读八工具这边答扫描结论、CVE、许可证、门禁与报告快照。统一引擎与报告怎么出见文末用一套扫描替换脚本、安全扫描报告怎么出。1. Agent 常问的六类问题以及明确不做扫当前仓库 / 镜像 / 制品 / 点名文件。按代码安全、依赖、密钥、许可分组看这次结果。列出或解释 Finding密钥片段看不到原文。查本机漏洞库某条 CVE汇总可见许可证。用已有策略做门禁模拟对比两次已完成检查。读已有报告或下载正文权限齐全时为已结束的检查生成报告。明确不做抑制误报、揭开密钥原文、改告警状态、改策略、发布/分享/删报告、管理凭据与引擎、通用上传整棵未点名目录、导出引擎原始输出。对比AngusRepo MCPAngusSecurity MCP工具面8 个只读工具不能扫、不能出报告最多 16 个权限齐全时可扫 出报告回答什么坐标在哪个仓、依赖/隔离快照、客户端模板Finding、CVE、许可证、门禁模拟、报告快照不做不代理协议拉包、不触发扫描不定位制品仓、不揭密、不抑制2. 形态进程内端点 回环对话侧只看见具名工具服务端在本进程内回环到已有管理 API权限与审计不另起一套。IDE / Agent --POST {网关}/security/mcp-- Boot /mcp --回环 Bearer-- /api/v1/**白名单语义工具再做一个外部 Node 去包 REST等于复制一份策略。回环没有通用 path 参数通用上传网关、揭密与发布接口不会被模型拼出来。项口径传输无状态POST默认/mcp经网关{host}/security/mcp回环本机 Security 端口默认1811Bearer 原样转发X-Angus-Client-Source: mcp注册面只注册tools无 resources / prompts / samplingGM不新增 GM 资源显隐跟现有PPS走id任务 id、Finding id 均为十进制字符串勿截断或当浮点配置作用angus.mcp.enabledANGUS_MCP_ENABLED未设为truefalse→ 无端点控制台 / CLI / 已有检查不受影响angus.mcp.write-enabled当前发行未设时为truefalse→ 列表无security_scan、security_create_report查询与下载不靠它限流每账号每分钟最多30次合法调用超出rate_limited稍后再试。3. 十六个工具名称以文档为准分析师 / 管理员在写开关打开且权限齐全时tools/list应恰好16。只读更少见 §4。3.1 发起检查与看这次结果工具权限要点做什么 / 易踩坑security_scanScanJobs:EXECUTE 写开关kindgit/image/artifact/files一次一种目标立刻回任务 idjobId——先等扫描结束再问问题/出报告。git只收 httpsgitRef用用户说的或当前分支不猜main。私有目标只填控制台已存凭据名称不传令牌。点名能力放capabilities没点名由服务端展开security_issuesFindings:VIEWScanJobs:VIEW按能力分组某项notScannedtrue 该项没跑空列表 ≠ 安全密钥片段为掩码3.2 日常检索工具权限要点做什么 / 易踩坑security_list_findingsFindings:VIEW至少一项过滤jobId/assetKey/keyword/ruleId等列表无代码片段空 ≠ 安全security_explain_findingFindings:VIEW规则说明另需RulePacks:VIEW规则含义、修复建议、掩码片段不可揭密一次最多约 5 个 idsecurity_list_jobsScanJobs:VIEW查仓库/镜像/制品用assetKeyword勿把地址塞进keyword未COMPLETED/PARTIAL时不能把计数说成干净security_list_alertsAlerts:VIEW只读告警不改状态、不指派分页从 1 起每页最多 20。3.3 对比、漏洞库与门禁工具权限要点做什么 / 易踩坑security_compare_jobsScanJobs:VIEW两次已完成检查的指纹差新增/消失/仍在不建任务security_lookup_vulnerabilityRulePacks:VIEW查本机漏洞库无记录说「库内无此条」勿改写「没有漏洞」security_license_summaryFindings:VIEW账号可见许可证汇总不能指定某次检查——问某次用security_issuessecurity_risk_summaryDashboard:VIEW风险分数与态势摘要不回概览大列表security_simulate_gatePolicies:VIEW只读模拟可选lookbackJobs最大 100只读/研发角色通常看不到3.4 报告工具权限要点做什么 / 易踩坑security_report_summaryReports:VIEW查已有报告无 READY 时说尚未生成不含验真地址与分享口令security_get_reportReports:VIEW按 id 看范围、状态、指标不含验真/分享口令/规格原文security_compare_reportsReports:VIEW两份报告摘要与问题指纹差security_download_reportReports:EXECUTE仅报告已就绪READYformatJSON/HTML/CSV/PDF/SARIF文本约 64 KB 后截断并标truncatedPDF/压缩包只回文件名、字节数与控制台路径security_create_reportReports:EXECUTE 写开关仅已结束任务参数主要是jobId 可选 name/format创建后先是生成中PENDING——先等就绪再下载用security_get_report轮询至READY或失败不发布、不分享、不设打开密码不在列表中抑制、揭密、发布、分享、删除报告、改策略、通用上传整棵目录、引擎原始输出导出。报告是生成时刻的快照不会随下一次扫描改写——与文末「安全扫描报告怎么出」一致。4. 账号能看见哪些工具角色写开关打开写开关关闭只读SEC_VIEWER12有security_issues无扫、无门禁模拟、无报告下载/创建同左12研发SEC_DEVELOPER13只读 security_scan12分析师 / 管理员SEC_ANALYST/SEC_ADMIN1614无扫、无创建报告缺权限的工具不会出现在列表按名硬调 →permission_denied。MCP不会扩大账号权限。先用同一账号在控制台做同样操作再怪 MCP。5. 鉴权边界容易踩坑凭证结果门户签发的用户访问令牌PAT可进工具集随角色与写开关收窄repod_或 AngusRepo 等其他产品令牌401无工具列表OAuth 刷新令牌401无 Bearer401避免收成工具内错误导致模型盲重试可见范围 该用户在/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 接入复制。宿主配置文件以各宿主文档为准Cursor项目.cursor/mcp.json或用户级~/.cursor/mcp.jsonClaudeclaude_desktop_config.jsonVS Code工作区.vscode/mcp.jsonCodex / Qoder见对应宿主 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。私有化无产品前缀时改用--endpointhttps://security-host/mcp。默认 npm 源没有该包时文档建议https://repo.anguskit.com/npm/npm-public/。完整宿主表见文末 MCP 文档。6.1 对话示例用户问 → 工具 → 期望字段例 A扫完再问问题步骤内容用户问扫一下这个仓库的代码安全和秘钥。应调用security_scankindgithttpsgitUrlgitRef用户/当前分支可选capabilities→ 稍后security_issues/security_list_jobs期望字段立刻拿到任务 idjobId十进制字符串扫描结束后再看分组结果密钥片段为掩码不应出现猜main、在对话里填 PAT、把 SSHgit原样提交而不改 https例 B解释一条已有 Finding步骤内容用户问解释这条 Finding并说明怎么改。应调用先security_list_findings带过滤拿完整id再security_explain_finding期望字段规则含义、remediation/ 固定版本、路径行号、掩码snippet不应出现密钥原文、抑制/审批、把模型自己的改法说成扫描器结论例 C门禁与报告步骤内容用户问按这个策略会不会挡住给这次已结束检查出一份 HTML 报告。应调用security_simulate_gate需Policies:VIEW→ 写开关开且有Reports:EXECUTE时security_create_report→ 轮询security_get_report期望字段模拟不新建扫描创建后先是生成中就绪后再security_download_report文本可带truncated不应出现只读/研发硬调门禁或创建报告把「生成中」当成已出报告发布/分享连上后也可先tools/list对角色表对一下个数再对控制台里已有 Finding 做一次security_explain_finding冒烟。7. 与业界形态、与 Repo 的对照极短形态代表与 AngusSecurity一句话本机 stdio 扫工作区Snyk CLI MCP服务端拉仓库/镜像/制品点名文件走有上限上传平台检索 可改状态SonarQube MCP采纳检索与门禁模拟不改 Finding 状态、不挂载工作区制品情报 MCPSonatype Guide / JFrog Xray坐标归属走 Repo MCP这里答扫描结论与门禁进程内语义工具AngusSecurity回环本进程 REST抑制/揭密/发布不进工具面对照说明取舍不是采购排名。细节以各厂商当日文档为准。8. 边界与翻车表连上之后最常见的三种翻车拿错产品令牌连不上、空 Finding 列表被说成「安全」、扫描或报告还没出完就追问正文——对照下表与 FAQ。现象原因处理连不上enabledfalse/ URL 错 / 控制台域名/mcp被反代拦开开关核对网关/security/mcp宿主须POST401其他产品令牌或repod_/ 无 Bearer / 令牌过期「我的」里重签 PAT刷新宿主 MCP工具很少 / 比同事少角色缺权限或写开关关对照 §4只读无扫研发无门禁模拟与报告下载/创建permission_denied列表外硬调或控制台也无权限先控制台验证同一账号MCP 不扩权助手说扫不了当前仓无ScanJobs:EXECUTE、写开关关、缺gitRef、私有仓未给凭据名开写开关给 https 分支说出控制台凭据名称想抑制误报无对应工具回控制台处置避免模型把「接受风险」写成自动抑制密钥看不清原文设计如此揭密只在控制台刚创建报告仍是生成中PENDING报告异步出轮询security_get_report至就绪READY/失败——不要刚创建就读正文PDF「下载了」却无正文二进制不进对话看文件名 consolePath去控制台取rate_limited超过 30 次/分钟稍后再试合并提问空 Finding 列表未扫、未完成、或筛选未命中说明未扫/未完成不改写成安全-32020自加Mcp-Method/Mcp-Name与正文不一致去掉自加头或保证与当次 JSON 一致FAQMCP 会不会揭开密钥或把误报标掉不会。解释与告警保持掩码抑制、揭密、审批仍在控制台。原因之一抑制在部分范围会自动批准——模型若把「接受风险」说成修复会写成一条生效抑制。写开关关掉还能查 / 下载报告吗能查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。空列表能不能说成安全不能。还要区分任务未完成、某能力notScannedtrue、筛选没命中。三者都不是「目标安全」。小结与 Repo MCP 错开这边是扫描结论 / 门禁 / 报告写面仅扫 创建报告且受开关与角色约束。接入网关/security/mcp PATrepod_与其他产品令牌不行密钥掩码空 ≠ 安全。接入细节对照文档与控制台「系统 → MCP 接入」。参考文章通过 MCP 连接 AngusSecurityhttps://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 MCPhttps://www.anguskit.com/zh/blog/angusrepo-mcp-server-design