Resumen
Gestión de activos cibernéticos de ThreatAware desde cualquier agente de IA: el inventario combinado de dispositivos y usuarios a través de tus herramientas de seguridad y TI, alertas abiertas, la salud de cada control de seguridad (Vitals, hoy o en un día pasado), los registros en bruto de una herramienta conectada y los usuarios, roles y equipos del portal. Solo lectura. Cloud ID y clave API.
Configuración guiada
Conecta ThreatAware a Microsoft Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta ThreatAware con la configuración guiada y añade tu URL MCP a Microsoft Copilot. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para ThreatAware
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → ThreatAware, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
ThreatAware + Microsoft Copilot
Gestión de activos cibernéticos de ThreatAware desde cualquier agente de IA: el inventario combinado de dispositivos y usuarios a través de tus herramientas de seguridad y TI, alertas abiertas, la salud de cada control de seguridad (Vitals, hoy o en un día pasado), los registros en bruto de una herramienta conectada y los usuarios, roles y equipos del portal. Solo lectura. Cloud ID y clave API.
Requisitos previos
Consulta las instrucciones de configuración completas integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
THREATAWARE_CLOUD_ID, THREATAWARE_API_KEY
Paso 1 — Obtener credenciales
La configuración tarda aproximadamente 3 minutos.
- Inicia sesión en tu portal y anota la primera parte de su dirección: para
https://acme-corp.threataware.comel Cloud ID esacme-corp. Ponlo enTHREATAWARE_CLOUD_ID. - Abre Configuración, Acceso a API (dirección
/settings/api) y haz clic en Generar clave. Nombra la clave, elige una fecha de caducidad (1 día, 1 semana, 1 mes o Nunca; el valor predeterminado es 1 día, así que elige a propósito) y guarda. - Copia la clave de inmediato (se muestra solo una vez) en
THREATAWARE_API_KEY. Se envía en el encabezadoX-ThreatAware-ApiKey.
La clave ve lo que su creador ve. ThreatAware recomienda crearla bajo un usuario de servicio dedicado con un rol restringido en lugar de una cuenta personal.
Dónde empezar
threataware_list_vitalsmuestra cada herramienta conectada con su nombre interno (key) y, donde Vitals está activado, cuántos dispositivos tienen el agente desplegado, funcionando y correctamente configurados. Lee los tres pares como un embudo: desplegados de lo esperado, funcionando de lo desplegado, configurados de lo funcionando.threataware_list_alertscon el filtroallunresolvedlista lo que está abierto ahora;stateRojo es urgente, Ámbar es una advertencia.threataware_list_deviceses el inventario combinado de dispositivos.SecurityToolsen un dispositivo muestra los recuentos de alertas por herramienta,ConnectedSystemsdonde se conoce el dispositivo.threataware_list_userses la lista combinada de personas, con banderas de MFA y admin enmetadatay el último inicio de sesión exitoso y fallido.threataware_list_inventorydevuelve los registros en bruto de una herramienta cuando necesitas un campo que las listas combinadas no tienen. Necesita el nombre interno de la herramienta, que es elkeydethreataware_list_vitalsy no siempre es el nombre mostrado en el portal (Microsoft Intune esdevices_msgraph, SCCM esmecmsystem).- Administración del portal:
threataware_list_portal_users,threataware_list_rolesythreataware_list_teamsdescriben quién puede iniciar sesión en ThreatAware y con qué derechos.
Paginación: cada lista toma offset y limit y responde total. ThreatAware devuelve todo el conjunto de datos cuando no se envía un límite, así que este conector siempre envía uno (100 por defecto). En dispositivos y usuarios, el offset se detiene en 10,000 registros (estado 400 más allá de eso); estrecha con filter en su lugar.
Lectura de los datos
- Los tiempos son ISO 8601 sin zona horaria, por ejemplo,
2026-10-10T08:49:28.0000000.0001-01-01T00:00:00significa "nunca" (no reconocido, no resuelto, no pospuesto). - No hay búsquedas del lado del servidor por nombre de host, usuario o severidad: recupera páginas y filtra el resultado tú mismo.
- Los datos de dispositivos y usuarios son datos personales (nombres, correos electrónicos, direcciones IP, ubicaciones de inicio de sesión). Comparte solo lo que la pregunta necesita.
Límites y errores: 50 solicitudes por minuto para todo el portal, independientemente de la clave utilizada; el estado 429 significa espera un minuto. El estado 400 con "Ocurrió un error inesperado." significa que la clave es incorrecta, está deshabilitada o ha caducado (ThreatAware responde 400, no 401, por una clave incorrecta). 401 significa que no se envió ninguna clave. 403 significa que el usuario de la clave carece de permiso para esa área. Una dirección de portal que no se resuelve significa que el Cloud ID es incorrecto.
Paso 2 — Instalar 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 — Agregar 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 muestraYOUR_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.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - 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.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
ThreatAware. - 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
| Herramienta | Qué hace |
|---|---|
threataware_list_devices | Lista los dispositivos que ThreatAware ha combinado de todas las herramientas conectadas. Cada dispositivo tiene id, hostName, os, osVersion, lastOnline, firstSeen… |
threataware_list_users | Lista las personas que ThreatAware ha recopilado de los directorios y proveedores de identidad conectados. Cada usuario tiene id, nombre, correo electrónico, jobTitle… |
threataware_list_alerts | Lista las alertas (problemas) que ThreatAware ha generado en el entorno. Cada alerta tiene estado (Rojo, Ámbar o Verde), producto (herramienta y… |
threataware_list_inventory | Lee los registros en bruto que ThreatAware tiene para una herramienta conectada, en los propios nombres de campo de esa herramienta (por ejemplo, recuentos de parches de Automox, o… |
threataware_list_vitals | Obtiene la salud de cada herramienta de seguridad conectada (Vitals), hoy o en un día pasado. Cada entrada tiene key (el nombre interno de la herramienta utilizado por el… |
threataware_list_portal_users | Lista las cuentas que pueden iniciar sesión en el portal de ThreatAware en sí (no las personas encontradas en los directorios: para esas llama… |
threataware_list_roles | Lista los roles del portal de ThreatAware. Cada rol tiene id (por ejemplo, superAdmin, analista o espectador), nombre, descripción, predeterminado (true… |
threataware_list_teams | Lista los equipos del portal de ThreatAware con sus miembros. Cada equipo tiene id, nombre y miembros (nombre de usuario, nombre y apellido). El alcance de los equipos… |
Ejemplos de indicaciones
- "¿Qué herramientas de seguridad tienen la mayor brecha entre los dispositivos esperados y los desplegados?"
- "Lista todas las alertas rojas no resueltas."
- "¿Qué usuarios no tienen MFA pero tienen derechos de admin?"
- "Muestra los dispositivos que faltan el agente EDR."
- "¿Quién puede iniciar sesión en nuestro portal de ThreatAware, y con qué roles?"
Preguntas frecuentes
¿De dónde provienen el Cloud ID y la clave API? El Cloud ID es la primera parte de la dirección de tu portal (acme-corp para acme-corp.threataware.com). Crea la clave en Configuración, Acceso a API, Generar clave, elige su caducidad a propósito (el valor predeterminado es 1 día) y cópiala de inmediato. La clave ve lo que su creador ve, así que ThreatAware recomienda un usuario de servicio dedicado con un rol restringido.
¿Qué cubre? El inventario combinado de dispositivos y usuarios a través de tus herramientas de seguridad y TI, alertas abiertas, la salud de cada control de seguridad (Vitals: desplegados, funcionando, configurados, hoy o en un día pasado), los registros en bruto de una herramienta conectada y los usuarios, roles y equipos del portal. No hay búsquedas del lado del servidor por nombre de host, usuario o severidad; la IA navega a través de las listas y las filtra.
¿Puede cambiar algo? No. La API de ThreatAware v1 acepta solo solicitudes de lectura, por lo que nada puede ser cambiado, resuelto o eliminado, y nada instala apagado. Todo el portal comparte 50 solicitudes por minuto.
¿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
¿Te ha sido útil esta guía?