Sfoglia la guida utente

OpenCode

Aggiungi Shotomatic a OpenCode come server MCP locale, verifica che funzioni e risolvi i problemi di configurazione più comuni.

Aggiornato il 16 novembre 2026

Apri Markdown
In questa pagina

OpenCode può usare Shotomatic tramite il server MCP locale di Shotomatic. Questi passaggi seguono la documentazione di OpenCode (OpenCode MCP servers); Shotomatic è testato con Claude Code e Codex, non con OpenCode. Se un menu o un file non corrisponde più, consulta la documentazione di OpenCode.

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.

Aggiungere Shotomatic a OpenCode

Esegui questo comando nel progetto che deve usarlo e aggiungi --global per renderlo disponibile ovunque:

opencode mcp add shotomatic -- npx -y shotomatic mcp

Per modificare la configurazione a mano secondo la documentazione attuale (V2), aggiungi questo a opencode.jsonc. Il formato V1 è diverso, quindi usa il comando della CLI se non sei sicuro di quale versione hai.

{
  "mcp": {
    "servers": {
      "shotomatic": {
        "type": "local",
        "command": ["npx", "-y", "shotomatic", "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 OpenCode 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 opencode mcp list. 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 OpenCode non dice se queste immagini arrivano al modello, quindi l'agente potrebbe ricevere solo testo.

Se lo strumento non è disponibile

  • Il server manca in un altro progetto. Aggiungilo di nuovo con --global.
  • "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.

Poi prova una richiesta da Che cosa possono fare gli agenti, oppure guarda tutti gli strumenti nel Riferimento degli strumenti.

OpenCode | Guida utente | Shotomatic