# VS Code con GitHub Copilot | Guida utente | Shotomatic

> Aggiungi Shotomatic a VS Code con GitHub Copilot 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/vs-code](https://www.shotomatic.com/it/guide/ai-agents/clients/vs-code)
- Pagina Markdown: [https://www.shotomatic.com/it/guide/ai-agents/clients/vs-code.md](https://www.shotomatic.com/it/guide/ai-agents/clients/vs-code.md)

Sfoglia la guida utente

In questa pagina

1.  [Prima di iniziare](#prima-di-iniziare)
2.  [Aggiungere Shotomatic a VS Code con GitHub Copilot](#aggiungere-shotomatic-a-vs-code-con-github-copilot)
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)

VS Code con GitHub Copilot può usare Shotomatic tramite il server MCP locale di Shotomatic. Questi passaggi seguono la documentazione di VS Code con GitHub Copilot ([MCP configuration reference](https://code.visualstudio.com/docs/agents/reference/mcp-configuration) e [Manage MCP servers](https://code.visualstudio.com/docs/agents/run/manage-mcp-servers)); Shotomatic è testato con Claude Code e Codex, non con VS Code con GitHub Copilot. Se un menu o un file non corrisponde più, consulta la documentazione di VS Code con GitHub Copilot.

## 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 VS Code con GitHub Copilot

VS Code usa `servers`, non `mcpServers`, e richiede `type`. Aggiungi questo a `.vscode/mcp.json` in un workspace:

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

Per aggiungerlo invece al tuo profilo utente, esegui:

```sh
code --add-mcp '{"name":"shotomatic","type":"stdio","command":"npx","args":["-y","shotomatic","mcp"]}'
```

VS Code può chiederti di considerare attendibile il server al primo avvio.

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 VS Code con GitHub Copilot 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 **MCP: List Servers** dalla Command Palette per vedere il server e avviarlo o riavviarlo. 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 VS Code con GitHub Copilot non dice se queste immagini arrivano al modello, quindi l'agente potrebbe ricevere solo testo.

## Se lo strumento non è disponibile

-   **Il server viene ignorato.** Controlla che la voce si trovi sotto `servers` e abbia `"type": "stdio"`.
-   **"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 VS Code con GitHub Copilot](#aggiungere-shotomatic-a-vs-code-con-github-copilot)
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.
