摘要
来自任何 AI 代理的 ThreatAware 网络资产管理:跨安全和 IT 工具合并的设备和用户清单、开放警报、每个安全控制的健康状况(Vitals,今天或过去的某一天)、一个连接工具的原始记录,以及门户用户、角色和团队。只读。Cloud ID 和 API 密钥。
引导式设置
2 分钟将 ThreatAware 连接到 Cursor
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 ThreatAware,再把你的 MCP URL 添加到 Cursor。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
ThreatAware 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → ThreatAware,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
ThreatAware + Cursor
来自任何 AI 代理的 ThreatAware 网络资产管理:跨安全和 IT 工具合并的设备和用户清单、开放警报、每个安全控制的健康状况(Vitals,今天或过去的某一天)、一个连接工具的原始记录,以及门户用户、角色和团队。只读。Cloud ID 和 API 密钥。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
THREATAWARE_CLOUD_ID, THREATAWARE_API_KEY
第 1 步 — 获取凭据
设置大约需要 3 分钟。
- 登录到你的门户,记下地址的第一部分:对于
https://acme-corp.threataware.com,Cloud ID 是acme-corp。将其放入THREATAWARE_CLOUD_ID。 - 打开 设置,API 访问(地址
/settings/api),点击 生成密钥。命名密钥,选择过期时间(1 天、1 周、1 个月或永不;默认是 1 天,因此请有意识地选择)并保存。 - 立即复制密钥(仅显示一次)到
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 步 — 在 Cursor 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启 Cursor。
- 打开 Cursor → Settings → MCP,确认
anythingmcp已列出并处于已连接状态。 - 开始对话 — 智能体现在可以调用
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 次请求。
Cursor 免费套餐支持自定义 MCP 服务器吗? 支持 — Hobby、Pro 和 Business 套餐均可使用 MCP。
下一步
这份指南对你有帮助吗?