摘要
来自任何 AI 代理的 ThreatAware 网络资产管理:跨安全和 IT 工具合并的设备和用户清单、开放警报、每个安全控制的健康状况(Vitals,今天或过去的某一天)、一个连接工具的原始记录,以及门户用户、角色和团队。只读。Cloud ID 和 API 密钥。
引导式设置
2 分钟将 ThreatAware 连接到 Microsoft Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 ThreatAware,再把你的 MCP URL 添加到 Microsoft Copilot。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
ThreatAware 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → ThreatAware,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
ThreatAware + Microsoft Copilot
来自任何 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 步 — 在 Microsoft Copilot 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器:把 AnythingMCP 作为工具添加到智能体,然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接,AnythingMCP 支持这种方式。
- 在 Copilot Studio 中打开你的智能体(或新建一个),进入 Tools,选择 Add a tool → New tool → Model Context Protocol。
- 填写 Server name(例如
AnythingMCP)、说明连接器用途的 Server description,以及 Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。 - 身份验证选择 API key,把 Type 设为 Header,请求头名称填
X-API-Key,然后选择 Create。 - 在 Add tool 中选择 Create a new connection,粘贴 AnythingMCP 的 MCP API 密钥(MCP Servers → 你的服务器 → API keys),然后选择 Add to agent。
- 在智能体的 Test 窗格中试一试:提出需要用到
ThreatAware的工具的请求。 - 选择 Publish,然后进入 Channels → Microsoft 365 and Microsoft Teams,保持勾选 Make agent available in Microsoft Copilot,再选择 Add channel。See agent in Teams 会为你安装该智能体;在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。
希望每个用户各自登录?请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥:每个用户会在智能体首次调用时登录 AnythingMCP。
自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接,因此 localhost 无法使用。
可用工具
| 工具 | 功能 |
|---|---|
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 次请求。
这适用于哪个 Copilot? 适用于工作中的 Microsoft 365 Copilot,通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。
我需要什么? 一个可以使用 Copilot Studio 的工作账户(许可证或试用版),用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限:把它共享给他们,或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略,这些策略同样适用于 MCP 服务器。
智能体不调用工具。 检查请求头名称是否正好是 X-API-Key,密钥是否属于与 URL 相同的 MCP 服务器,并把 Server description 写得具体:Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体;在已打开的对话中输入 "start over" 即可使用新版本。
下一步
这份指南对你有帮助吗?