Кратко
Управление кибер-активами ThreatAware от любого AI-агента: объединенный инвентарь устройств и пользователей по вашим инструментам безопасности и IT, открытые оповещения, состояние каждого средства безопасности (Vitals, сегодня или в прошлый день), сырые записи одного подключенного инструмента и пользователи портала, роли и команды. Только для чтения. Cloud ID и API ключ.
Пошаговая настройка
Подключи ThreatAware к Microsoft Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи ThreatAware в пошаговой настройке и добавь свой MCP URL в Microsoft Copilot. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для ThreatAware
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → ThreatAware, вставь свои учетные данные, создай API ключ MCP и готово. Никакого Docker, никакого
git clone, никакого локального сервера.
ThreatAware + Microsoft Copilot
Управление кибер-активами ThreatAware от любого AI-агента: объединенный инвентарь устройств и пользователей по вашим инструментам безопасности и IT, открытые оповещения, состояние каждого средства безопасности (Vitals, сегодня или в прошлый день), сырые записи одного подключенного инструмента и пользователи портала, роли и команды. Только для чтения. Cloud ID и API ключ.
Предварительные требования
Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:
THREATAWARE_CLOUD_ID, THREATAWARE_API_KEY
Шаг 1 — Получи учетные данные
Настройка занимает около 3 минут.
- Войди в свой портал и запомни первую часть его адреса: для
https://acme-corp.threataware.comCloud ID — этоacme-corp. Вставь его вTHREATAWARE_CLOUD_ID. - Открой Настройки, Доступ к API (адрес
/settings/api) и нажми Сгенерировать ключ. Назови ключ, выбери срок действия (1 день, 1 неделя, 1 месяц или Никогда; по умолчанию 1 день, так что выбирай осознанно) и сохрани. - Скопируй ключ сразу (он показывается только один раз) в
THREATAWARE_API_KEY. Он отправляется в заголовкеX-ThreatAware-ApiKey.
Ключ видит то, что видит его создатель. ThreatAware рекомендует создавать его под выделенным сервисным пользователем с узкой ролью, а не под личной учетной записью.
С чего начать
threataware_list_vitalsпоказывает каждое подключенное средство с его внутренним именем (key) и, где Vitals включен, сколько устройств имеет установленный, работающий и правильно настроенный агент. Читай три пары как воронку: развернуто из ожидаемого, функционирует из развернутого, настроено из функционирующего.threataware_list_alertsс фильтромallunresolvedперечисляет то, что открыто сейчас;stateКрасный — срочно, Янтарный — предупреждение.threataware_list_devices— объединенный инвентарь устройств.SecurityToolsна устройстве показывает количество оповещений по инструментам,ConnectedSystems— где устройство известно.threataware_list_users— объединенный список людей, с флагами MFA и админа вmetadataи последними успешными и неудачными входами.threataware_list_inventoryвозвращает сырые записи одного инструмента, когда тебе нужно поле, которого нет в объединенных списках. Он требует внутреннего имени инструмента, которое являетсяkeyизthreataware_list_vitalsи не всегда совпадает с именем, показанным в портале (Microsoft Intune — этоdevices_msgraph, SCCM — этоmecmsystem).- Администрирование портала:
threataware_list_portal_users,threataware_list_rolesиthreataware_list_teamsописывают, кто может войти в ThreatAware и с какими правами.
Пагинация: каждый список принимает offset и limit и отвечает total. ThreatAware возвращает весь набор данных, когда лимит не отправляется, так что этот коннектор всегда отправляет один (по умолчанию 100). Для устройств и пользователей смещение останавливается на 10,000 записях (статус 400 за пределами этого); уточняй с помощью filter.
Чтение данных
- Времена в формате ISO 8601 без часового пояса, например,
2026-10-10T08:49:28.0000000.0001-01-01T00:00:00означает "никогда" (не подтверждено, не разрешено, не отложено). - Нет серверных поисков по имени хоста, пользователю или серьезности: извлекай страницы и фильтруй результат сам.
- Данные об устройствах и пользователях являются персональными данными (имена, электронные почты, IP-адреса, места входа). Делись только тем, что необходимо для вопроса.
Ограничения и ошибки: 50 запросов в минуту для всего портала, независимо от используемого ключа; статус 429 означает подожди минуту. Статус 400 с "Произошла неожиданная ошибка." означает, что ключ неправильный, отключен или истек (ThreatAware отвечает 400, а не 401, за плохой ключ). 401 означает, что ключ не был отправлен. 403 означает, что у пользователя ключа нет разрешения на эту область. Адрес портала, который не разрешается, означает, что Cloud ID неправильный.
Шаг 2 — Установи адаптер
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
Шаг 3 — Добавь коннектор в Microsoft Copilot
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.
- В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
- Укажи Server name (например,
AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер. - В аутентификации выбери API key, установи Type в Header, укажи имя заголовка
X-API-Keyи нажми Create. - В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
- Проверь в панели Test агента: попроси о том, для чего нужны инструменты
ThreatAware. - Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.
Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.
Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
threataware_list_devices | Перечисляет устройства, которые ThreatAware объединил из всех подключенных инструментов. Каждое устройство имеет id, hostName, os, osVersion, lastOnline, firstSeen… |
threataware_list_users | Перечисляет людей, которых ThreatAware собрал из подключенных каталогов и поставщиков идентификации. У каждого пользователя есть id, имя, электронная почта, должность… |
threataware_list_alerts | Перечисляет оповещения (проблемы), которые ThreatAware выявил в среде. Каждое оповещение имеет состояние (Красный, Янтарный или Зеленый), продукт (инструмент и… |
threataware_list_inventory | Читает сырые записи, которые ThreatAware хранит для одного подключенного инструмента, в полях этого инструмента (например, количество патчей Automox или… |
threataware_list_vitals | Получает состояние каждого подключенного средства безопасности (Vitals), сегодня или в прошлый день. Каждая запись имеет ключ (внутреннее имя инструмента, используемое… |
threataware_list_portal_users | Перечисляет учетные записи, которые могут войти в портал ThreatAware (не людей, найденных в каталогах: для этого звони… |
threataware_list_roles | Перечисляет роли портала ThreatAware. У каждой роли есть id (например, superAdmin, аналитик или зритель), имя, описание, по умолчанию (true… |
threataware_list_teams | Перечисляет команды портала ThreatAware с их участниками. У каждой команды есть id, имя и участники (имя пользователя, имя и фамилия). Объем команд… |
Примеры подсказок
- "Какие средства безопасности имеют наибольший разрыв между ожидаемыми и развернутыми устройствами?"
- "Перечисли все нерешенные Красные оповещения."
- "Какие пользователи не имеют MFA, но имеют права администратора?"
- "Покажи устройства, на которых отсутствует агент EDR."
- "Кто может войти в наш портал ThreatAware и с какими ролями?"
Часто задаваемые вопросы
Откуда берутся Cloud ID и API ключ? Cloud ID — это первая часть адреса твоего портала (acme-corp для acme-corp.threataware.com). Создай ключ в разделе Настройки, Доступ к API, Сгенерировать ключ, выбери срок действия осознанно (по умолчанию 1 день) и скопируй его сразу. Ключ видит то, что видит его создатель, поэтому ThreatAware рекомендует выделенного сервисного пользователя с узкой ролью.
Что он охватывает? Объединенный инвентарь устройств и пользователей по вашим инструментам безопасности и IT, открытые оповещения, состояние каждого средства безопасности (Vitals: развернуто, функционирует, настроено, сегодня или в прошлый день), сырые записи одного подключенного инструмента и пользователи портала, роли и команды. Нет серверных поисков по имени хоста, пользователю или серьезности; AI просматривает списки и фильтрует их.
Может ли он что-то изменить? Нет. API ThreatAware v1 принимает только запросы на чтение, поэтому ничего не может быть изменено, разрешено или удалено, и ничего не устанавливается, если выключено. Весь портал делит 50 запросов в минуту.
Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.
Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.
Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.
Следующие шаги
Это руководство помогло?