连接器指南阅读约 2 分钟8 个 MCP 工具7 种语言

连接 ThreatAware MCP 与 Gemini CLI

来自任何 AI 代理的 ThreatAware 网络资产管理:跨安全和 IT 工具合并的设备和用户清单、开放警报、每个安全控制的健康状况(Vitals,今天或过去的某一天)、一个连接工具的原始记录,以及门户用户、角色和团队。只读。Cloud ID 和 API 密钥。

HC作者:HelpCode 团队更新于 2 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

ThreatAware

ThreatAware

ThreatAware cyber asset management from any AI agent: the merged device and user inventory across your security and IT tools, open alerts, the health of each security control (Vitals, today or on a past day), the raw records of one connected tool, and the portal users, roles and teams. Read-only. Cloud ID and API key.

个工具

8

区域

INTL

类别

监控

身份验证

API Key

所需环境变量

THREATAWARE_CLOUD_IDTHREATAWARE_API_KEY
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

摘要

来自任何 AI 代理的 ThreatAware 网络资产管理:跨安全和 IT 工具合并的设备和用户清单、开放警报、每个安全控制的健康状况(Vitals,今天或过去的某一天)、一个连接工具的原始记录,以及门户用户、角色和团队。只读。Cloud ID 和 API 密钥。

引导式设置

2 分钟将 ThreatAware 连接到 Gemini

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 ThreatAware,再把你的 MCP URL 添加到 Gemini。无需代码,也无需自行运行服务器。

无需信用卡 · 7 天试用 · 提供自托管方案

试试这样问

ThreatAware 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

ThreatAware · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → ThreatAware,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需 git clone,无需本地服务器。

ThreatAware + Gemini

来自任何 AI 代理的 ThreatAware 网络资产管理:跨安全和 IT 工具合并的设备和用户清单、开放警报、每个安全控制的健康状况(Vitals,今天或过去的某一天)、一个连接工具的原始记录,以及门户用户、角色和团队。只读。Cloud ID 和 API 密钥。

前提条件

请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:

THREATAWARE_CLOUD_ID, THREATAWARE_API_KEY

第 1 步 — 获取凭据

设置大约需要 3 分钟。

  1. 登录到你的门户,记下地址的第一部分:对于 https://acme-corp.threataware.com,Cloud ID 是 acme-corp。将其放入 THREATAWARE_CLOUD_ID。
  2. 打开 设置,API 访问(地址 /settings/api),点击 生成密钥。命名密钥,选择过期时间(1 天、1 周、1 个月或永不;默认是 1 天,因此请有意识地选择)并保存。
  3. 立即复制密钥(仅显示一次)到 THREATAWARE_API_KEY。它在 X-ThreatAware-ApiKey 头中发送。

密钥看到其创建者所看到的内容。ThreatAware 建议在专用服务用户下创建它,角色较窄,而不是个人账户。

从哪里开始

  • threataware_list_vitals 显示每个连接工具及其内部名称(key),以及在 Vitals 开启时,部署了多少设备,正常工作且配置正确。将这三对视为一个漏斗:部署的与预期相比,正常工作的与已部署相比,配置的与正常工作相比。
  • threataware_list_alerts 使用过滤器 allunresolved 列出当前开放的内容;state 红色表示紧急,琥珀色表示警告。
  • threataware_list_devices 是合并的设备清单。设备上的 SecurityTools 显示每个工具的警报计数,ConnectedSystems 显示设备已知的位置。
  • threataware_list_users 是合并的人员列表,metadata 中包含 MFA 和管理员标志,以及最后一次成功和失败的登录。
  • threataware_list_inventory 返回一个工具的原始记录,当你需要合并列表中没有的字段时。它需要工具的内部名称,即来自 threataware_list_vitals 的 key,而不总是门户中显示的名称(Microsoft Intune 是 devices_msgraph,SCCM 是 mecmsystem)。
  • 门户管理:threataware_list_portal_users、threataware_list_roles 和 threataware_list_teams 描述谁可以登录 ThreatAware 以及具有哪些权限。

分页:每个列表接受 offset 和 limit,并返回 total。当未发送限制时,ThreatAware 返回整个数据集,因此此连接器始终发送一个(默认 100)。在设备和用户上,偏移量在 10,000 条记录处停止(超过该状态为 400);请使用 filter 进行缩小。

读取数据

  • 时间为 ISO 8601 格式,不带时区,例如 2026-10-10T08:49:28.0000000。0001-01-01T00:00:00 表示“从未”(未确认、未解决、未延迟)。
  • 没有按主机名、用户或严重性进行的服务器端搜索:获取页面并自行过滤结果。
  • 设备和用户数据是个人数据(姓名、电子邮件、IP 地址、登录位置)。仅分享问题所需的信息。

限制和错误:整个门户每分钟 50 次请求,无论使用哪个密钥;状态 429 表示等待一分钟。状态 400 和“发生意外错误。”表示密钥错误、禁用或过期(ThreatAware 对错误密钥返回 400,而不是 401)。401 表示未发送密钥。403 表示密钥的用户缺乏该区域的权限。无法解析的门户地址表示 Cloud ID 错误。

第 2 步 — 安装适配器

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

第 3 步 — 在 Gemini 中添加连接器

你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json(Windows 上为 %USERPROFILE%\.gemini\settings.json)读取 MCP 服务器。添加:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换 YOUR_MCP_API_KEY。
  2. 保存文件并重启 gemini。
  3. 在 Gemini CLI 中运行 /mcp(或在终端运行 gemini mcp list)— anythingmcp 应显示为已连接。
  4. 开始输入提示 — Gemini CLI 现在可以调用 ThreatAware 的工具。

可用工具

工具功能
threataware_list_devices列出 ThreatAware 从所有连接工具合并的设备。每个设备具有 id、hostName、os、osVersion、lastOnline、firstSeen…
threataware_list_users列出 ThreatAware 从连接的目录和身份提供者收集的人员。每个用户具有 id、name、email、jobTitle…
threataware_list_alerts列出 ThreatAware 在环境中引发的警报(问题)。每个警报具有状态(红色、琥珀色或绿色)、产品(工具和…
threataware_list_inventory读取 ThreatAware 为一个连接工具保存的原始记录,使用该工具自己的字段名称(例如 Automox 补丁计数,或…
threataware_list_vitals获取每个连接安全工具的健康状况(Vitals),今天或过去的某一天。每个条目具有 key(由…
threataware_list_portal_users列出可以登录 ThreatAware 门户本身的账户(而不是在目录中找到的人:对于这些,请拨打…
threataware_list_roles列出 ThreatAware 门户的角色。每个角色具有 id(例如 superAdmin、analyst 或 viewer)、name、description、default(true…
threataware_list_teams列出 ThreatAware 门户的团队及其成员。每个团队具有 id、name 和成员(用户名、姓名和姓氏)。团队范围…

示例提示

  • "哪些安全工具在预期和已部署设备之间存在最大差距?"
  • "列出所有未解决的红色警报。"
  • "哪些用户没有 MFA 但具有管理员权限?"
  • "显示缺少 EDR 代理的设备。"
  • "谁可以登录我们的 ThreatAware 门户,以及具有哪些角色?"

常见问题

Cloud ID 和 API 密钥来自哪里? Cloud ID 是你的门户地址的第一部分(acme-corp 对于 acme-corp.threataware.com)。在设置、API 访问、生成密钥下创建密钥,故意选择其过期时间(默认是 1 天),并立即复制。密钥看到其创建者所看到的内容,因此 ThreatAware 推荐使用具有狭窄角色的专用服务用户。

它覆盖什么? 跨安全和 IT 工具合并的设备和用户清单、开放警报、每个安全控制的健康状况(Vitals:已部署、正常工作、已配置,今天或过去的某一天)、一个连接工具的原始记录,以及门户用户、角色和团队。没有按主机名、用户或严重性进行的服务器端搜索;AI 通过列表进行分页并过滤。

它能改变什么吗? 不可以。ThreatAware API v1 仅接受读取请求,因此无法更改、解决或删除任何内容,也无法安装关闭的内容。整个门户共享每分钟 50 次请求。

Gemini CLI 从哪里读取 MCP 服务器? 用户级配置位于 ~/.gemini/settings.json,项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

这份指南对你有帮助吗?

2 分钟将 ThreatAware 连接到 Gemini

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 ThreatAware,再把你的 MCP URL 添加到 Gemini。无需代码,也无需自行运行服务器。

相关指南

连接器

连接 ThreatAware MCP 与 ChatGPT

来自任何 AI 代理的 ThreatAware 网络资产管理:跨安全和 IT 工具合并的设备和用户清单、开放警报、每个安全控制的健康状况(Vitals,今天或过去的某一天)、一个连接工具的原始记录,以及门户用户、角色和团队。只读。Cloud ID 和 API 密钥。

连接器

连接 ThreatAware MCP 与 Claude

来自任何 AI 代理的 ThreatAware 网络资产管理:跨安全和 IT 工具合并的设备和用户清单、开放警报、每个安全控制的健康状况(Vitals,今天或过去的某一天)、一个连接工具的原始记录,以及门户用户、角色和团队。只读。Cloud ID 和 API 密钥。

连接器

连接 ThreatAware MCP 与 Microsoft Copilot

来自任何 AI 代理的 ThreatAware 网络资产管理:跨安全和 IT 工具合并的设备和用户清单、开放警报、每个安全控制的健康状况(Vitals,今天或过去的某一天)、一个连接工具的原始记录,以及门户用户、角色和团队。只读。Cloud ID 和 API 密钥。

连接器

连接 ThreatAware MCP 与 Cursor

来自任何 AI 代理的 ThreatAware 网络资产管理:跨安全和 IT 工具合并的设备和用户清单、开放警报、每个安全控制的健康状况(Vitals,今天或过去的某一天)、一个连接工具的原始记录,以及门户用户、角色和团队。只读。Cloud ID 和 API 密钥。

连接器

连接 ThreatAware MCP 与 Meta Muse

来自任何 AI 代理的 ThreatAware 网络资产管理:跨安全和 IT 工具合并的设备和用户清单、开放警报、每个安全控制的健康状况(Vitals,今天或过去的某一天)、一个连接工具的原始记录,以及门户用户、角色和团队。只读。Cloud ID 和 API 密钥。

连接器

ThreatAware MCP服务器:设备、警报与安全状态

通过任何 AI 代理进行 ThreatAware 网络资产管理:跨越你的安全和 IT 工具的合并设备和用户清单、开放的警报、每个安全控制的健康状况(Vitals,今天或过去某天)、一个连接工具的原始记录,以及门户用户、角色和团队。只读。Cloud ID 和 API 密钥。