Gemini CLI
Aggiungi Shotomatic a Gemini CLI come server MCP locale, verifica che funzioni e risolvi i problemi di configurazione più comuni.
Aggiornato il 16 novembre 2026
In questa pagina
Gemini CLI può usare Shotomatic tramite il server MCP locale di Shotomatic. Questi passaggi seguono la documentazione di Gemini CLI (MCP servers with Gemini CLI); Shotomatic è testato con Claude Code e Codex, non con Gemini CLI. Se un menu o un file non corrisponde più, consulta la documentazione di Gemini CLI.
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
npxun piccolo pacchetto bridge chiamatoshotomatic; non c'è nessuna chiave API. - Sul Mac, concedi Registrazione schermo e, per la pressione dei tasti, Accessibilità. Vedi autorizzazioni di macOS.
Aggiungere Shotomatic a Gemini CLI
Aggiungi questo a ~/.gemini/settings.json (oppure a .gemini/settings.json in un progetto):
{
"mcpServers": {
"shotomatic": {
"command": "npx",
"args": ["-y", "shotomatic", "mcp"]
}
}
}
Lascia trust al valore predefinito (false), così Gemini CLI continua a chiedere conferma prima di ogni chiamata a uno strumento.
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 Gemini CLI 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.
Verificare che funzioni
Esegui gemini mcp list in una shell oppure /mcp dentro una sessione. 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 Gemini CLI, 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 risulta disconnesso. I server stdio risultano connessi solo se la cartella attuale è considerata attendibile.
- "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
npxo Node. Vedi l'elenco di risoluzione dei problemi per tutti i client.
Poi prova una richiesta da Che cosa possono fare gli agenti, oppure guarda tutti gli strumenti nel Riferimento degli strumenti.