# Devin (Windsurf) | Guida utente | Shotomatic

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

Sfoglia la guida utente

In questa pagina

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

Devin (Windsurf) può usare Shotomatic tramite il server MCP locale di Shotomatic. Questi passaggi seguono la documentazione di Devin (Windsurf) ([Devin CLI MCP configuration](https://docs.devin.ai/cli/extensibility/mcp/configuration) e [Devin Desktop customizations](https://docs.devin.ai/desktop/cascade/mcp)); Shotomatic è testato con Claude Code e Codex, non con Devin (Windsurf). Se un menu o un file non corrisponde più, consulta la documentazione di Devin (Windsurf). L'indirizzo della documentazione di Windsurf ora rimanda alla documentazione di Devin Desktop.

## 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 Devin (Windsurf)

Esegui:

```sh
devin mcp add -s user shotomatic -- npx -y shotomatic mcp
```

Oppure aggiungi questo a `~/.config/devin/mcp_config.json`:

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

Per impostazione predefinita, l'agente chiede l'approvazione prima di chiamare qualsiasi strumento 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 Devin (Windsurf) 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 `devin mcp list` oppure, in Devin Desktop, apri **Customize > MCPs** e guarda sotto **This computer**. 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 Devin (Windsurf) non dice se queste immagini arrivano al modello, quindi l'agente potrebbe ricevere solo testo.

## Se lo strumento non è disponibile

-   **Il server non compare nell'elenco.** Controlla di averlo aggiunto con ambito utente (`-s user`) oppure in `~/.config/devin/mcp_config.json`.
-   **"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 Devin (Windsurf)](#aggiungere-shotomatic-a-devin-windsurf)
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.
