Snyk Agent Scan

Descubra e escaneie componentes de agentes na sua máquina em busca de injeções de prompt
e vulnerabilidades (incluindo agentes, servidores MCP, skills).

Nota: Não publicamos um pacote npm para o Agent Scan. Instale-o via uvx ou como um binário autônomo.

Nota: A saída da CLI é experimental e está sujeita a alterações

Agent Scan v0.5.x (planejado para descontinuação)

A saída bruta desta CLI — incluindo códigos de problema, nomes de campos, rótulos de severidade e estrutura de resposta — é experimental e pode mudar sem aviso entre versões. Não recomendamos criar fluxos de trabalho de produção que dependam de campos de saída específicos da CLI ou códigos de problema.

Agent Scan v0.6 e posteriores

A saída bruta desta CLI — incluindo nomes de indicadores de risco, pontuações, nomes de campos e estrutura de resposta — é experimental e pode mudar sem aviso entre versões. Não recomendamos criar fluxos de trabalho de produção que dependam de campos de saída específicos da CLI ou nomes de risco.

Se você é um cliente empresarial que usa o Snyk para gerenciar riscos de segurança de agentes em escala, a saída da CLI pode não refletir o que é enviado e exibido na plataforma Evo. A integração, descoberta e avaliação de risco subjacentes que alimentam as implantações empresariais são estáveis e suportadas — quaisquer alterações serão comunicadas de acordo com as práticas padrão de produtos da Snyk. Entre em contato com sua equipe de conta para obter orientações sobre a implantação.

NOVO Leia nosso relatório técnico sobre as ameaças emergentes do ecossistema de skills de agentes publicado junto com o Agent Scan 0.4, que adiciona suporte para escanear skills de agentes.

Saída do Agent Scan v0.5.x

[!WARNING] O Agent Scan v0.5.x usa saída com códigos de problema. Esta linha da CLI está planejada para descontinuação.

Saída do Agent Scan v0.6 e posteriores

O Agent Scan ajuda você a descobrir todos os componentes de agentes instalados (harnesses, servidores MCP e skills) e os escaneia em busca de ameaças comuns, como injeções de prompt, tratamento de dados sensíveis ou cargas maliciosas ocultas em linguagem natural. Ignore a análise em skills usando --no-skills.

Aviso de Segurança

⚠️ IMPORTANTE: A verificação de configurações MCP pode executar comandos ou fazer pedidos de rede de saída.

Para obter as descrições das ferramentas, o Agent Scan inicia servidores MCP stdio executando os comandos na configuração e liga-se aos URLs dos servidores MCP remotos configurados com os respetivos cabeçalhos configurados.

Recomendações:

• Execute as verificações dentro de uma sandbox (contentor Docker, VM ou ambiente descartável) ao avaliar configurações MCP não fidedignas ou de terceiros
• Reveja cuidadosamente o pedido de consentimento durante as verificações interativas; este mostra o comando ou o URL remoto de cada servidor
• Utilize --dangerously-run-mcp-servers apenas em ambientes de confiança onde tenha verificado todos os comandos dos servidores MCP e os URLs remotos

Os pedidos MCP remotos recusam destinos que resolvam para endereços link-local ou endpoints de metadados de cloud conhecidos (169.254.0.0/16, fe80::/10, fd00:ec2::254 e 100.100.100.200). Os endereços de loopback e privados continuam permitidos para servidores MCP locais e internos. Os redirecionamentos HTTP não são seguidos. O DNS é validado antes de cada pedido, mas a resolução novamente no momento da ligação deixa uma janela de DNS-rebinding.

Por predefinição, o Agent Scan exige o consentimento explícito do utilizador (y/n) antes de contactar cada servidor MCP descoberto durante execuções interativas em primeiro plano. As verificações em segundo plano e com push-key continuam a inspecionar servidores remotos automaticamente para cobertura da frota, mas não iniciam servidores stdio a menos que --dangerously-run-mcp-servers esteja definido.

Início Rápido

Escolha uma de duas formas de executar o Agent Scan:

1. Execute o pacote Python com uvx seguindo as instruções abaixo.
2. Descarregue um binário autónomo para a sua plataforma a partir de GitHub Releases. As releases também incluem o SBOM, checksums, checksums assinados e arquivos de código-fonte.

Antes de utilizar qualquer uma das opções:

1. Registe-se na Snyk e obtenha um token de API em https://app.snyk.io/account (API Token → KEY → clique para mostrar).
2. Defina o token como variável de ambiente antes de executar qualquer verificação:

   export SNYK_TOKEN=your-api-token-here
   

Executar com uvx

Tenha o uv instalado no seu sistema. Escolha as instruções para a versão da sua CLI.

Agent Scan v0.5.x

Os exemplos fixam a v0.5.17 como uma versão concreta da 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 usa saída de código de problema e a API de análise 2025-09-02. Esta linha de CLI está planejada para descontinuação.

Agent Scan v0.6 e posterior

# 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

v0.6 e posteriores usam a saída baseada em risco e a API de análise 2026-07-10.

Ambas as versões escaneiam servidores MCP, ferramentas, prompts, recursos e skills, e descobrem automaticamente configurações de agentes suportadas, como Claude Code/Desktop, Cursor, Gemini CLI e Windsurf.

Executar com um binário autônomo

Baixe o binário para o seu sistema operacional e arquitetura na última versão do GitHub. A página de releases também fornece um SBOM (sbom-<version>.json), arquivos de checksum e arquivos de código-fonte gerados pelo GitHub. Consulte Verificando Binários Autônomos para verificar o seu download.

Destaques

• Descoberta automática de configurações MCP, ferramentas de agentes, skills
• Escaneamento de Claude, Cursor, GitHub Copilot, Windsurf, Gemini CLI, Amp, Amazon Q e outros agentes.

Agent Scan v0.5.x