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

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

Snyk + Gemini

Проверяйте Snyk из AI-агента: организации, цели и проекты, уязвимости и другие проблемы всех продуктов с данными об исправлении и путями зависимостей, SBOM, зависимости, проверка пакетов по purl, участники, игнорирования и политики; после вашего подтверждения ставьте теги проектам, задавайте их атрибуты и игнорируйте проблемы.

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

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

SNYK_API_URL, SNYK_TOKEN

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

Настройка занимает около 3 минут. Доступ к API требует тарифа Snyk Enterprise: токены Free и Team работают только для CLI и IDE и здесь отвечают 401 или 403.

1. Создайте токен. Для общего коннектора лучше всего service account: Organization или Group settings, Service accounts, с ролью Org Collaborator для чтения или Org Admin для игнорирований и атрибутов. Для себя подойдёт personal access token из Account settings, Personal access tokens (он истекает не позже чем через 90 дней), или API-токен в Account settings.
2. Вставьте его в SNYK_TOKEN без префикса вроде token или Bearer. Он отправляется как Authorization: token <key>.
3. Укажите в SNYK_API_URL API вашего региона, без /rest и /v1: https://api.snyk.io (app.snyk.io), https://api.us.snyk.io (app.us.snyk.io), https://api.eu.snyk.io (app.eu.snyk.io), https://api.au.snyk.io (app.au.snyk.io) или https://api.snykgov.io (Snyk for Government). Какой именно, видно по адресу вашего приложения Snyk.
4. Установите коннектор и выполните snyk_get_self, затем snyk_list_orgs, чтобы получить id организаций.

Коннектор использует REST API Snyk (версия 2026-03-25), а там, где в REST нет аналога, v1 API.

Id: каждый инструмент принимает id организации (UUID из snyk_list_orgs), а не её слаг. Id проблем REST из snyk_list_issues это UUID; инструменты v1 (snyk_list_issue_paths, snyk_create_ignore, snyk_delete_ignore) принимают id проблемы v1, например SNYK-JS-LODASH-567746, то есть id в snyk_list_aggregated_issues и attributes.problems[].id в проблемах REST.

Что он читает:

• Инвентарь: snyk_get_self, snyk_list_orgs, snyk_get_org, snyk_list_targets и snyk_get_target (репозитории, образы контейнеров, загрузки из CLI), snyk_list_projects и snyk_get_project с типом, источником, тегами, атрибутами и последними счётчиками проблем по критичности, snyk_list_integrations (GitHub, GitLab, Bitbucket Cloud, Azure Repos, Docker Hub, ECR и другие) и snyk_list_org_members.
• Проблемы: snyk_list_issues по всей организации или snyk_list_project_issues по одному проекту, включая уязвимости и лицензии open source, Code, IaC, контейнеры и секреты. Фильтры по типу, effective_severity_level, статусу (open, resolved), признаку игнорирования и датам; затем snyk_get_issue показывает затронутые версии пакета и способы исправления.
• Исправления: snyk_list_aggregated_issues для проектов open source и контейнеров с пакетом и версией, CVSS и priority score, зрелостью эксплойта, возможностью обновления или патча и версиями с исправлением, а snyk_list_issue_paths показывает каждый путь зависимостей, по которому уязвимый пакет попадает в проект.
• Цепочка поставок: snyk_get_project_sbom выгружает SBOM последнего сканирования проекта в CycloneDX от 1.4 до 1.6 (JSON или XML) или SPDX 2.3 JSON, snyk_list_dependencies показывает, где пакет используется в проектах, а snyk_list_package_issues проверяет версию пакета по purl (например, pkg:npm/[email protected]) перед её добавлением.
• Игнорирования: snyk_list_project_ignores (v1, проекты open source и контейнеров), а также snyk_list_policies и snyk_get_policy для consistent ignores уровня организации, которые используют Snyk Code и более новые продукты.

Что он меняет после вашего подтверждения: snyk_add_project_tag и snyk_remove_project_tag (ключ и значение, например team:payments), snyk_set_project_attributes (бизнес-критичность, окружение и жизненный цикл; переданные списки заменяют прежние) и snyk_create_ignore. Игнорирование скрывает уязвимость из тестов, отчётов и проверок pull request, поэтому ИИ называет проблему, проект, тип причины (not-vulnerable, wont-fix или temporary-ignore) и срок, предпочитает временное игнорирование с датой окончания и вызывает инструмент только после вашего согласия.

Отключено при установке: snyk_delete_ignore. Он удаляет все правила игнорирования проблемы в проекте вместе с причиной и историей, и это нельзя отменить, поэтому администратор рабочего пространства включает его, когда это нужно команде.

Форматы данных: ответы REST в формате JSON:API: поля лежат в data[].attributes, связанные id в relationships. Уровни критичности: critical, high, medium и low (для некоторых продуктов info); effective_severity_level учитывает изменения критичности, сделанные вашей организацией. Даты в ISO 8601 по UTC. SBOM больших проектов получаются объёмными.

Пагинация: списки REST принимают limit (по умолчанию 20, до 100) и возвращают links.next; ИИ вызывает снова с starting_after, равным значению из этой ссылки, пока links.next не исчезнет. Инструменты v1 листают через page и perPage.

Ограничения: Snyk разрешает около 1620 REST-запросов в минуту на токен и 2000 запросов v1 в минуту на пользователя; 429 значит подождать минуту.

Типичные ошибки: 401 означает, что токен неверен, просрочен или отозван, относится к другому региону (проверьте SNYK_API_URL) или у тарифа нет доступа к API. 403 означает, что роль токена не разрешает вызов в этой организации. 404 означает неверный id или слаг организации там, где нужен id. 400 или 422 называют неверный параметр.

Коннектор не запускает тесты и сканирования, не импортирует репозитории, не удаляет, не деактивирует и не перемещает проекты и цели и не создаёт политики уровня организации. Отчёты уровня группы, журналы аудита, настройки, подключение интеграций, участники и приглашения, service accounts, Snyk Apps, а также эндпоинты cloud и AI-BOM не поддерживаются.

Шаг 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 теперь может вызывать инструменты Snyk.

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

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

• «В каких проектах нашей организации Snyk сейчас есть открытые критические уязвимости?»
• «Безопасен ли pkg:npm/[email protected]? Если нет, в какой версии проблемы исправлены?»
• «Какие проблемы высокой критичности в проекте api-server исправляются обновлением и через какую зависимость попадает каждая из них?»
• «Выгрузи SBOM проекта checkout-service в формате CycloneDX JSON.»
• «Проигнорируй SNYK-JS-LODASH-567746 в проекте web-frontend как temporary-ignore до конца года, причина: недостижимо из нашего кода.»

FAQ

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

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

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