Sfoglia la guida utente

Zed

Aggiungi Shotomatic a Zed 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

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

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 Zed

Zed li chiama context server e usa context_servers. Esegui zed: open settings file dalla Command Palette e aggiungi:

{
  "context_servers": {
    "shotomatic": {
      "command": "npx",
      "args": ["-y", "shotomatic", "mcp"],
      "env": {}
    }
  }
}

Per impostazione predefinita, Zed chiede conferma prima delle chiamate agli strumenti.

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 Zed 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

Apri Settings > AI > MCP Servers: un punto verde con il tooltip "Server is active" indica che il server è connesso. 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 Zed non dice se queste immagini arrivano al modello, quindi l'agente potrebbe ricevere solo testo.

Se lo strumento non è disponibile

  • Non c'è il punto verde. Controlla che la voce si trovi sotto context_servers, non sotto mcpServers.
  • "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.

Zed | Guida utente | Shotomatic