Snyk Agent Scan

Обнаруживайте и сканируйте компоненты агентов на вашей машине на предмет prompt-инъекций
и уязвимостей (включая агентов, MCP-серверы, навыки).

Примечание: Мы не публикуем npm-пакет для Agent Scan. Устанавливайте его через uvx или как автономный бинарный файл.

Примечание: вывод CLI является экспериментальным и может измениться

Agent Scan v0.5.x (планируется к устареванию)

Необработанный вывод этого CLI — включая коды проблем, имена полей, метки серьёзности и структуру ответа — является экспериментальным и может меняться без предупреждения между релизами. Мы не рекомендуем строить производственные рабочие процессы, зависящие от конкретных полей вывода CLI или кодов проблем.

Agent Scan v0.6 и новее

Необработанный вывод этого CLI — включая имена индикаторов риска, оценки, имена полей и структуру ответа — является экспериментальным и может меняться без предупреждения между релизами. Мы не рекомендуем строить производственные рабочие процессы, зависящие от конкретных полей вывода CLI или имён рисков.

Если вы корпоративный клиент, использующий Snyk для управления рисками безопасности агентов в масштабе, вывод CLI может не отражать то, что отправляется и отображается на платформе Evo. Базовая интеграция, обнаружение и оценка рисков, обеспечивающие корпоративные развёртывания, стабильны и поддерживаются — любые изменения будут доведены до сведения в соответствии со стандартными практиками продуктов Snyk. Обратитесь к вашей команде по работе с клиентами за рекомендациями по развёртыванию.

НОВОЕ Ознакомьтесь с нашим техническим отчётом о новых угрозах экосистемы навыков агентов, опубликованным вместе с Agent Scan 0.4, который добавляет поддержку сканирования навыков агентов.

Вывод Agent Scan v0.5.x

[!WARNING] Agent Scan v0.5.x использует вывод с кодами проблем. Эта линейка CLI планируется к устареванию.

Вывод Agent Scan v0.6 и новее

Agent Scan помогает обнаруживать все установленные компоненты агентов (обвязки, MCP-серверы и навыки) и сканирует их на предмет распространённых угроз, таких как prompt-инъекции, обработка конфиденциальных данных или вредоносные полезные нагрузки, скрытые в естественном языке. Игнорируйте анализ навыков с помощью --no-skills.

Предупреждение о безопасности

⚠️ ВАЖНО: Сканирование конфигураций MCP может выполнять команды или отправлять исходящие сетевые запросы.

Для получения описаний инструментов Agent Scan запускает stdio MCP-серверы, выполняя команды из конфигурации, и подключается к настроенным URL удалённых MCP-серверов с их заданными заголовками.

Рекомендации:

• Запускайте сканирование в песочнице (Docker-контейнер, виртуальная машина или одноразовая среда) при проверке недоверенных или сторонних конфигураций MCP
• Внимательно изучайте запрос на согласие во время интерактивного сканирования; в нём отображается команда или удалённый URL для каждого сервера
• Используйте --dangerously-run-mcp-servers только в доверенных средах, где вы проверили все команды MCP-серверов и удалённые URL

Запросы к удалённым MCP отклоняют адресаты, разрешающиеся в link-local адреса или известные конечные точки облачных метаданных (169.254.0.0/16, fe80::/10, fd00:ec2::254 и 100.100.100.200). Loopback- и частные адреса по-прежнему разрешены для локальных и внутренних MCP-серверов. HTTP-редиректы не отслеживаются. DNS проверяется перед каждым запросом, но повторное разрешение во время подключения оставляет окно для DNS-rebinding.

По умолчанию Agent Scan требует явного согласия пользователя (y/n) перед обращением к каждому обнаруженному MCP-серверу во время интерактивных запусков на переднем плане. Фоновые сканирования и сканирования с push-ключом продолжают автоматически проверять удалённые серверы для охвата парка, но не запускают stdio-серверы, если не задан --dangerously-run-mcp-servers.

Быстрый старт

Выберите один из двух способов запуска Agent Scan:

1. Запустите Python-пакет с помощью uvx, следуя инструкциям ниже.
2. Скачайте автономный бинарный файл для вашей платформы со страницы GitHub Releases. В релизах также содержатся SBOM, контрольные суммы, подписанные контрольные суммы и архивы исходного кода.

Перед использованием любого из вариантов:

1. Зарегистрируйтесь на Snyk и получите API-токен на https://app.snyk.io/account (API Token → KEY → нажмите, чтобы показать).
2. Задайте токен как переменную окружения перед запуском любого сканирования:

   export SNYK_TOKEN=your-api-token-here
   

Запуск с помощью uvx

Установите uv в вашей системе. Выберите инструкции для вашей версии CLI.

Agent Scan v0.5.x

В примерах закреплена версия v0.5.17 как конкретный релиз ветки v0.5.x:

# Scan the whole machine
uvx [email protected]

# Scan a specific MCP configuration
uvx [email protected] ~/.vscode/mcp.json

# Scan a single agent skill
uvx [email protected] ~/path/to/my/SKILL.md

# Scan all Claude skills
uvx [email protected] ~/.claude/skills

[!WARNING] В v0.5.x используется вывод issue-code и API анализа 2025-09-02. Эту линейку CLI планируется вывести из эксплуатации.

Agent Scan v0.6 и новее

# Scan the whole machine
uvx snyk-agent-scan@latest

# Scan a specific MCP configuration
uvx snyk-agent-scan@latest ~/.vscode/mcp.json

# Scan a single agent skill
uvx snyk-agent-scan@latest ~/path/to/my/SKILL.md

# Scan all Claude skills
uvx snyk-agent-scan@latest ~/.claude/skills

В версии 0.6 и более поздних используется риск-ориентированный вывод и API анализа 2026-07-10.

Обе версии сканируют MCP-серверы, инструменты, промпты, ресурсы и навыки, а также автоматически обнаруживают поддерживаемые конфигурации агентов, такие как Claude Code/Desktop, Cursor, Gemini CLI и Windsurf.

Запуск с помощью автономного бинарного файла

Скачайте бинарный файл для вашей операционной системы и архитектуры со страницы последнего релиза на GitHub. На странице релиза также доступны SBOM (sbom-<version>.json), файлы контрольных сумм и архивы исходного кода, созданные GitHub. См. Проверка автономных бинарных файлов, чтобы проверить загруженный файл.

Основные возможности

• Автоматическое обнаружение конфигураций MCP, инструментов агентов, навыков
• Сканирование Claude, Cursor, GitHub Copilot, Windsurf, Gemini CLI, Amp, Amazon Q и других агентов.

Agent Scan v0.5.x