Zusammenfassung
ThreatAware Cyber-Asset-Management von jedem KI-Agenten: das zusammengeführte Geräte- und Benutzerinventar über deine Sicherheits- und IT-Tools, offene Warnungen, die Gesundheit jeder Sicherheitskontrolle (Vitals, heute oder an einem vergangenen Tag), die Rohdaten eines verbundenen Tools sowie die Portalbenutzer, Rollen und Teams. Nur lesbar. Cloud-ID und API-Schlüssel.
Geführte Einrichtung
ThreatAware in 2 Minuten mit Gemini verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde ThreatAware in der geführten Einrichtung und trag deine MCP-URL in Gemini ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Frag einfach
Beispiel-Prompts für ThreatAware
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → ThreatAware, füge deine Zugangsdaten ein, generiere einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein
git clone, kein lokaler Server.
ThreatAware + Gemini
ThreatAware Cyber-Asset-Management von jedem KI-Agenten: das zusammengeführte Geräte- und Benutzerinventar über deine Sicherheits- und IT-Tools, offene Warnungen, die Gesundheit jeder Sicherheitskontrolle (Vitals, heute oder an einem vergangenen Tag), die Rohdaten eines verbundenen Tools sowie die Portalbenutzer, Rollen und Teams. Nur lesbar. Cloud-ID und API-Schlüssel.
Voraussetzungen
Siehe die vollständigen Einrichtungsanweisungen, die im Connector integriert sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:
THREATAWARE_CLOUD_ID, THREATAWARE_API_KEY
Schritt 1 — Zugangsdaten erhalten
Die Einrichtung dauert etwa 3 Minuten.
- Melde dich bei deinem Portal an und notiere den ersten Teil der Adresse: für
https://acme-corp.threataware.comist die Cloud-IDacme-corp. Gib sie inTHREATAWARE_CLOUD_IDein. - Öffne Einstellungen, API-Zugriff (Adresse
/settings/api) und klicke auf Schlüssel generieren. Benenne den Schlüssel, wähle eine Ablaufzeit (1 Tag, 1 Woche, 1 Monat oder Nie; der Standard ist 1 Tag, also wähle absichtlich) und speichere. - Kopiere den Schlüssel sofort (er wird nur einmal angezeigt) in
THREATAWARE_API_KEY. Er wird im HeaderX-ThreatAware-ApiKeygesendet.
Der Schlüssel sieht, was sein Ersteller sieht. ThreatAware empfiehlt, ihn unter einem dedizierten Dienstbenutzer mit einer engen Rolle anstelle eines persönlichen Kontos zu erstellen.
Wo anfangen
threataware_list_vitalszeigt jedes verbundene Tool mit seinem internen Namen (key) und, wo Vitals aktiviert ist, wie viele Geräte den Agenten installiert, funktionsfähig und korrekt konfiguriert haben. Lies die drei Paare als Trichter: installiert aus erwartet, funktionsfähig aus installiert, konfiguriert aus funktionsfähig.threataware_list_alertsmit dem Filterallunresolvedlistet auf, was jetzt offen ist;stateRot ist dringend, Amber ist eine Warnung.threataware_list_devicesist das zusammengeführte Geräteinventar.SecurityToolsauf einem Gerät zeigt die Warnungszahlen pro Tool,ConnectedSystemswo das Gerät bekannt ist.threataware_list_usersist die zusammengeführte Liste von Personen, mit MFA- und Admin-Flags inmetadataund dem letzten erfolgreichen und fehlgeschlagenen Anmeldeversuch.threataware_list_inventorygibt die Rohdaten eines Tools zurück, wenn du ein Feld benötigst, das die zusammengeführten Listen nicht haben. Es benötigt den internen Namen des Tools, der derkeyvonthreataware_list_vitalsist und nicht immer der Name, der im Portal angezeigt wird (Microsoft Intune istdevices_msgraph, SCCM istmecmsystem).- Portalverwaltung:
threataware_list_portal_users,threataware_list_rolesundthreataware_list_teamsbeschreiben, wer sich bei ThreatAware anmelden kann und mit welchen Rechten.
Paging: jede Liste nimmt offset und limit und antwortet mit total. ThreatAware gibt den gesamten Datensatz zurück, wenn kein Limit gesendet wird, daher sendet dieser Connector immer eines (100 standardmäßig). Bei Geräten und Benutzern stoppt der Offset bei 10.000 Datensätzen (Status 400 darüber); schränke stattdessen mit filter ein.
Daten lesen
- Zeiten sind im ISO 8601-Format ohne Zeitzone, z.B.
2026-10-10T08:49:28.0000000.0001-01-01T00:00:00bedeutet "nie" (nicht anerkannt, nicht gelöst, nicht verschoben). - Es gibt keine serverseitigen Suchen nach Hostnamen, Benutzern oder Schweregraden: hole Seiten und filtere das Ergebnis selbst.
- Geräte- und Benutzerdaten sind personenbezogene Daten (Namen, E-Mails, IP-Adressen, Anmeldestandorte). Teile nur, was die Frage benötigt.
Limits und Fehler: 50 Anfragen pro Minute für das gesamte Portal, unabhängig davon, welcher Schlüssel verwendet wird; Status 429 bedeutet, eine Minute warten. Status 400 mit "Unerwarteter Fehler aufgetreten." bedeutet, dass der Schlüssel falsch, deaktiviert oder abgelaufen ist (ThreatAware antwortet mit 400, nicht 401, bei einem schlechten Schlüssel). 401 bedeutet, dass kein Schlüssel gesendet wurde. 403 bedeutet, dass der Benutzer des Schlüssels nicht die Berechtigung für diesen Bereich hat. Eine Portaladresse, die nicht aufgelöst wird, bedeutet, dass die Cloud-ID falsch ist.
Schritt 2 — Adapter installieren
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
Schritt 3 — Connector in Gemini hinzufügen
Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese AnleitungYOUR_SERVER_IDzeigt.
Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von
YOUR_MCP_API_KEYein. - Speichere die Datei und starte
geminineu. - Führe in der Gemini CLI
/mcpaus (odergemini mcp listim Terminal) —anythingmcpsollte als verbunden erscheinen. - Leg los: Gemini CLI kann jetzt die
ThreatAware-Tools aufrufen.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
threataware_list_devices | Listet die Geräte auf, die ThreatAware aus allen verbundenen Tools zusammengeführt hat. Jedes Gerät hat id, hostName, os, osVersion, lastOnline, firstSeen… |
threataware_list_users | Listet die Personen auf, die ThreatAware aus den verbundenen Verzeichnissen und Identitätsanbietern gesammelt hat. Jeder Benutzer hat id, name, email, jobTitle… |
threataware_list_alerts | Listet die Warnungen (Probleme) auf, die ThreatAware in der Umgebung ausgelöst hat. Jede Warnung hat einen Zustand (Rot, Amber oder Grün), Produkt (Tool und… |
threataware_list_inventory | Liest die Rohdaten, die ThreatAware für ein verbundenes Tool hält, in den eigenen Feldnamen dieses Tools (zum Beispiel Automox-Patchzahlen oder… |
threataware_list_vitals | Erhält die Gesundheit jedes verbundenen Sicherheitstools (Vitals), heute oder an einem vergangenen Tag. Jeder Eintrag hat key (den internen Toolnamen, der von den… |
threataware_list_portal_users | Listet die Konten auf, die sich beim ThreatAware-Portal selbst anmelden können (nicht die Personen, die in den Verzeichnissen gefunden werden: für diese rufe… |
threataware_list_roles | Listet die Rollen des ThreatAware-Portals auf. Jede Rolle hat id (zum Beispiel superAdmin, analyst oder viewer), name, description, default (true… |
threataware_list_teams | Listet die Teams des ThreatAware-Portals mit ihren Mitgliedern auf. Jedes Team hat id, name und Mitglieder (Benutzername, Vorname und Nachname). Teams haben… |
Beispielaufforderungen
- "Welche Sicherheitstools haben die größte Lücke zwischen erwarteten und installierten Geräten?"
- "Liste alle ungelösten roten Warnungen auf."
- "Welche Benutzer haben keine MFA, aber Admin-Rechte?"
- "Zeige die Geräte an, denen der EDR-Agent fehlt."
- "Wer kann sich in unser ThreatAware-Portal anmelden und mit welchen Rollen?"
FAQ
Woher kommen die Cloud-ID und der API-Schlüssel? Die Cloud-ID ist der erste Teil deiner Portaladresse (acme-corp für acme-corp.threataware.com). Erstelle den Schlüssel unter Einstellungen, API-Zugriff, Schlüssel generieren, wähle absichtlich seine Ablaufzeit (der Standard ist 1 Tag) und kopiere ihn sofort. Der Schlüssel sieht, was sein Ersteller sieht, daher empfiehlt ThreatAware einen dedizierten Dienstbenutzer mit einer engen Rolle.
Was deckt es ab? Das zusammengeführte Geräte- und Benutzerinventar über deine Sicherheits- und IT-Tools, offene Warnungen, die Gesundheit jeder Sicherheitskontrolle (Vitals: installiert, funktionsfähig, konfiguriert, heute oder an einem vergangenen Tag), die Rohdaten eines verbundenen Tools sowie die Portalbenutzer, Rollen und Teams. Es gibt keine serverseitigen Suchen nach Hostnamen, Benutzern oder Schweregraden; die KI durchblättert die Listen und filtert sie.
Kann es etwas ändern? Nein. Die ThreatAware API v1 akzeptiert nur Leseanfragen, daher kann nichts geändert, gelöst oder gelöscht werden, und nichts installiert wird abgeschaltet. Das gesamte Portal teilt sich 50 Anfragen pro Minute.
Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.
Nächste Schritte
War dieser Guide hilfreich?