Snyk Agent Scan

Descubre y analiza los componentes de agentes en tu máquina en busca de inyecciones de prompts
y vulnerabilidades (incluidos agentes, servidores MCP y skills).

Nota: No publicamos un paquete npm para Agent Scan. Instálalo mediante uvx o como un binario independiente.

Nota: la salida de la CLI es experimental y está sujeta a cambios

Agent Scan v0.5.x (con retirada prevista)

La salida sin procesar de esta CLI —incluidos los códigos de incidencia, los nombres de campos, las etiquetas de severidad y la estructura de respuesta— es experimental y puede cambiar sin previo aviso entre versiones. No recomendamos crear flujos de trabajo de producción que dependan de campos de salida específicos de la CLI ni de códigos de incidencia.

Agent Scan v0.6 y posteriores

La salida sin procesar de esta CLI —incluidos los nombres de los indicadores de riesgo, las puntuaciones, los nombres de campos y la estructura de respuesta— es experimental y puede cambiar sin previo aviso entre versiones. No recomendamos crear flujos de trabajo de producción que dependan de campos de salida específicos de la CLI ni de nombres de riesgo.

Si eres un cliente empresarial que utiliza Snyk para gestionar el riesgo de seguridad de los agentes a escala, la salida de la CLI puede no reflejar lo que se envía y se muestra en la plataforma Evo. La integración, el descubrimiento y la evaluación de riesgos subyacentes que impulsan las implementaciones empresariales son estables y cuentan con soporte; cualquier cambio se comunicará conforme a las prácticas estándar de productos de Snyk. Ponte en contacto con tu equipo de cuenta para obtener orientación sobre la implementación.

NUEVO Lee nuestro informe técnico sobre las amenazas emergentes del ecosistema de skills para agentes, publicado junto con Agent Scan 0.4, que añade compatibilidad para analizar skills de agentes.

Salida de Agent Scan v0.5.x

[!WARNING] Agent Scan v0.5.x utiliza una salida basada en códigos de incidencia. Está previsto retirar esta línea de la CLI.

Salida de Agent Scan v0.6 y posteriores

Agent Scan te ayuda a descubrir todos los componentes de agentes instalados (harnesses, servidores MCP y skills) y los analiza en busca de amenazas comunes como inyecciones de prompts, manejo de datos sensibles o cargas maliciosas ocultas en lenguaje natural. Omite el análisis de las skills usando --no-skills.

Advertencia de seguridad

⚠️ IMPORTANTE: Escanear configuraciones de MCP puede ejecutar comandos o realizar solicitudes de red salientes.

Para recuperar las descripciones de las herramientas, Agent Scan inicia servidores MCP de stdio ejecutando los comandos de la configuración y se conecta a las URL de servidores MCP remotos configuradas con sus encabezados configurados.

Recomendaciones:

• Ejecutar los escaneos dentro de un sandbox (contenedor Docker, VM o entorno desechable) al evaluar configuraciones MCP no confiables o de terceros
• Revisar cuidadosamente el aviso de consentimiento durante los escaneos interactivos; muestra el comando o la URL remota de cada servidor
• Usar --dangerously-run-mcp-servers solo en entornos de confianza donde hayas verificado todos los comandos de los servidores MCP y las URL remotas

Las solicitudes MCP remotas rechazan destinos que resuelvan a direcciones link-local o a endpoints conocidos de metadatos en la nube (169.254.0.0/16, fe80::/10, fd00:ec2::254 y 100.100.100.200). Las direcciones de loopback y privadas siguen permitidas para servidores MCP locales e internos. No se siguen las redirecciones HTTP. El DNS se valida antes de cada solicitud, pero la resolución nuevamente en el momento de la conexión deja una ventana de DNS rebinding.

De forma predeterminada, Agent Scan requiere el consentimiento explícito del usuario (s/n) antes de contactar cada servidor MCP descubierto durante las ejecuciones interactivas en primer plano. Los escaneos en segundo plano y con push-key continúan inspeccionando automáticamente los servidores remotos para la cobertura de la flota, pero no inician servidores stdio a menos que se establezca --dangerously-run-mcp-servers.

Inicio rápido

Elige una de las dos formas de ejecutar Agent Scan:

1. Ejecutar el paquete de Python con uvx siguiendo las instrucciones a continuación.
2. Descargar un binario independiente para tu plataforma desde GitHub Releases. Las versiones también incluyen el SBOM, las sumas de verificación, las sumas de verificación firmadas y los archivos de código fuente.

Antes de usar cualquiera de las dos opciones:

1. Regístrate en Snyk y obtén un token de API desde https://app.snyk.io/account (API Token → KEY → haz clic para mostrar).
2. Establece el token como variable de entorno antes de ejecutar cualquier escaneo:

   export SNYK_TOKEN=your-api-token-here
   

Ejecutar con uvx

Tenga uv instalado en su sistema. Elija las instrucciones para su versión de CLI.

Agent Scan v0.5.x

Los ejemplos fijan v0.5.17 como una versión concreta de 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 utiliza salida de código de problema y la API de análisis 2025-09-02. Esta línea de CLI está prevista para su deprecación.

Agent Scan v0.6 y posteriores

# 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 y posteriores usan la salida basada en riesgos y la API de análisis 2026-07-10.

Ambas versiones escanean servidores MCP, herramientas, prompts, recursos y skills, y descubren automáticamente configuraciones de agentes compatibles como Claude Code/Desktop, Cursor, Gemini CLI y Windsurf.

Ejecutar con un binario independiente

Descarga el binario para tu sistema operativo y arquitectura desde la última versión de GitHub. La página de la versión también proporciona un SBOM (sbom-<version>.json), archivos de checksum y archivos de código fuente generados por GitHub. Consulta Verificación de binarios independientes para verificar tu descarga.

Aspectos destacados