Conectar Wazuh MCP con Microsoft Copilot

💡 ¿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 + Microsoft Copilot

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.

Requisitos previos

Consulta las instrucciones de configuración completas incluidas en el conector (visibles en la tienda dentro de la aplicación al seleccionar el conector). Las variables de entorno necesarias para este conector son:

WAZUH_URL, WAZUH_USERNAME, WAZUH_PASSWORD

Paso 1 — Obtén las credenciales

La configuración lleva unos 5 minutos. Necesitas una API del servidor 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 es 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 la 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 justificación y remediación; archivos, hashes y último análisis 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. Dale a la API 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 en 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 archivo y los hashes describen tu infraestructura. Asigna el conector únicamente 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 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" indica un WAZUH_USERNAME o WAZUH_PASSWORD incorrecto. 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 todavía 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.

Paso 2 — Instala el adaptador

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

Paso 3 — Añade el conector en Microsoft Copilot

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Wazuh.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

Herramientas disponibles

Preguntas frecuentes

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Próximos pasos

• Página del conector
• Conectar con Claude
• Conectar con ChatGPT