# Goose | Guida utente | Shotomatic

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

Sfoglia la guida utente

In questa pagina

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

Goose può usare Shotomatic tramite il server MCP locale di Shotomatic. Questi passaggi seguono la documentazione di Goose ([Using extensions](https://goose-docs.ai/docs/getting-started/using-extensions)); Shotomatic è testato con Claude Code e Codex, non con Goose. Se un menu o un file non corrisponde più, consulta la documentazione di Goose.

## 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 Goose

In Goose Desktop apri **Extensions**, seleziona **Add custom extension** e inserisci:

-   **Type:** Standard IO
-   **ID:** `shotomatic`
-   **Name:** `Shotomatic`
-   **Command:** `npx -y shotomatic mcp`

Nella CLI esegui `goose configure`, scegli **Add Extension** e **Command-line Extension** e inserisci lo stesso comando. Per una singola sessione, esegui `goose session --with-extension "npx -y shotomatic mcp"`.

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 Goose 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 Goose Desktop, apri **Extensions** e cerca Shotomatic. 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 Goose non dice se queste immagini arrivano al modello, quindi l'agente potrebbe ricevere solo testo.

## Se lo strumento non è disponibile

-   **L'estensione non si avvia.** Controlla che il tipo sia Standard IO e che il comando sia esattamente `npx -y shotomatic mcp`.
-   **"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 Goose](#aggiungere-shotomatic-a-goose)
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.
