# JetBrains AI Assistant and Junie | User Guide | Shotomatic

> Add Shotomatic to JetBrains AI Assistant and Junie as a local MCP server, check that it works, and fix common setup problems.

- Type: Public web page
- Canonical page: [https://www.shotomatic.com/guide/ai-agents/clients/jetbrains](https://www.shotomatic.com/guide/ai-agents/clients/jetbrains)
- Markdown page: [https://www.shotomatic.com/guide/ai-agents/clients/jetbrains.md](https://www.shotomatic.com/guide/ai-agents/clients/jetbrains.md)

Browse the user guide

On this page

1.  [Before you start](#before-you-start)
2.  [Add Shotomatic to JetBrains AI Assistant and Junie](#add-shotomatic-to-jetbrains-ai-assistant-and-junie)
3.  [Approve it once](#approve-it-once)
4.  [Check that it works](#check-that-it-works)
5.  [If the tool is unavailable](#if-the-tool-is-unavailable)

JetBrains AI Assistant and Junie can use Shotomatic through Shotomatic's local MCP server. These steps follow JetBrains AI Assistant and Junie's own documentation ([AI Assistant MCP](https://www.jetbrains.com/help/ai-assistant/mcp.html) and [Junie CLI MCP configuration](https://junie.jetbrains.com/docs/junie-cli-mcp-configuration.html)); Shotomatic is tested with Claude Code and Codex, not with JetBrains AI Assistant and Junie. If a menu or file no longer matches, check JetBrains AI Assistant and Junie's docs.

## Before you start

-   In Shotomatic, open **Settings > AI agents** and turn on **Let AI agents use Shotomatic**.
-   Install Node 18.3 or later. The client starts a small bridge package named `shotomatic` with `npx`; there is no API key.
-   On a Mac, grant **Screen Recording** and, for key presses, **Accessibility**. See [macOS permissions](https://www.shotomatic.com/guide/get-started/macos-permissions).

## Add Shotomatic to JetBrains AI Assistant and Junie

**AI Assistant:** open **Settings | Tools | AI Assistant | Model Context Protocol (MCP)**, select **Add**, paste the JSON below, and select **Apply**.

```json
{
  "mcpServers": {
    "shotomatic": {
      "command": "npx",
      "args": ["-y", "shotomatic", "mcp"]
    }
  }
}
```

**Junie:** add the same JSON to `~/.junie/mcp/mcp.json` (or `.junie/mcp/mcp.json` in a project).

On Windows, if the client cannot start `npx`, use `cmd` as the command and `/c`, `npx`, `-y`, `shotomatic`, `mcp` as the arguments.

## Approve it once

The first time JetBrains AI Assistant and Junie connects, Shotomatic shows an approval card with the name JetBrains AI Assistant and Junie reports for itself. Select **Allow**. Until you do, the agent can only read Shotomatic's status. See [Approvals and confirmations](https://www.shotomatic.com/guide/ai-agents/approvals-and-confirmations).

## Check that it works

In AI Assistant, the **Status** column shows the connection. In Junie, run `/mcp` to confirm the server is active. Then ask:

> "Check Shotomatic's status and tell me what you can do with it."

A working setup answers with the Shotomatic version, whether **Screen Recording** and **Accessibility** are granted on a Mac, your plan and the free screenshots left today, whether the website browser is installed, and any capture already running.

Shotomatic returns previews as images inside tool results. JetBrains AI Assistant and Junie's docs do not say whether those images reach the model, so the agent may receive only text for them.

## If the tool is unavailable

-   **The status shows an error.** Check that the JSON is valid, then select **Apply** again or restart the IDE.
-   **"MCP access is turned off."** Turn on **Let AI agents use Shotomatic** in **Settings > AI agents**, then restart the client.
-   **No approval card appears.** Open Shotomatic and look for the card; on a Mac, its Dock icon bounces when the card appears.
-   **The client cannot find `npx` or Node.** See [the troubleshooting list for all clients](https://www.shotomatic.com/guide/ai-agents/other-agents#troubleshooting).

Next, try a request from [What agents can do](https://www.shotomatic.com/guide/ai-agents/what-agents-can-do), or see every tool in the [Tools reference](https://www.shotomatic.com/guide/ai-agents/tools).

## On this page

1.  [Before you start](#before-you-start)
2.  [Add Shotomatic to JetBrains AI Assistant and Junie](#add-shotomatic-to-jetbrains-ai-assistant-and-junie)
3.  [Approve it once](#approve-it-once)
4.  [Check that it works](#check-that-it-works)
5.  [If the tool is unavailable](#if-the-tool-is-unavailable)

## About this version

This Markdown page is generated from the server-rendered public page on Shotomatic. Interactive controls and site navigation are omitted. Use the canonical page when citing or sharing it with people.
