# Github Copilot


Aikido MCP Pluginは、AikidoのセキュリティエンジンをAIコーディングツールに接続します。AIが生成したコードを、作成された時点で脆弱性やハードコードされたシークレットについて自動的にスキャンします。

AIアシスタントは自らの出力をレビューできますが、そのレビューは完璧ではありません。Aikidoは、実績のあるスキャンルールで生成されたすべてのスニペットをチェックする、信頼性が高く一貫したセキュリティレイヤーを追加します。

**Aikido MCPを使用する理由**

* AIが生成したすべてのスニペットに対し、コミット前に決定論的かつ独立したセキュリティチェックを実施
* AI支援ワークフローにおける脆弱性やハードコードされたシークレットを即座に検出・修正
* リアルタイムのフィードバックにより、AI駆動の開発をデフォルトでより安全に

MCP サーバーが提供するツールの一覧については、[利用可能なツール](https://help.aikidogov.us/docs/docs-ja/ai-and-dev-tools/aikido-mcp/using-aikido-mcp#available-tools)を参照してください。

## インストール

### IDE

Aikido VSCode IDE プラグインは、[Expansion Packs](https://help.aikidogov.us/docs/docs-ja/ai-and-dev-tools/ide-plugins-overview/features/aikido-expansion-packs) を使用して追加機能を提供します。Github Copilot 向けの Aikido MCP はこれらの Expansion Packs の 1 つであり、個別のセットアップ手順なしで簡単かつ迅速にインストールできます。有効化の手順については、以下のリンク先ページを参照してください。

{% content-ref url="../ide-plugins-overview/vs-code-plugin.md" %}
[vs-code-plugin.md](https://help.aikidogov.us/docs/docs-ja/ai-and-dev-tools/ide-plugins-overview/vs-code-plugin)
{% endcontent-ref %}

### Copilot IDE プラグインとの統合

{% stepper %}
{% step %}
**IDE の設定に MCP 構成を追加する**

Github Copilot プラグインの設定に移動し、`mcp.json` ファイルを開きます。Aikido サーバーを追加します：

```json
{
  "servers": {
    "aikido": {
      "command": "npx",
      "args": ["-y", "@aikidosec/mcp@latest"]
    }
  }
}
```
{% endstep %}

{% step %}
**認証する**

初回使用時に、Copilot に `aikido_login` を実行するよう依頼します。ブラウザ用のリンクが返されるので、そのリンクから Aikido にログインします。ログインが完了すると、トークンは安全に保存されます。
{% endstep %}

{% step %}
**カスタムプロンプト指示を追加する**

`AGENTS.md` ファイルまたはカスタム指示に、エージェントが新しいツールを使用するよう指示を追加します。

```
Scan any new or modified code with `aikido_scan_paths` before finalizing changes. This security check is required.
```
{% endstep %}
{% endstepper %}

{% hint style="info" %}
ブラウザでのログインができない CI/CD やヘッドレス環境については、[トークン認証](https://help.aikidogov.us/docs/docs-ja/ai-and-dev-tools/aikido-mcp/token-authentication)を参照してください。
{% endhint %}

### Copilot Cloud Agents との統合

GitHub Copilot coding agent は、実行中に MCP サーバーのツールを呼び出すことができます。以下の手順に従って、リポジトリに Aikido MCP をセットアップしてください。構成はリポジトリごとに行います。

{% hint style="warning" %}
Copilot Cloud Agents はヘッドレス環境で実行され、ブラウザベースのログインが利用できないため、トークンが必要です。Aikido の Personal Access Token が必要になります。作成方法については[トークン認証](https://help.aikidogov.us/docs/docs-ja/ai-and-dev-tools/aikido-mcp/token-authentication)を参照してください。
{% endhint %}

すでに VS Code で Aikido MCP を使用している場合は、[その構成を再利用](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp#reusing-your-mcp-configuration-from-visual-studio-code)し、リポジトリ設定にトークンを追加するだけで済みます。

#### セットアップ手順

{% hint style="info" %}
GitHub での一連の手順（JSON の貼り付け場所、検証の仕組み、Copilot 環境でのシークレットの公開方法）については、[GitHub のガイドを参照してください](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp)。
{% endhint %}

{% stepper %}
{% step %}
**リポジトリ設定に MCP 構成を追加する**

GitHub リポジトリで、Settings → Copilot → Coding agent に移動し、MCP の JSON 構成を貼り付けます。

Aikido MCP の構成例（npx によるローカル/stdio）：

{% tabs %}
{% tab title="Copilot Cloud Agent" %}
```json
{
  "mcpServers": {
    "aikido": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@aikidosec/mcp@latest"],
      "tools": ["aikido_scan_paths", "aikido_full_scan"],
      "env": {
        "AIKIDO_API_KEY": "COPILOT_MCP_AIKIDO_API_KEY"
      }
    }
  }
}
```
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}
**Copilot 環境にトークンを追加する**

Github Copilot は、名前が `COPILOT_MCP_` で始まるシークレット/変数のみを MCP 構成に公開します。

次のようなシークレットを作成します：

`COPILOT_MCP_AIKIDO_API_KEY` = Aikido のトークン
{% endstep %}

{% step %}
**カスタムプロンプト指示を追加する**

GitHub Copilot が MCP サーバーを確実に使用するように、[GitHub のガイドに記載されている](https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions)とおりにリポジトリの指示を構成します。

次のような指示を追加します：

```
Scan any new or modified code with `aikido_scan_paths` before finalizing changes. This security check is required.
```
{% endstep %}

{% step %}
**検証する**

Copilot にファイルの 1 つをセキュリティスキャンするよう依頼して、[構成を検証](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp#validating-your-mcp-configuration)できます。
{% endstep %}
{% endstepper %}

エージェントに Aikido を使用させる依頼の仕方については、[プロンプト例](https://help.aikidogov.us/docs/docs-ja/ai-and-dev-tools/aikido-mcp/using-aikido-mcp#example-prompts)を参照してください。