# Gemini CLI | Guida utente | Shotomatic

> Aggiungi Shotomatic a Gemini CLI 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/gemini-cli](https://www.shotomatic.com/it/guide/ai-agents/clients/gemini-cli)
- Pagina Markdown: [https://www.shotomatic.com/it/guide/ai-agents/clients/gemini-cli.md](https://www.shotomatic.com/it/guide/ai-agents/clients/gemini-cli.md)

Sfoglia la guida utente

In questa pagina

1.  [Prima di iniziare](#prima-di-iniziare)
2.  [Aggiungere Shotomatic a Gemini CLI](#aggiungere-shotomatic-a-gemini-cli)
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)

Gemini CLI può usare Shotomatic tramite il server MCP locale di Shotomatic. Questi passaggi seguono la documentazione di Gemini CLI ([MCP servers with Gemini CLI](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md)); Shotomatic è testato con Claude Code e Codex, non con Gemini CLI. Se un menu o un file non corrisponde più, consulta la documentazione di Gemini CLI.

## 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 Gemini CLI

Aggiungi questo a `~/.gemini/settings.json` (oppure a `.gemini/settings.json` in un progetto):

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

Lascia `trust` al valore predefinito (`false`), così Gemini CLI continua a chiedere conferma prima di ogni chiamata a uno strumento.

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 Gemini CLI 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

Esegui `gemini mcp list` in una shell oppure `/mcp` dentro una sessione. 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.

Secondo la documentazione di Gemini CLI, le immagini nei risultati degli strumenti MCP sono supportate, quindi l'agente vede le anteprime e i fotogrammi che chiede.

## Se lo strumento non è disponibile

-   **Il server risulta disconnesso.** I server stdio risultano connessi solo se la cartella attuale è considerata attendibile.
-   **"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 Gemini CLI](#aggiungere-shotomatic-a-gemini-cli)
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.
