For the complete documentation index, see llms.txt. This page is also available as Markdown.

Aikido MCPの使用

Aikido MCPサーバーが公開するツールと、エージェントにそれらを使わせるためのプロンプト例。

MCPサーバーがインストールされたら、これらのツールを自分で呼び出す必要はありません。平易な言葉で依頼すると、エージェントが適切なものを選びます。

利用可能なツール

aikido_scan_paths

ディスク上に保存されているファイルを脆弱性(SAST)、ハードコードされた秘密情報、IaCの設定ミスについてスキャンします。これが推奨のスキャンツールです。

  • 必要に応じて渡す repository_name ファイルがリポジトリ由来の場合に指定すると、Aikido内でそのリポジトリに関連付けられます

aikido_full_scan

コードがまだディスク上にないケース、つまり生成されたが未保存のコード、貼り付けられたスニペット、または提案された変更について、ファイル内容として渡されたコードをスキャンします。 aikido_scan_paths ファイルが実際にディスク上に存在する場合は、こちらを使用してください。

  • 各ファイルを files_to_scan として relativeFilePath とその content

aikido_oss_dependency_scan

ディスク上に保存されている依存関係マニフェストとロックファイルを脆弱性についてスキャンします。

  • 各ファイルを files_to_scan として relativeFilePath とその content

aikido_issues_list

Aikidoフィードからセキュリティ問題を取得します。

  • スコープで絞り込み: repo_name, cloud_name, vm_name, domain_name, container_name, workspace_name または team_name

  • 必要に応じて、 repo_branch_name

  • 1つ以上の問題タイプを選択: sast, leaked_secret, iac, open_source, cloud, cloud_instance, docker_container, malware, eol, mobile, surface_monitoring, scm_security, license, ai_pentest, ai_code_analysis

  • で絞り込み labels 指定されたラベルのいずれかを持つリポジトリまたはコンテナイメージ上の問題のみを返すようにする

  • で絞り込み severity 特定の重大度以上の問題のみを返すようにする

  • で結果をページ分割して取得 ページ (0始まり)

  • 以下のフィルターを選んでSLAで絞り込みます: out_of_sla または sla_due_soon

  • 各問題のタイトル、タイプ、重大度、および修復手順を返します

単一の問題を参照する

渡す issue_id を渡すと、1件の問題の詳細を取得します。リスト表示よりも多くの情報が返ります:

  • score_reasons:その問題がその重大度になったすべての理由。それぞれに読みやすい説明とスコアをどれだけ動かしたかが含まれます。たとえば、実際に確認されている既知のエクスプロイトなどです

  • pentest:AIペンテストの検出結果では、概要、リスク、再現手順、根本原因、修復を含む攻撃分析

  • licenses:ライセンス問題では、検出されたライセンス、その法的リスク、そして理由

aikido_ignore_issue

フィード内のセキュリティ問題を無視します。 issue_id と reason.

aikido_login

Aikidoのサインインフローを開始します。サインインURLを返すか、すでにサインイン済みであることを確認します。

  • サインインすると、アカウントのリージョンに自動的にリダイレクトされます。間違ったリージョンに着いた場合にのみ region (eu, us, me, au)を設定してください

  • 使用 force_reauth を使うと、アカウントを切り替えたり、再度サインインしたりできます

すべてのMCPツールがデフォルトで有効になっているわけではありません。管理者は 権限ページ ですべての人向けに有効化できます

プロンプト例

コードのスキャン

  • 「このファイルをAikidoでセキュリティ問題がないかスキャンして」

  • 「コミットする前に、ステージ済みの変更をAikidoでスキャンして秘密情報をチェックして」

  • 「今編集したファイルをAikidoでスキャンして、 payments-api リポジトリに関連付けて」

リポジトリ別に問題を確認する

  • 「 payments-api"

  • 「Aikidoで漏えいした秘密情報を一覧表示して frontend-web 」

  • 「Aikidoが見つけたオープンソースの脆弱性は api-gateway?"

  • 「SASTとIaCの問題を表示して infra-core 」

クラウド、VM、コンテナ別に問題を確認する

  • 「Aikidoのクラウド問題をすべて一覧表示して prod-aws"

  • 「マルウェアの検出結果を web-server-01 」

  • で実行されているEOLソフトウェアは何? nginx-proxy コンテナについて、Aikidoによると?」

  • 「 example.com のサーフェス監視の問題をAikidoで表示して」

1つの問題を掘り下げる

  • 「Aikidoの問題の詳細をすべて教えて 12345"

  • 「Aikidoの問題 12345 が重大と判定されたのはなぜ?既知のエクスプロイトはありますか?」

  • 「Aikidoのペンテスト検出結果の再現手順を順を追って説明して 12345"

組み合わせワークフロー

  • 「Aikidoで現在の変更をスキャンし、同じリポジトリ内の既存の重大な問題も表示して」

  • 「AikidoでこのPRをチェックし、リポジトリ内の未解決のSAST問題と比較して」

スキャンを実行するタイミングの制御

Aikidoがスキャンのタイミングを決めるわけではありません。決めるのはあなたのエージェントです。スキャンは、エージェントが aikido_scan_paths.

を呼び出したときに実行されます。したがって、スキャンについてエージェントに伝えたことはすぐに、そのセッションの残りの間に反映されます。

スキャンを一時停止する

  • 「私がスキャンを求めるまで、Aikidoのスキャンは実行しないで」

  • 「この作業を進めている間はAikidoのスキャンを一時停止して」

  • 「とりあえずAikidoスキャンはスキップして。コミット前に必要になったら依頼する」

最後に1回だけスキャンする

  • 「各編集のたびにスキャンしないで。作業全体が終わったらAikidoスキャンを1回実行して」

  • 「コミット直前に、Aikidoでステージ済みの変更をスキャンして。それ以前はしないで」

スキャンを小さく保つ

スキャン時間は投入されるコード量に比例するので、スコープを絞るほうが、スキャンをオフにするよりたいてい速いです。

  • 「変更したファイルだけをスキャンして、ディレクトリ全体はスキャンしないで」

  • 「 src/payments/ だけをスキャンして」

  • を aikido_scan_paths より aikido_full_scan優先してください。会話でその内容を渡すのではなく、ディスクからファイルを読み込みます。

デフォルトにする

プロンプト指示は1セッション限りです。すべてのセッションでのデフォルトを変更するには、同じ指示をエージェントのルールファイル(CLAUDE.md, .cursor/rules, AGENTS.mdなど)に入れてください:

最終更新

役に立ちましたか?