# JetBrains AI Assistant e Junie | Guida utente | Shotomatic

> Aggiungi Shotomatic a JetBrains AI Assistant e Junie come server MCP locale, verifica che funzioni e risolvi i problemi di configurazione più comuni.

- Tipo: Pagina web pubblica
- Pagina canonica: [https://www.shotomatic.com/it/guide/ai-agents/clients/jetbrains](https://www.shotomatic.com/it/guide/ai-agents/clients/jetbrains)
- Pagina Markdown: [https://www.shotomatic.com/it/guide/ai-agents/clients/jetbrains.md](https://www.shotomatic.com/it/guide/ai-agents/clients/jetbrains.md)

Sfoglia la guida utente

In questa pagina

1.  [Prima di iniziare](#prima-di-iniziare)
2.  [Aggiungere Shotomatic a JetBrains AI Assistant e Junie](#aggiungere-shotomatic-a-jetbrains-ai-assistant-e-junie)
3.  [Approvarlo una volta](#approvarlo-una-volta)
4.  [Verificare che funzioni](#verificare-che-funzioni)
5.  [Se lo strumento non è disponibile](#se-lo-strumento-non-è-disponibile)

JetBrains AI Assistant e Junie può usare Shotomatic tramite il server MCP locale di Shotomatic. Questi passaggi seguono la documentazione di JetBrains AI Assistant e Junie ([AI Assistant MCP](https://www.jetbrains.com/help/ai-assistant/mcp.html) e [Junie CLI MCP configuration](https://junie.jetbrains.com/docs/junie-cli-mcp-configuration.html)); Shotomatic è testato con Claude Code e Codex, non con JetBrains AI Assistant e Junie. Se un menu o un file non corrisponde più, consulta la documentazione di JetBrains AI Assistant e Junie.

## Prima di iniziare

-   In Shotomatic, apri **Impostazioni > Agenti IA** e attiva **Consenti agli agenti IA di usare Shotomatic**.
-   Installa Node 18.3 o successivo. Il client avvia con `npx` un piccolo pacchetto bridge chiamato `shotomatic`; non c'è nessuna chiave API.
-   Sul Mac, concedi **Registrazione schermo** e, per la pressione dei tasti, **Accessibilità**. Vedi [autorizzazioni di macOS](https://www.shotomatic.com/it/guide/get-started/macos-permissions).

## Aggiungere Shotomatic a JetBrains AI Assistant e Junie

**AI Assistant:** apri **Settings | Tools | AI Assistant | Model Context Protocol (MCP)**, seleziona **Add**, incolla il JSON qui sotto e seleziona **Apply**.

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

**Junie:** aggiungi lo stesso JSON a `~/.junie/mcp/mcp.json` (oppure a `.junie/mcp/mcp.json` in un progetto).

Su Windows, se il client non riesce ad avviare `npx`, usa `cmd` come comando e `/c`, `npx`, `-y`, `shotomatic`, `mcp` come argomenti.

## Approvarlo una volta

La prima volta che JetBrains AI Assistant e Junie si collega, Shotomatic mostra una scheda di approvazione con il nome che il client comunica. Seleziona **Consenti**. Finché non lo fai, l'agente può solo leggere lo stato di Shotomatic. Vedi [Approvazioni e conferme](https://www.shotomatic.com/it/guide/ai-agents/approvals-and-confirmations).

## Verificare che funzioni

In AI Assistant, la colonna **Status** mostra la connessione. In Junie, esegui `/mcp` per verificare che il server sia attivo. Poi chiedi:

> "Controlla lo stato di Shotomatic e dimmi che cosa puoi fare con Shotomatic."

Se la configurazione funziona, l'agente risponde con la versione di Shotomatic, se sul Mac sono concesse **Registrazione schermo** e **Accessibilità**, il tuo piano e gli screenshot gratuiti ancora disponibili oggi, se il browser per i siti web è installato e le acquisizioni già in corso.

Shotomatic restituisce le anteprime come immagini nei risultati degli strumenti. La documentazione di JetBrains AI Assistant e Junie non dice se queste immagini arrivano al modello, quindi l'agente potrebbe ricevere solo testo.

## Se lo strumento non è disponibile

-   **Lo stato mostra un errore.** Controlla che il JSON sia valido, poi seleziona di nuovo **Apply** o riavvia l'IDE.
-   **"MCP access is turned off."** Attiva **Consenti agli agenti IA di usare Shotomatic** in **Impostazioni > Agenti IA**, poi riavvia il client.
-   **Non compare nessuna scheda di approvazione.** Apri Shotomatic e cerca la scheda: sul Mac, l'icona nel Dock rimbalza quando compare.
-   **Il client non trova `npx` o Node.** Vedi [l'elenco di risoluzione dei problemi per tutti i client](https://www.shotomatic.com/it/guide/ai-agents/other-agents#risoluzione-dei-problemi).

Poi prova una richiesta da [Che cosa possono fare gli agenti](https://www.shotomatic.com/it/guide/ai-agents/what-agents-can-do), oppure guarda tutti gli strumenti nel [Riferimento degli strumenti](https://www.shotomatic.com/it/guide/ai-agents/tools).

## In questa pagina

1.  [Prima di iniziare](#prima-di-iniziare)
2.  [Aggiungere Shotomatic a JetBrains AI Assistant e Junie](#aggiungere-shotomatic-a-jetbrains-ai-assistant-e-junie)
3.  [Approvarlo una volta](#approvarlo-una-volta)
4.  [Verificare che funzioni](#verificare-che-funzioni)
5.  [Se lo strumento non è disponibile](#se-lo-strumento-non-è-disponibile)

## Informazioni su questa versione

Questa pagina Markdown viene generata dalla pagina pubblica di Shotomatic renderizzata sul server. I controlli interattivi e la navigazione del sito non sono inclusi. Per citare o condividere il contenuto, usa la pagina canonica.
