# Codex | Guida utente | Shotomatic

> Collega OpenAI Codex a Shotomatic tramite MCP con un clic o una voce in config.toml, verifica che funzioni e risolvi i problemi comuni.

- Tipo: Pagina web pubblica
- Pagina canonica: [https://www.shotomatic.com/it/guide/ai-agents/clients/codex](https://www.shotomatic.com/it/guide/ai-agents/clients/codex)
- Pagina Markdown: [https://www.shotomatic.com/it/guide/ai-agents/clients/codex.md](https://www.shotomatic.com/it/guide/ai-agents/clients/codex.md)

Sfoglia la guida utente

In questa pagina

1.  [Collegare con un clic](#collegare-con-un-clic)
2.  [Aggiungerlo a mano](#aggiungerlo-a-mano)
3.  [Verificare che funzioni](#verificare-che-funzioni)
4.  [Se lo strumento non è disponibile](#se-lo-strumento-non-è-disponibile)

OpenAI Codex può usare Shotomatic sul tuo Mac o PC Windows tramite il server MCP locale di Shotomatic. Shotomatic è testato con Codex.

## Collegare con un clic

1.  Apri Shotomatic e vai in **Impostazioni > Agenti IA** (`Command + ,`, su Windows `Ctrl + ,`).
2.  In **Collega un agente**, seleziona **Collega** accanto a **Codex (ChatGPT)**.

Shotomatic si aggiunge a `~/.codex/config.toml`, attiva **Consenti agli agenti IA di usare Shotomatic** e approva Codex, quindi non compare nessuna scheda di approvazione. Avvia una nuova sessione di Codex per caricare il server. **Codex (ChatGPT)** compare nell'elenco quando Codex ha creato la propria cartella delle impostazioni sul computer.

## Aggiungerlo a mano

Attiva **Consenti agli agenti IA di usare Shotomatic** in **Impostazioni > Agenti IA**, installa Node 18.3 o successivo e aggiungi questo a `~/.codex/config.toml` (su Windows, `%USERPROFILE%\.codex\config.toml`):

```toml
[mcp_servers.shotomatic]
command = "npx"
args = ["-y", "shotomatic", "mcp"]
```

Avvia una nuova sessione. La prima volta che Codex si collega in questo modo, Shotomatic mostra una scheda di approvazione; seleziona **Consenti**.

## Verificare che funzioni

Chiedi a Codex:

> "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.

## Se lo strumento non è disponibile

-   **Codex non elenca Shotomatic.** Avvia una nuova sessione dopo aver modificato `config.toml` e controlla che la tabella `[mcp_servers.shotomatic]` compaia una sola volta nel file.
-   **Codex (ChatGPT) manca nelle impostazioni.** Apri Codex una volta perché crei la cartella delle impostazioni, poi riapri **Impostazioni > Agenti IA**.
-   **"MCP access is turned off."** Attiva **Consenti agli agenti IA di usare Shotomatic** in **Impostazioni > Agenti IA**, poi avvia una nuova sessione.
-   **L'agente attende l'approvazione.** Apri Shotomatic e seleziona **Consenti** sulla scheda.
-   **`npx` non viene trovato.** Riguarda solo la voce a mano. Vedi [l'elenco di risoluzione dei problemi per tutti i client](https://www.shotomatic.com/it/guide/ai-agents/other-agents#risoluzione-dei-problemi).

Su Windows, fai clic una volta in un libro Kindle prima di chiedere a Codex di voltare le pagine: Kindle ignora i tasti finché non fai clic nella vista di lettura. Poi prova una richiesta da [Che cosa possono fare gli agenti](https://www.shotomatic.com/it/guide/ai-agents/what-agents-can-do).

## In questa pagina

1.  [Collegare con un clic](#collegare-con-un-clic)
2.  [Aggiungerlo a mano](#aggiungerlo-a-mano)
3.  [Verificare che funzioni](#verificare-che-funzioni)
4.  [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.
