概要
任意のAIエージェントからのThreatAwareサイバー資産管理:セキュリティおよびITツール全体の統合デバイスおよびユーザーインベントリ、オープンアラート、各セキュリティコントロールの健康状態(Vitals、今日または過去の日)、接続されたツールの生データ、およびポータルのユーザー、役割、チーム。読み取り専用。Cloud IDとAPIキー。
ガイド付きセットアップ
ThreatAware を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで ThreatAware を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
ThreatAware のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → ThreatAwareをクリックし、資格情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
ThreatAware + Microsoft Copilot
任意のAIエージェントからのThreatAwareサイバー資産管理:セキュリティおよびITツール全体の統合デバイスおよびユーザーインベントリ、オープンアラート、各セキュリティコントロールの健康状態(Vitals、今日または過去の日)、接続されたツールの生データ、およびポータルのユーザー、役割、チーム。読み取り専用。Cloud IDとAPIキー。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択するとアプリ内ストアに表示されます)。このコネクタに必要な環境変数は次のとおりです:
THREATAWARE_CLOUD_ID, THREATAWARE_API_KEY
ステップ1 — 資格情報を取得する
設定には約3分かかります。
- ポータルにサインインし、アドレスの最初の部分をメモします:
https://acme-corp.threataware.comの場合、Cloud 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は人々の統合リストで、metadataにMFAと管理者フラグ、最後の成功したサインインと失敗したサインインが含まれています。threataware_list_inventoryは、統合リストにないフィールドが必要な場合に、1つのツールの生データを返します。ツールの内部名が必要で、これはthreataware_list_vitalsのkeyであり、ポータルに表示される名前とは限りません(Microsoft Intuneはdevices_msgraph、SCCMはmecmsystemです)。- ポータル管理:
threataware_list_portal_users、threataware_list_roles、threataware_list_teamsは、誰がThreatAwareにサインインできるか、どの権限を持っているかを説明します。
ページング:すべてのリストはoffsetとlimitを取り、totalを返します。ThreatAwareは制限が送信されない場合、全データセットを返しますので、このコネクタは常に1つ(デフォルトは100)を送信します。デバイスとユーザーでは、オフセットは10,000レコードで停止します(それを超えるとステータス400);代わりにfilterで絞り込んでください。
データの読み取り
- 時間はタイムゾーンなしのISO 8601形式です。例:
2026-10-10T08:49:28.0000000。0001-01-01T00:00:00は「決してない」を意味します(未承認、未解決、スヌーズされていない)。 - ホスト名、ユーザー、または重大度によるサーバー側の検索はありません:ページを取得し、結果を自分でフィルタリングしてください。
- デバイスおよびユーザーデータは個人データです(名前、メールアドレス、IPアドレス、サインイン場所)。質問に必要なものだけを共有してください。
制限とエラー:ポータル全体で50リクエスト/分、使用されるキーに関係なく;ステータス429は1分待つことを意味します。ステータス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 は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。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 を選び、AnythingMCP の MCP API キー(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://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| ツール | 機能 |
|---|---|
threataware_list_devices | ThreatAwareがすべての接続されたツールから統合したデバイスをリストします。各デバイスにはid、hostName、os、osVersion、lastOnline、firstSeen…があります。 |
threataware_list_users | ThreatAwareが接続されたディレクトリおよびアイデンティティプロバイダーから収集した人々をリストします。各ユーザーにはid、name、email、jobTitle…があります。 |
threataware_list_alerts | ThreatAwareが環境全体で発生させたアラート(問題)をリストします。各アラートには状態(赤、アンバー、緑)、製品(ツールなど…)があります。 |
threataware_list_inventory | 接続されたツールの生データを、そのツールのフィールド名で読み取ります(例えば、Automoxのパッチ数など…)。 |
threataware_list_vitals | すべての接続されたセキュリティツール(Vitals)の健康状態を取得します。今日または過去の日のデータです。各エントリにはkey(内部ツール名)が含まれています。 |
threataware_list_portal_users | ThreatAwareポータル自体にサインインできるアカウントをリストします(ディレクトリ内の人々ではなく、それらを呼び出すには…)。 |
threataware_list_roles | ThreatAwareポータルの役割をリストします。各役割にはid(例:superAdmin、analyst、viewer)、name、description、default(trueまたはfalse)が含まれています。 |
threataware_list_teams | メンバーを持つThreatAwareポータルのチームをリストします。各チームにはid、name、メンバー(ユーザー名、名前、姓)が含まれています。チームのスコープ… |
例のプロンプト
- "期待されるデバイスと展開されたデバイスの間に最も大きなギャップがあるセキュリティツールはどれですか?"
- "未解決の赤いアラートをすべてリストしてください。"
- "MFAがないが管理者権限を持つユーザーは誰ですか?"
- "EDRエージェントが欠落しているデバイスを表示してください。"
- "私たちのThreatAwareポータルにサインインできるのは誰で、どの役割を持っていますか?"
FAQ
Cloud IDとAPIキーはどこから来ますか? Cloud IDはポータルアドレスの最初の部分です(acme-corpはacme-corp.threataware.comのため)。設定のAPIアクセス、キーを生成、意図的に有効期限を選択し(デフォルトは1日)、一度にコピーします。キーはその作成者が見るものを見ますので、ThreatAwareは専用のサービスユーザーで狭い役割を持つことを推奨しています。
何をカバーしていますか? セキュリティおよびITツール全体の統合デバイスおよびユーザーインベントリ、オープンアラート、各セキュリティコントロールの健康状態(Vitals:展開、機能、構成、今日または過去の日)、接続されたツールの生データ、およびポータルのユーザー、役割、チームです。ホスト名、ユーザー、または重大度によるサーバー側の検索はありません;AIがリストをページングし、フィルタリングします。
何かを変更できますか? いいえ。ThreatAware API v1は読み取りリクエストのみを受け入れるため、何も変更、解決、削除できず、オフにされたインストールもありません。ポータル全体で50リクエスト/分を共有します。
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント(ライセンスまたは試用版)が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?