> For the complete documentation index, see [llms.txt](https://help.aikido.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aikido.dev/docs/docs-ja/ai-totsru/aikido-mcp/using-aikido-mcp.md).

# Aikido MCPの使用

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

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

## 利用可能なツール

### aikido\_scan\_paths

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

* スキャンするファイルを指定してください `パス`、ルートに対する絶対パスまたは相対パス `ルート`。ディレクトリは受け付けられないため、各ファイルを列挙してください
* 次の項目を設定します： `ルート` ワークスペースまたはリポジトリのルートに対して指定してください。そうすると、検出結果はその基準で報告されます。存在しないパスやその外側にあるパスは `ルート` スキップされ、次に一覧表示されます `skipped_paths`
* 必要に応じて渡す `repository_name` ファイルがリポジトリ由来の場合に指定すると、Aikido内でそのリポジトリに関連付けられます

### aikido\_full\_scan

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

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

### aikido\_oss\_dependency\_scan

ディスクに保存された依存関係のマニフェストとロックファイルをスキャンし、脆弱、古い、または悪意のあるパッケージを検出します。

* スキャンするマニフェストとロックファイルを指定してください。基準は `パス`、たとえば `package.json` と `package-lock.json`, `requirements.txt`, `go.mod` と `go.sum`、または `pom.xml`。ディレクトリは受け付けられません
* 次の項目を設定します： `ルート` ワークスペースまたはリポジトリのルートに対して指定してください。そうすると、検出結果はその基準で報告されます
* 必要に応じて渡す `repository_name` リポジトリ由来のファイルの場合

### 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\_workspaces\_list

アクセス可能な Aikido ワークスペースを一覧表示します。エージェントはこれを使って、課題を絞り込む前に正確なワークスペース名を見つけます。 `workspace_name`.

### aikido\_ignore\_issue

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

### aikido\_unignore\_issue

以前に無視した課題の無視を解除します。必要です `issue_id` と `reason`.

### aikido\_snooze\_issue

フィード内のセキュリティ問題を一時的に非表示にします。必要です `issue_id`、 `reason` と `duration`: `1_day`, `1_week`, `1_month`, `3_months`, `6_months` または `1_year`.

### aikido\_unsnooze\_issue

以前にスヌーズした課題のスヌーズを解除します。必要です `issue_id`.

### aikido\_adjust\_issue\_severity

セキュリティ問題の重大度を上げたり下げたりします。必要です `issue_id`、新しい `adjusted_severity` (`critical`, `high`, `medium` または `low`）と `reason`.

### aikido\_login

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

* サインインすると、アカウントのリージョンに自動的にリダイレクトされます。間違ったリージョンに着いた場合にのみ `region` (`eu`, `us`, `me`, `au`）を設定してください
* 使用 `force_reauth` を使うと、アカウントを切り替えたり、再度サインインしたりできます

{% hint style="info" %}
すべてのMCPツールがデフォルトで有効になっているわけではありません。管理者は [権限ページ](https://app.aikido.dev/settings/integrations/ide/mcp/permissions) ですべての人向けに有効化できます
{% endhint %}

## プロンプト例

### コードのスキャン

* 「このファイルを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 の課題をスヌーズする `12345` 1か月間、次のリリースで修正します」
* 「Aikido の課題の重大度を下げる `12345` を low にしてください。エンドポイントは内部専用です」
* 「Aikido の課題の無視を解除する `12345`。緩和策が削除されました」
* 「どの Aikido ワークスペースにアクセスできますか？」

### 組み合わせワークフロー

* 「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`など）に入れてください:

```
Aikidoスキャンは、明示的に依頼されたときか、コミット前にのみ実行してください。
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.aikido.dev/docs/docs-ja/ai-totsru/aikido-mcp/using-aikido-mcp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.