Как подключить Netskope к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Netskope, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Netskope + Gemini

Netskope Security Service Edge, только чтение: поиск алертов и событий (приложения, веб, сеть, инциденты, DLP на конечных устройствах), журнал аудита администраторов, оценки риска пользователей, запросы к Cloud Confidence Index, списки URL, publishers и приложения Private Access, пользователи и группы SCIM.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

NETSKOPE_TENANT, NETSKOPE_API_TOKEN

Шаг 1 — Получите учётные данные

Настройка занимает около 5 минут. Нужен тенант Netskope и токен REST API v2 с правом Read на те эндпоинты, которые будет использовать ИИ.

1. В тенанте Netskope откройте Settings > Tools > REST API v2 и создайте новый токен или используйте сервисную учётную запись в Settings > Administration > Administrators & Roles.
2. Добавьте с правом Read каждый эндпоинт, который нужен ИИ: /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. Эндпоинт, который вы не добавили, для ИИ закрыт.
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, publishers, приложения или пользователей.

Что он читает: алерты (DLP, вредоносное ПО, политики, аномалии, скомпрометированные учётные данные, UBA и другие); события одного типа за раз: application (активность в облачных приложениях), page (посещения сайтов), network (трафик файрвола и Private Access), incident, clientstatus (состояние клиента Netskope на устройствах) и epdlp (DLP на конечных устройствах); журнал аудита администраторов (кто изменил какую настройку или политику, входы в консоль); User Confidence Index пользователя (UCI, оценка риска по поведенческой аналитике от 0 до 1000) и его изменения; Cloud Confidence Index облачного приложения по точному названию, например Dropbox или Slack (оценка, Cloud Confidence Level, категория, теги, разрешено ли приложение или только обнаружено); списки URL, используемые в политиках; publishers Private Access с их статусом и частными приложениями, которые они обслуживают; пользователей и группы, переданные по SCIM.

Поиск алертов и событий: ИИ задаёт период (starttime и endtime в секундах Unix) и query на языке запросов Netskope, например 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 ограничивает каждый эндпоинт несколькими вызовами в секунду и при превышении отвечает 429 с Retry-After.

Частые ошибки: 401 или 403 означает неверный или просроченный токен либо эндпоинт, не добавленный к токену с правом Read; 403 может прийти и из-за списка разрешённых IP тенанта. Неудачный вызов datasearch, например из-за неизвестного поля в query, возвращает status.execution FAILED с сообщением, и коннектор превращает его в ошибку. 404 на каждом вызове обычно означает неверный NETSKOPE_TENANT.

Шаг 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 читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Netskope.

Доступные инструменты

Примеры запросов

• «Покажите DLP-алерты с высокой критичностью за последние 24 часа, сгруппированные по пользователям.»
• «Какие пользователи вызвали больше всего алертов на этой неделе и какие названия алертов встречаются чаще всего?»
• «Какой User Confidence Index у [email protected] и как он изменился за последние 30 дней?»
• «Найдите Cloud Confidence Index для Dropbox и скажите, разрешено ли это приложение.»
• «Все ли наши publishers Private Access подключены и какие частные приложения обслуживает каждый из них?»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Meta Muse
• Подключить к Microsoft Copilot