なぜ

コーディングエージェントは、実際に役立つテスターになりつつあります。シェルを持ち、あなたと同じツールを実行し、素早く範囲をカバーします。ターゲットに向けると、何かを見つけ出します。

しかし、コンテキストウィンドウがいっぱいになると、エンゲージメントは消えてしまいます。次のセッションでは、すでにクリアしたホストを再スキャンし、すでに除外したものを再テストし、スコープのどの部分に触れたかを教えてくれません。トランスクリプトのどこかに、誰も記録しなかった確認済みの SQL インジェクションがあります。

Red Clippy は、エージェントに単独では持っていない 2 つのものを与えることで、これを修正します。

作業を置く場所。 すべてのアセット、観察結果、チェック、findings は、スクロールバックバッファではなく、テストが行われるときにデータベースに保存されます。カバレッジは記憶ではなくクエリになります: どのアセットが存在するか、各アセットでどのチェックがクリアされているか、すでに報告されたものは何か。明日のセッションは、前回のセッションが終了した正確な場所から再開します。

従うべきルール。 Red Team Instructions ドキュメントは、何かを行う前に、MCP ハンドシェイクでエージェントに届きます: 報告する前に検証し、すべての主張を証明し、影響を示すために必要な最小限のアクセス権を取得し、サードパーティのシステムには触れない。チームやクライアントによってハウスルールが異なるため、組織ごと、エンゲージメントごとに上書きできます。

あなたは常にループ内に留まります。エージェントが書き込むすべてのものは、Web UI の通常の行であり、レビュー、修正、再分類、破棄が可能です。

[!CAUTION] 認可されたテストのみ。 Red Clippy は、エンゲージメントの下で作業するペネトレーションテスター向けです。所有しているシステム、または明示的な書面による許可を得て評価するシステムのみをテストしてください。スコープのマーキングと Red Team Instructions は、エージェントをエンゲージメントのルール内に保つために存在しますが、これらはガードレールであり、認可ではありません。エージェントはあなたの権限で行動し、エージェントが行うすべてのことに対してあなたが責任を負います。

クイックスタート

最新リリース からバイナリをダウンロードして実行します。データベースをセットアップし、127.0.0.1:7337 でパネルを提供します。

Linux

Windows

アーカイブを解凍し、そのフォルダから:

http://127.0.0.1:7337 を開くと、セットアップウィザードが引き継ぎます。

データベースは、バイナリを実行したディレクトリに作成されます。アップロードされたエビデンスも、red-clippy-storage に保存されます。どちらのパスも設定ファイルで変更できます。設定 を参照してください。

自分でコンパイルしたいですか? ソースからのビルド を参照してください。

データの構成

Red Clippy は作業を 組織 にグループ化します。組織はペンテストを保持し、各ペンテストはそのエンゲージメントのアセット、findings、エビデンスを保持します。1 つの会社をテストする場合、単一の組織で十分です。複数のクライアントにコンサルティングする場合は、各クライアントに独自の組織を与えてください: 組織は他の組織のものを一切見ることができないため、エンゲージメントが混ざることはありません。

組織には 2 つの名前があります。表示名 ("Acme Corp") はパネルに表示されるもので、後で変更できます。スラッグ (acme) は、ディスク上のエビデンスフォルダ (red-clippy-storage/org_acme/pentest_PT-2026-08-27/) で使用される短い小文字の識別子であるため、設定すると固定されます。

複数の組織に所属し、アバターメニューから切り替えることができます。各組織では、人を追加・削除したり、組織の名前を変更・削除したりできる オーナー か、エンゲージメントを実行する メンバー のいずれかになります。

初回実行

初回起動時、データベースは空なので、ブラウザにはログインフォームの代わりに セットアップウィザード が表示されます。次のものを求められます:

• 最初の組織のスラッグと表示名
• ユーザー名、およびオプションでメールアドレス
• パスワード (最小 8 文字)

作成されるアカウントは、その組織のオーナーです。ウィザードはデータベースにユーザーがいない間のみ表示され、最初のアカウントが存在すると恒久的に無効になるため、後で追加のアカウントを作成するために使用することはできません。

セットアップ後、アプリ内の アバターメニュー > 組織 で組織とチームメイトを管理します。

誰もサインインできない場合、CLI が復旧手段です:

使用方法

想定されるフローはエージェント駆動です。エンゲージメントをセットアップし、記録を保持しながら Claude Code でターゲットを進めます。

あなたがセットアップ:

1. ペンテストを作成します。 コード、スコープ、日付。方法論チェックリストは自動的にシードされます。
2. スコープを定義します。 テストを許可されているドメイン、ホスト、IP レンジを追加し、明示的にスコープ外のものをマークします。自分で入力するか、クライアントのスコープリストをエージェントに貼り付けて入力させることもできます。
3. エージェントを MCP 経由で接続し、このエンゲージメントに固定します (下記参照)。

エージェントは作業し、進めながら記録します:

• 通常どおり、独自のシェルから偵察およびテストツールを実行します。
• ingest_tool_output で生のスキャナー出力を渡すか、アセットと観察結果を直接書き込みます。
• 実際のスコープユニットをアセットに昇格させ、残りは観察結果として残します。
• クリアした方法論チェックをマークします。
• CVSS、PoC、エビデンスを添付して findings を提出します。

あなたが監督:

• ブラウザでリアルタイムに表示されるのを確認します。
• 何でも修正します: エージェントが書き込んだすべての行は、編集、再分類、削除できる通常のレコードです。
• カバレッジビューでまだ触れられていないものを確認します。
• クロスエンゲージメントダッシュボードでレビューします。組織内のすべての findings と、その由来となったペンテストが表示されます。

エージェントはオプションです。パネルと同じ API を介して動作するため、エージェントが記録するものはすべて、ブラウザで自分で入力、修正、削除することもできます。エンゲージメントを完全に手動で実行するか、完全にエージェント経由で実行するか、または進行に応じて 2 つを切り替えることができます。

AI エージェントの接続 (MCP)

これは Red Clippy が使用されることを意図している主な方法です。

red-clippy mcp はアプリケーション全体をカバーします: スコープとアセット、観察結果、方法論のカバレッジ、findings、エビデンス、攻撃グラフ、ツール出力の取り込み。接続されたエージェントは、それについて質問に答えるだけでなく、エンゲージメントを実行します。

接続時に、サーバーは MCP ハンドシェイクで Red Team Instructions ドキュメント (テスト中の動作方法に関する運用ドクトリン) をクライアントに渡すため、最初のツール呼び出しの前にエージェントのコンテキストに入ります。これは、エンゲージメントごとの上書き、組織のデフォルト、組み込みドキュメントの順に、最も具体的なものから解決されます。組織のデフォルトは 設定 > Red Team Instructions で編集するか、ペンテストの設定ページからエンゲージメントごとの上書きを設定します。get_instructions はオンデマンドで再読み取りします。

API キーの作成

設定 > API キー で発行します。その下の MCP に接続 セクションには、そのキー、このサーバーの URL、バイナリ自体のパスがすでに入力された、各クライアント用の貼り付け可能な設定が表示されます。手動で置き換えるものはありません。

代わりに CLI からキーを作成し、スニペットに自分で貼り付けるには:

Claude Code

add の後の名前は、Claude Code が表示するラベルにすぎません。-- の後のコマンドが実際に起動するものなので、バイナリのフルパスを使用してください: Claude Code は必ずしも PATH で red-clippy を見つけられるとは限りません。パネルの MCP に接続 からコマンドをコピーすると、正しいパスがすでに入力されています。

z.ai GLM

z.ai は Anthropic 互換のエンドポイントを提供するため、Claude Code は Anthropic モデルの代わりに GLM で Red Clippy を駆動できます。

これを Claude Code の設定に追加します: 作業フォルダ内の .claude/settings.local.json は 1 つのエンゲージメントにスコープし、~/.claude/settings.json はすべての場所に適用します。

置き換えるべき 2 つのもの:

• your-z-ai-api-key を自分のキーに置き換えます。Claude Code が git から除外するプロジェクトローカルの .claude/settings.local.json を優先して使用し、キーがコミットされないようにします。
• glm-5.3 を z.ai が現在提供しているモデルに置き換えます。モデル名は変更されるため、z.ai の Claude Code ガイド で現在のものを確認し、すべてのエントリをそれに設定します。

次に、上記とまったく同じように MCP サーバーを追加します。Red Clippy はモデルの選択の影響を受けません: MCP はクライアント側で実行されるため、エージェントの背後にあるモデルに関係なく、ツールは同じように動作します。

OpenAI Codex CLI

Codex CLI 設定に従い、~/.codex/config.toml で:

その他の MCP クライアント

red-clippy mcp はプレーンな JSON-RPC 2.0 stdio サーバーです。環境に 2 つのものが必要で、オプションのエンゲージメントピンを受け取ります:

--pentest はセッションを 1 つのエンゲージメントにバインドするため、エージェントは毎回呼び出しで名前を指定する必要がありません。アクティブなエンゲージメントごとに 1 つの MCP エントリを実行し、サーバーを切り替えてエンゲージメントを切り替えます。

接続したら、次のように尋ねるだけです: "PT-2026-Q2-ACME に finding を追加: /search の reflected XSS、高深刻度、PoC はこちら"。

[!NOTE] エージェントと red-clippy serve は同じマシンで実行されるため、RED_CLIPPY_URL は 127.0.0.1 を指します。

機能

完全な MCP ツールサーフェス。 Web UI とほぼ完全なパリティであり、トークンのサブセットではありません。エージェントは、アセットの作成とスコープ設定、観察結果の添付、方法論チェックのマーク、findings の提出と更新、エビデンスのアップロード、グラフエッジの構築、組織全体の検索を行うことができます。

クリーンな状態を保つスコープ。 アセットは実際にテストするユニットです: ドメイン、ホスト、URL、API、モバイルパッケージ、IP レンジ。それぞれに独自のチェックリスト、到達可能性マーキング、スコープ内/外フラグがあります。偵察ノイズ (発見されたパス、テクノロジーフィンガープリント、証明書、wayback URL) は、スコープリストに入るのではなく、アセットに 観察結果 として添付され、それに値する場合にのみアセットに昇格します。この分割がないと、単一のコンテンツディスカバリ実行でアセットリストが使用できなくなります。

レポートまでの findings。 深刻度、フォームに組み込まれた計算機付き CVSS 3.1、CWE/CVE、PoC、修復策、ファイルエビデンス。クロスエンゲージメントダッシュボードには、組織内のすべての findings がソースのペンテストとともにリストされます。これは再テストが必要とするビューです。

クエリ可能なカバレッジ。 OWASP WSTG にマッピングされた 135 の組み込みチェックに加え、偵察、ネットワーク、クラウド、OSINT チェック。ロールアップは、アセットごと、エンゲージメントごとにテストされたものを報告するため、クリアされた領域が再テストされることはありません。

運用ドクトリン。 Red Team Instructions ドキュメント。MCP 経由で提供され、エンゲージメントごと、組織ごと、組み込みデフォルトの順に解決されます。

ツール出力の取り込み。 生のスキャナー出力は単一の呼び出しで送信されます。これは、エージェントが結果を独自のシェルからレコードに移動する方法です。nmap、burp、nessus、openvas、masscan、naabu、subfinder 用のパーサーと、形式の自動検出。findings、偵察、生の出力は、1 つのトランザクションで一緒に保存されます。

攻撃グラフ。 任意の 2 つのノードを自由形式の関係でリンクし、隣接ノードをトラバースするか、それらの間の最短攻撃パスを計算します。

マルチテナント。 すべてのレコードは組織に属します。1 人のユーザーは複数の組織に所属でき、サインアウトせずに切り替えることができるため、クライアントデータは分離されたままになります。

REST API。 組織スコープのベアラーキー、上記のすべてと同じサーフェス。

オプション: 組み込みのスキャンランナー。 Scanning ページから subfinder、nmap、masscan、naabu を駆動するための便利な機能で、ターゲットごとの再開可能なカバレッジを備えています。これは手動オペレーターの使用のために存在し、エージェントが独自のツールを実行して出力を取り込む通常のエージェント駆動ワークフローの一部ではありません。

ドキュメント は、MCP ツールリファレンス、REST API、データモデルを含め、これを画面ごとにカバーしています。この README は、起動と実行についてカバーしています。

設定

設定は TOML ファイルから取得されます。red-clippy serve はデフォルトで ./red-clippy.toml を読み取ります。例をコピーして編集します:

すべてのフィールドは、CLI フラグまたは環境変数でも設定できます。優先順位は、フィールドごとに CLI フラグ > 環境変数 > TOML > 組み込みデフォルト です。

ファイルのみの設定が 2 つあります:

• frontend_dist はビルド済みの SPA を上書きします。リリースバイナリはそれを埋め込むため、通常は未設定です。再コンパイルせずにパッチ適用済みバンドルを提供するには、ディレクトリを指定します。
• local_open は、Files ページの「ファイルマネージャーで表示」ボタンが サーバーを実行しているマシン上で xdg-open / open / explorer.exe をシェルアウトできるようにします。デフォルトではオフです。サーバーがログインしたグラフィカルセッション内の自分のデスクトップである場合にのみオンにし、systemd の下やリモートで提供する場合は絶対にオンにしないでください。

認識されないキーは無視されるのではなく、エラーで起動を停止するため、タイプミスが静かにデフォルトのままになることはありません。

ログフィルタリングは RUST_LOG を使用します (デフォルト info,sqlx=warn)。

完全なリストについては red-clippy serve --help を実行してください。

[!WARNING] ローカルで実行してください。 Red Clippy は 127.0.0.1 にバインドされ、それを駆動するエージェントの隣の自分のマシンで実行されることを意図しています。ネットワークやインターネットに公開するようには設計されていません。

CLI リファレンス

任意のサブコマンドに --help を追加してフラグを確認します。

REST API は /api/v1 の下にあり、Authorization: Bearer rcl_<prefix>_<secret> で認証します。キーは組織スコープであるため、URL に組織を取るエンドポイントはありません。アプリ内の ヘルプ ページにエンドポイントが文書化されています。

ソースからのビルド

Linux と macOS

make all は最初に Web UI をビルドし、そのバンドルを埋め込んでバイナリをコンパイルします。

[!NOTE] ビルド順序。 React バンドルはコンパイル時に埋め込まれます。 cargo build --release を単独で実行しても機能しますが、UI が一度もビルドされていない場合、バイナリはプレースホルダーページを提供します (cargo が警告を出力します)。 最初に make frontend を実行するか、単に make all を使用してください。

Windows

ネイティブビルド は rustup、MSVC ビルドツール、Node をインストールして行います:

または、Linux からクロスコンパイル は mingw-w64 ツールチェーン (apt install gcc-mingw-w64-x86-64) を使用します:

その単一の .exe を Windows ホストにコピーして実行します。他にインストールするものはありません。

開発

デバッグビルドは、埋め込む代わりに実行時にディスクから frontend/dist を読み取るため、Rust を再コンパイルせずに UI を再ビルドできます。

プルリクエストを開く前に、CI が実行するものを実行してください: cargo fmt --all --check、make clippy、make test、make lint、make frontend。 make install-hooks は、フォーマットと lint ゲートを pre-commit フックに配線します。パーサーの追加方法を含む完全なバージョンについては、CONTRIBUTING.md を参照してください。

リリースの作成

Cargo.toml の version を上げ、一致するタグをプッシュします:

CI は静的 Linux バイナリと Windows 実行可能ファイルをビルドし、チェックサム付きの GitHub リリースとして両方を公開します。タグはクレートのバージョンと一致する必要があります。そうしないとビルドが失敗します。公開せずにリハーサルするには、Actions タブから Release ワークフローを手動で実行します: アーカイブをワークフローアーティファクトとしてビルドしてアップロードし、リリースステップをスキップします。

コントリビューション

バグレポート、新しいツール用のパーサー、MCP カバレッジを歓迎します - CONTRIBUTING.md を参照してください。

セキュリティの問題を見つけましたか? 問題を開くのではなく、SECURITY.md を介して非公開で報告してください。

ライセンス

Copyright (C) 2026 Cyber Security & Privacy Foundation

GNU General Public License v3.0 の下でリリースされています。このプログラムには ABSOLUTELY NO WARRANTY が付属しています。詳細はライセンスを参照してください。