如何通过 MCP 将 Netskope 连接到 Microsoft Copilot

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Netskope、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Netskope + Microsoft Copilot

Netskope Security Service Edge，只读：搜索告警和事件（应用、Web、网络、事件单、终端 DLP）、管理员审计日志、用户风险评分、Cloud Confidence Index 查询、URL 列表、Private Access 的 publisher 和应用，以及 SCIM 用户和组。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

NETSKOPE_TENANT, NETSKOPE_API_TOKEN

步骤 1 — 获取凭证

设置大约需要 5 分钟。你需要一个 Netskope 租户，以及一个对 AI 要使用的端点具有 Read 权限的 REST API v2 令牌。

1. 在 Netskope 租户中打开 Settings > Tools > REST API v2，创建一个新令牌；也可以使用 Settings > Administration > Administrators & Roles 下的服务账号。
2. 以 Read 权限添加 AI 要使用的每个端点：/api/v2/events/datasearch/alert 及其他 /api/v2/events/datasearch/... 类型、/api/v2/events/data/audit、/api/v2/ubadatasvc/user/uci、/api/v2/services/cci/app、/api/v2/policy/urllist、/api/v2/infrastructure/publishers、/api/v2/steering/apps/private、/api/v2/scim/Users 和 /api/v2/scim/Groups。没有添加的端点，AI 无法访问。
3. 设置有效期，并把令牌复制到 NETSKOPE_API_TOKEN。它通过 Netskope-Api-Token 请求头发送。
4. 把 NETSKOPE_TENANT 设为浏览器地址栏中显示的租户主机名，例如 example.goskope.com（欧盟租户例如 example.eu.goskope.com），不带 https://，也不带路径。
5. 如果租户启用了 IP 允许列表（Settings > Administration > IP Allowlist），请加入你的 AnythingMCP 服务器的出站地址。
6. 安装连接器并运行 netskope_search_alerts 检查令牌。

只读：所有工具都只读取。netskope_get_user_risk_score 以 POST 发送，但只读取评分。连接器不会修改策略、URL 列表、publisher、应用或用户。

可读取的内容：告警（DLP、恶意软件、策略、异常、凭证泄露、UBA 等）；每次一种类型的事件：application（云应用活动）、page（网页访问）、network（防火墙和 Private Access 流量）、incident、clientstatus（设备上 Netskope 客户端的状态）和 epdlp（终端 DLP）；管理员审计日志（谁修改了哪个设置或策略、控制台登录）；用户的 User Confidence Index（UCI，基于行为分析的 0 到 1000 风险评分）及其变化；按确切名称（如 Dropbox 或 Slack）查询云应用的 Cloud Confidence Index（评分、Cloud Confidence Level、类别、标签、已批准还是仅被发现）；策略中使用的 URL 列表；Private Access 的 publisher 及其状态和所服务的私有应用；以及通过 SCIM 预配的用户和组。

搜索告警和事件：AI 会设定时间范围（以 Unix 秒表示的 starttime 和 endtime）和一个 Netskope 查询语言的 query，例如 alert_type eq 'DLP' 或 severity eq 'high'，并且只请求需要的 fields。统计数量时，它使用 fields=count_total:count(_id) 配合 groupbys（例如 alert_name 或 user），并按 count_total desc 排序。大型租户有数百万条事件，因此每次事件搜索都带时间范围。UCI 的时间（from_time）以毫秒为单位。

限制：datasearch 列表用 limit 和 offset 翻页，SCIM 列表用 startIndex（从 1 开始）和 count。Netskope 对每个端点限制为每秒几次调用，超过后返回带 Retry-After 的 429。

常见错误：401 或 403 表示令牌错误或已过期，或者该端点没有以 Read 权限加入令牌；403 也可能来自租户的 IP 允许列表。datasearch 调用失败时（例如 query 中有未知字段），会返回 status.execution FAILED 和一条消息，连接器会把它变成错误。每次调用都返回 404，通常是 NETSKOPE_TENANT 填错了。

步骤 2 — 安装 adapter

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 支持这种方式。

1. 在 Copilot Studio 中打开你的智能体（或新建一个），进入 Tools，选择 Add a tool → New tool → Model Context Protocol。
2. 填写 Server name（例如 AnythingMCP）、说明连接器用途的 Server description，以及 Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。
3. 身份验证选择 API key，把 Type 设为 Header，请求头名称填 X-API-Key，然后选择 Create。
4. 在 Add tool 中选择 Create a new connection，粘贴 AnythingMCP 的 MCP API 密钥（MCP Servers → 你的服务器 → API keys），然后选择 Add to agent。
5. 在智能体的 Test 窗格中试一试：提出需要用到 Netskope 的工具的请求。
6. 选择 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 无法使用。

可用工具

示例提示

• “列出过去 24 小时内严重级别为 high 的 DLP 告警，按用户分组。”
• “本周哪些用户触发的告警最多？最常出现的告警名称是哪些？”
• “[email protected] 的 User Confidence Index 是多少？过去 30 天有什么变化？”
• “查一下 Dropbox 的 Cloud Confidence Index，告诉我它是否已被批准。”
• “我们所有的 Private Access publisher 都已连接吗？每个分别服务哪些私有应用？”

FAQ

这适用于哪个 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" 即可使用新版本。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Cursor
• 连接到 Gemini
• 连接到 Meta Muse