Wazuh MCP Server: agentes, CIS y archivos

💡 ¿Sin instalar nada? Usa directamente cloud.anythingmcp.com. Inicia sesión, haz clic en Connectors → Wazuh, pega tus credenciales, genera una clave de API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Wazuh

Permite que tu IA lea tu plataforma de seguridad Wazuh 4.x a través de la API del servidor: versión del manager y estado de los daemons, agentes y su estado de conexión, las reglas de detección y los decoders, resultados de Security Configuration Assessment (benchmark CIS) y datos de File Integrity Monitoring por agente. Solo lectura: nunca reinicia, modifica ni elimina nada. Las alertas y las vulnerabilidades residen en el indexer de Wazuh y no están cubiertas.

Configuración

La configuración lleva unos 5 minutos. Necesitas una API de servidor de Wazuh 4.x (el manager, puerto 55000 por defecto) a la que AnythingMCP pueda acceder con un certificado en el que confíe, y un usuario de API con el rol integrado readonly.

1. Establece WAZUH_URL con la dirección de la API del servidor, normalmente https://<manager-host>:55000, sin barra final. No el dashboard (puerto 443) ni el indexer (puerto 9200).
2. Crea un usuario de API dedicado para la IA y asígnale el rol integrado readonly: en el dashboard de Wazuh, en Server management → Security → Users, o con POST /security/users y POST /security/users/{user_id}/roles.
3. Pon el nombre de ese usuario en WAZUH_USERNAME y su contraseña en WAZUH_PASSWORD. El conector inicia sesión con ellos y renueva por sí mismo el token de sesión (los tokens de Wazuh duran 900 segundos por defecto).
4. Instala el conector y ejecuta wazuh_get_manager_info: devuelve la versión del manager y confirma que la dirección y el inicio de sesión funcionan.

Solo lectura: todas las herramientas son peticiones GET. El conector no puede reiniciar nada, ejecutar respuestas activas, añadir, eliminar ni actualizar agentes, ni editar reglas, decoders, usuarios o configuración. El rol readonly cubre todos los permisos que necesita (manager:read, agent:read, rules:read, decoders:read, sca:read y syscheck:read).

Qué lee: versiones del manager y de la API y el estado de cada daemon del manager; agentes con estado, IP, SO, versión, grupos y último keep-alive, recuentos por estado (wazuh_get_agents_summary), plataformas de SO y agentes más antiguos que el manager; el conjunto de reglas por nivel, grupo, mapeo de cumplimiento (PCI DSS, GDPR, HIPAA, NIST 800-53, TSC) o id de MITRE, y los decoders; políticas de Security Configuration Assessment (benchmark CIS) y comprobaciones fallidas por agente, con su justificación y remediación; archivos, hashes y último escaneo de File Integrity Monitoring (syscheck) por agente. Los ids de agente tienen al menos tres dígitos (001); 000 es el propio manager.

Certificado: Wazuh instala un certificado autofirmado en el puerto 55000, y un certificado autofirmado falla: el conector no tiene ningún interruptor para confiar en cualquier certificado. Dota a la API de un certificado cuyo nombre coincida con WAZUH_URL (https.cert y https.key en el api.yaml de Wazuh), coloca delante un proxy inverso con un certificado válido o, en autoalojado, inicia AnythingMCP con NODE_EXTRA_CA_CERTS apuntando a tu CA interna.

Dónde se ejecuta Wazuh: en un AnythingMCP autoalojado, un Wazuh en una dirección privada (https://10.0.0.5:55000, https://wazuh.intern:55000) requiere que un administrador permita el host en SSRF_ALLOWED_HOSTS o en la lista de permitidos de los ajustes de administración. AnythingMCP Cloud solo puede acceder a una API de Wazuh expuesta a internet público mediante HTTPS con un certificado de confianza pública.

Privacidad: los nombres de agente, las direcciones IP, los sistemas operativos, las rutas de archivos y los hashes describen tu infraestructura. Asigna el conector solo a servidores MCP cuyos usuarios puedan ver esa información.

Límites: las herramientas de listado devuelven 50 elementos por defecto y como máximo 500 por llamada. Wazuh permite 300 peticiones por minuto por defecto y responde con 429 por encima de ese límite, y por defecto 50 inicios de sesión fallidos en 5 minutos bloquean la dirección durante 300 segundos.

Errores comunes: 401 "Invalid credentials" significa que WAZUH_USERNAME o WAZUH_PASSWORD son incorrectos. 403 significa que al usuario de API le falta un permiso de lectura: asígnale el rol readonly. 404 en todas las llamadas significa que WAZUH_URL apunta al dashboard o al indexer en lugar de a la API del servidor. "Agent does not exist" (error 1701 de Wazuh) significa que ningún agente tiene ese id. 400 "There is no database for agent" significa que el agente nunca se conectó, por lo que aún no tiene datos de SCA ni de FIM. "self-signed certificate" o "unable to verify the first certificate" es el problema de certificado descrito arriba.

El conector no lee alertas ni eventos ni resultados de detección de vulnerabilidades (residen en el indexer de Wazuh, no en esta API), no escribe nada, no cubre la configuración del clúster y no es compatible con Wazuh 5.x, que elimina la mayoría de estos endpoints.

Requisitos previos: WAZUH_URL, WAZUH_USERNAME, WAZUH_PASSWORD

Instalar el conector en local

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

Abre http://localhost:3000/connectors/store, elige Wazuh y pega las variables de entorno indicadas en Requisitos previos.

Herramientas disponibles

Siguientes pasos

• Conectar con Claude
• Conectar con ChatGPT