> 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/ai-and-dev-tools/aikido-mcp/jetbrains-ai.md).

# Jetbrains AI / Junie MCP

The Aikido MCP Plugin connects Aikido’s security engine to AI coding tools. It automatically scans AI generated code for vulnerabilities and hardcoded secrets as soon as it is created.

AI assistants can review their own output, but that review is not perfect. Aikido adds a reliable and consistent security layer that checks every generated snippet with proven scanning rules.

**Why use Aikido MCP**

* Deterministic, independent security checks on every AI generated snippet before it is committed
* Immediate detection and remediation of vulnerabilities and hardcoded secrets in AI assisted workflows
* Real time feedback, making AI driven development safer by default

## Installation

{% stepper %}
{% step %}
**Add Aikido MCP server to your Jetbrains IDE config**

In your IDE go to Settings | Tools | AI Assistant | Model Context Protocol (MCP).

{% hint style="info" %}
[Check out Jetbrains documentation for more information](https://www.jetbrains.com/help/ai-assistant/mcp.html)
{% endhint %}

On the Model Context Protocol (MCP) settings page, click ![](https://resources.jetbrains.com/help/img/idea/2025.3/app-client.expui.general.add.svg) Add to add a new MCP server configuration.

In the New MCP Server dialog, select how you want to connect to the MCP server and provide a JSON configuration:

```shellscript
{
  "mcpServers": {
    "aikido": {
      "command": "npx -y @aikidosec/mcp@latest",
      "args": [],
      "environment": {}
    }
  }
}
```

{% endstep %}

{% step %}
**Authenticate**

On first use, ask the AI assistant to run `aikido_login`. It will return a browser link, follow it to log in to Aikido. Your token is stored securely once login is complete.
{% endstep %}

{% step %}
Adapt your agent instructions to use the Aikido MCP by adding the following skill or instructions.

```
---
name: aikido-security
description: Enforce mandatory security scanning for all code changes
license: MIT
compatibility: opencode
metadata:
  audience: developers
  security: aikido
---

## Purpose

Ensure that all first-party code is scanned for security issues whenever code is written or changed.

## Rules

- Always run **aikido_scan_paths** on all newly written, generated, added, or modified first-party code.
- Pass the file paths to the scanner. Only use **aikido_full_scan** when the code is not saved to disk yet.
- If any security issues are reported, apply the fixes using the remediation guidance from Aikido.
- Run **aikido_scan_paths** again after fixes to confirm that no issues remain and no new ones were introduced.
- Repeat the fix and rescan cycle until the scan passes with zero issues.
- If the Aikido MCP server is not installed or not running, inform the user to install it using the official setup guide at  
  https://help.aikido.dev/ide-plugins/aikido-mcp
```

{% endstep %}

{% step %}
**Finished**

Aikido MCP is now available in Jetbrains IDE
{% endstep %}
{% endstepper %}

{% hint style="info" %}
For CI/CD or headless setups where browser login is not possible, see [Token Authentication](/ai-and-dev-tools/aikido-mcp/token-authentication.md).
{% endhint %}

For the full list of tools the MCP server exposes, see [Available tools](/ai-and-dev-tools/aikido-mcp/using-aikido-mcp.md#available-tools). For ways to ask your agent to use Aikido, see [Example prompts](/ai-and-dev-tools/aikido-mcp/using-aikido-mcp.md#example-prompts).


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.aikido.dev/ai-and-dev-tools/aikido-mcp/jetbrains-ai.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
