Wazuh MCPをGemini CLIに接続：エージェントとファイル

💡 インストール不要。cloud.anythingmcp.com をそのままご利用いただけます。 サインインして Connectors → Wazuh をクリックし、認証情報を貼り付けて、MCP APIキーを発行するだけです。Dockerも git clone もローカルサーバーも不要です。

Wazuh + Gemini

サーバーAPIを通じて、AIがWazuh 4.xセキュリティプラットフォームを読み取れるようにします。マネージャーのバージョンとデーモンの状態、エージェントとその接続状況、検出ルールとデコーダー、エージェントごとのSecurity Configuration Assessment(CISベンチマーク)の結果とFile Integrity Monitoringのデータが対象です。読み取り専用で、再起動、変更、削除は一切行いません。アラートと脆弱性はWazuhインデクサーにあり、対象外です。

前提条件

コネクターに組み込まれている完全なセットアップ手順をご確認ください(アプリ内ストアでコネクターを選択すると表示されます)。このコネクターに必要な環境変数は次のとおりです。

WAZUH_URL, WAZUH_USERNAME, WAZUH_PASSWORD

ステップ1 — 認証情報を取得する

セットアップには約5分かかります。AnythingMCPが信頼できる証明書で到達できるWazuh 4.xのサーバーAPI(マネージャー、デフォルトはポート55000)と、組み込みの readonly ロールを持つAPIユーザーが必要です。

1. WAZUH_URL にサーバーAPIのアドレスを設定します。通常は https://<manager-host>:55000 で、末尾にスラッシュは付けません。ダッシュボード(ポート443)やインデクサー(ポート9200)ではありません。
2. AI専用のAPIユーザーを作成し、組み込みの readonly ロールを付与します。Wazuhダッシュボードの Server management → Security → Users から、または POST /security/users と POST /security/users/{user_id}/roles で作成できます。
3. そのユーザー名を WAZUH_USERNAME に、パスワードを WAZUH_PASSWORD に設定します。コネクターはこれらでサインインし、セッショントークンも自動で更新します(Wazuhのトークンはデフォルトで900秒有効です)。
4. コネクターをインストールして wazuh_get_manager_info を実行します。マネージャーのバージョンが返れば、アドレスとサインインが正しく機能しています。

読み取り専用: すべてのツールはGETリクエストです。コネクターは、何かを再起動したり、Active Responseを実行したり、エージェントを追加、削除、アップグレードしたり、ルール、デコーダー、ユーザー、設定を編集したりすることはできません。readonly ロールには、必要なすべての権限(manager:read、agent:read、rules:read、decoders:read、sca:read、syscheck:read)が含まれています。

読み取る内容: マネージャーとAPIのバージョン、および各マネージャーデーモンの状態。ステータス、IP、OS、バージョン、グループ、最後のkeep-aliveを含むエージェント情報、ステータス別の件数(wazuh_get_agents_summary)、OSプラットフォーム、マネージャーより古いエージェント。レベル、グループ、コンプライアンスマッピング(PCI DSS、GDPR、HIPAA、NIST 800-53、TSC)、MITRE idで絞り込めるルールセットとデコーダー。エージェントごとのSecurity Configuration Assessment(CISベンチマーク)のポリシーと失敗したチェック(根拠と修復方法付き)。エージェントごとのFile Integrity Monitoring(syscheck)のファイル、ハッシュ、最後のスキャン。エージェントidは3桁以上です(001)。000 はマネージャー自身です。

証明書: Wazuhはポート55000に自己署名証明書をインストールしますが、自己署名証明書では接続に失敗します。コネクターには、あらゆる証明書を信頼するスイッチはありません。WAZUH_URL と名前が一致する証明書をAPIに設定する(Wazuhの api.yaml の https.cert と https.key)、有効な証明書を持つリバースプロキシを手前に置く、またはセルフホストの場合は、社内CAを指す NODE_EXTRA_CA_CERTS を指定してAnythingMCPを起動してください。

Wazuhの稼働場所: セルフホストのAnythingMCPで、プライベートアドレス(https://10.0.0.5:55000、https://wazuh.intern:55000)上のWazuhを使う場合は、管理者が SSRF_ALLOWED_HOSTS または管理設定のアローリストにそのホストを許可する必要があります。AnythingMCP Cloudが到達できるのは、公開インターネット上にHTTPSで公開され、公的に信頼された証明書を持つWazuh APIのみです。

プライバシー: エージェント名、IPアドレス、オペレーティングシステム、ファイルパス、ハッシュは、あなたのインフラの情報です。これらを閲覧してよいユーザーのMCPサーバーにのみ、コネクターを割り当ててください。

制限: 一覧ツールはデフォルトで50件を返し、1回の呼び出しで最大500件です。Wazuhはデフォルトで1分あたり300リクエストまで許可し、それを超えると429を返します。また、デフォルトでは5分以内に50回ログインに失敗すると、そのアドレスが300秒間ブロックされます。

よくあるエラー: 401 "Invalid credentials" は、WAZUH_USERNAME または WAZUH_PASSWORD が誤っていることを意味します。403は、APIユーザーに読み取り権限がないことを意味します。readonly ロールを付与してください。すべての呼び出しで404になる場合は、WAZUH_URL がサーバーAPIではなくダッシュボードまたはインデクサーを指しています。"Agent does not exist"(Wazuhエラー1701)は、そのidのエージェントが存在しないことを意味します。400 "There is no database for agent" は、エージェントが一度も接続しておらず、SCAやFIMのデータがまだないことを意味します。"self-signed certificate" や "unable to verify the first certificate" は、上記の証明書の問題です。

このコネクターは、アラートとイベント、脆弱性検出の結果(これらはこのAPIではなくWazuhインデクサーにあります)を読み取らず、何も書き込まず、クラスター設定も対象外です。また、これらのエンドポイントのほとんどが削除されたWazuh 5.xにも対応していません。

ステップ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 — Geminiにコネクターを追加する

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう — Gemini CLI が Wazuh のツールを呼び出せるようになりました。

利用可能なツール

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクターのランディングページ
• Claudeに接続する
• ChatGPTに接続する