# Cursor | Guida utente | Shotomatic

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

Sfoglia la guida utente

In questa pagina

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

Cursor può usare Shotomatic tramite il server MCP locale di Shotomatic. Questi passaggi seguono la documentazione di Cursor ([Model Context Protocol in Cursor](https://cursor.com/docs/context/mcp)); Shotomatic è testato con Claude Code e Codex, non con Cursor. Se un menu o un file non corrisponde più, consulta la documentazione di Cursor.

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

Aggiungi questo a `~/.cursor/mcp.json` per tutti i progetti, oppure a `.cursor/mcp.json` dentro un singolo progetto:

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

Per impostazione predefinita, Cursor chiede l'approvazione prima di usare gli strumenti 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 Cursor 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

Controlla in **Customize** che il server sia abilitato. 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 Cursor, 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 mostra un errore.** Cursor mostra gli errori di avvio in **Output** (`Cmd + Shift + U`, su Windows `Ctrl + Shift + U`) sotto **MCP Logs**.
-   **"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 Cursor](#aggiungere-shotomatic-a-cursor)
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.
