ドキュメント

MCPおよびチャットによるセキュリティ

検出結果を確認し、チャットやご自身のアシスタントから対応を実施できます。ポータルのルールに従い、一部の操作がなぜ常に人の判断を待つかも説明します。

セキュリティの検出結果を確認し、チャットアシスタントから、または ご自身のアシスタントを通じて対応を実施できます。CoRoidをMCPサーバーとして利用:Claude Code、Codex、 Cursor、またはその他のMCPクライアントです。これらのツールはポータルと同じルールに従うため、同じ回答を返し、同じ操作を拒否します。

読み取り

セキュリティには独自のスコープがあるため、他の用途で作成された接続では 検出結果が表示されません。これらのツールにはレビュー担当者の役割が必要であり、mcp.security.read。どのツールも承認は不要です。これらはCoRoidセキュリティの独自のルールに従い、ポータルで閲覧可能なプロジェクトのみが表示されます。特定のプロジェクトに限定された接続では、そのプロジェクトのいずれか、または該当する検出結果を指定する必要があります。

ツール返答内容
get_security_overviewプロジェクトごとに:重大度別の未解決検出結果、修正期限を過ぎたもの、誰も確認していないもの、テストコード、そしてあなたの対応が必要な件数
list_security_findingsプロジェクト、種類、重大度、ステータス別の検出結果。まずは悪用されたもの、次に重大度別に表示needsYouあなたの対応が必要なもののみを抽出
list_security_needs人が承認を待つ決定事項は、緊急度の高い順に並び、各々にCoRoidによる回答とそれを開くためのリンクが付属しています。この一覧は「セキュリティ」→「決定事項」と同じ内容です。
get_security_finding1件の検出結果:該当箇所、確認済みかどうか、期限、修正作業内容。機密情報の価値は決して表示されません
get_security_settings各プロジェクトの保護設定により適用されるチェック内容:無効、監視中、強制実行、または実行不可の理由、およびプロジェクトの設定内容
list_security_runsセキュリティの実行履歴を最新のものから表示:実行中、待機中、完了、失敗、または置き換えられたもの、および実行失敗の理由
get_attack_surface各プロジェクトのエントリーポイントと暴露を待つ件数。1つのプロジェクトについては、エントリーポイントごとのコード内容、関係者の決定事項、デプロイメントの提案、およびpull requestガードが検出した内容
get_threat_model各プロジェクトの脅威モデルバージョンとレビュー待ちの内容。1つのプロジェクトについては、モデル、待機中の提案、最新バージョン
list_security_packages各プロジェクトの最新の依存関係一覧とインストールされるパッケージ数、脆弱なパッケージ数。1つのプロジェクトについては、ページごとのパッケージ一覧、脆弱なものを優先して表示

すべての検出結果はCoRoid内の該当ページへリンクされています。

検出結果への対応

これらのツールは検出結果に対応します。必要なのはmcp.security.writeとオーナーまたは 管理者の権限です。これはポータルと同様です。

ツール実行内容承認
start_security_fixポータルと同様に修正作業を実施:脆弱な依存関係の修正、コード検出結果に対する回帰テストのタスク、漏洩した認証情報のローテーションチェックリスト。2回目の修正指示は既に登録済みのタスクに対応します。不可
run_security_scan現在、1つのプロジェクトをスキャン:有効な項目、依存関係、シークレット履歴、攻撃面、監査対象(有効な場合)、または保存された証拠不可
confirm_real_secret漏洩した認証情報が実際に存在するかを確認。誰かがローテーション済みと証明するまで開いたままになります。不可
revoke_security_exception例外を終了:検出結果が再び開かれます。不可
dismiss_security_finding検出結果を「問題なし」とマークし、理由を記載常に
add_security_exception指定日まで検出結果のリスクを許容し、理由を記載常に
attest_secret_rotated漏洩した認証情報がローテーションまたは無効化されたことを証明し、検出結果を閉じます。CoRoidは検出した認証情報をテストすることは決してありません。常に

攻撃面および脅威モデルへの対応

これらにもmcp.security.writeとオーナーまたは管理者の権限が必要です。ポータルで1つの制御が強化と弱体化の両方を担う場合、2つのツールが存在します。強化を担うツールは弱体化を招く変更を拒否するため、その変更は常に人の判断を待つことになります。

ツール実行内容承認
raise_entry_point_exposureエントリーポイントをより露出させる、監査のために固定する、またはスコープに再び含める不可
lower_entry_point_exposureエントリーポイントをより露出しにくくする、固定を解除する、または理由を記載してスコープから除外する常に
refresh_threat_modelプロジェクトのコードを再度読み取り、その結果を提案として保留不可
add_threat_model_entries脅威モデルにエントリを追加不可
accept_threat_model_proposalコードの新しい読み取り結果で提案された内容を承認不可
update_threat_model_entriesエントリのタイトルまたは詳細を変更常に
remove_threat_model_entries脅威モデルからエントリを削除常に
dismiss_threat_model_proposalコードの新しい読み取り結果で提案された内容を却下常に
keep_security_proof検出結果を再現する証拠を回帰テストとして保持不可

保護設定の変更

あるプロジェクトまたは組織のデフォルト設定における保護機能の設定は、以下の2つのツールで管理されます:tighten_security_protection保護機能を強化し、それを弱めるような変更を拒否します。また、relax_security_protection保護機能を弱めたり、プロジェクトが再び組織のデフォルト設定に従うようにしたりする場合、常に人の承認が必要です。検出や実施のレベルが下がったり、重大度の閾値が上がったり、修正用プルリクエストの作成数が減ったり、監査機能が無効化されたり実行頻度が低下したり、シークレットスキャンの対象範囲が狭まったり、サンドボックスネットワークの制限が緩和されたりホストの許可範囲が広がったり、あるいは「未設定」のエントリーポイントがインターネットに公開されるものとみなされなくなったりすると、保護機能は弱まります。「独自のスキャンコマンド」は品質管理機能で設定されます。

連絡先と情報公開

プロジェクトのセキュリティ連絡先は、オーナーや管理者に加えて情報公開の権限を有します。彼らは未公開の脆弱性に対してCoRoidが非公開で保持する修正内容を確認し、それらを公開または破棄したり、GitHubのセキュリティ勧告案を作成したり、依存ライブラリのメンテナーへの報告を記録したりします。MCPやチャットを通じたこれらの操作はオーナーや管理者のみが行え、どの操作も人の承認が必要です。連絡先は脆弱性情報を公開でき、一度公開された情報は取り消すことができません。

ツール機能概要承認
list_security_contactsプロジェクトのセキュリティ連絡先とその候補者いいえ
get_security_disclosure脆弱性の非公開修正内容(サイズとステータス、内容自体は含まれず)、GitHubの勧告内容、およびメンテナーへの報告内容。これらは情報公開権限を持つ者のみが確認できます。いいえ
add_security_contactプロジェクトメンバーをセキュリティ連絡先に設定する常に
remove_security_contactセキュリティ連絡先を削除する常に
publish_private_fix保留中の修正内容を公開する:脆弱性が公開され、タスクにpull requestが関連付けられます。常に
discard_private_fix保留中の修正内容を破棄する常に
draft_github_security_advisoryリポジトリ内にGitHubのセキュリティ勧告案をドラフトとして作成し、メンテナーに表示させる常に
record_maintainer_report脆弱性を依存ライブラリのメンテナーに報告した場所を記録する。CoRoidは何も送信しません。常に

一部の操作が人の承認を待つ理由

「問題なし」や「許容されるリスク」、ローテーションされた認証情報の場合、修正がなくても脆弱性が開放リストから除外されます。露出度が低いエントリーポイントや小規模な脅威モデルの場合も、監査の対象から外れます。アシスタントが単独でこれらの処理を行うことは許されないため、接続設定に関係なくこれらのツールは常に人の承認を待ちます。

  • MCPクライアントからの呼び出しでは、オーナーまたは管理者の承認を待ちます。 設定 → 接続 → CoRoid MCPサーバー → 承認、そして彼らに通知が届きます。リクエストの有効期限は10分です。
  • チャットでは、アシスタントが操作を実行する前にチャット内で確認を求めます。

承認内容には、CoRoidが保持する脆弱性に関する記録に基づき、何が起こるかが平易な言葉で記載されます。「『Shop』における不正なアクセス制御を『問題なし』とマーク」といった形式で、理由は引用符内に記載されます。理由を囲む言葉はCoRoidが生成し、アシスタントが作成したものではありません。また、認証情報の値は決して表示されません。CoRoidはそれを保持していないからです。src/routes/admin.ts:76(Shop) 「問題ありません」、続いて理由を引用符で示します。理由を囲む語句はCoRoidに由来し、アシスタントが作成するものではありません。また、認証情報の値は表示されません。CoRoidはその値を保持しません。