如何通过 MCP 将 Netskope 连接到 Gemini

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

Netskope + Gemini

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 — 在 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 现在可以调用 Netskope 的工具。

可用工具

示例提示

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

FAQ

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

下一步

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