Collegare altri agenti IA

Testato con Claude Code e Codex. I client qui sotto usano lo stesso standard MCP: i passaggi seguono la documentazione di ciascun client e Shotomatic non è stato testato con loro. I menu e i formati dei file dei client cambiano, quindi se un passaggio non corrisponde più, consulta la documentazione del client.

Ogni client richiede gli stessi tre valori:

• Comando: npx
• Argomenti: -y, shotomatic, mcp
• Variabili d'ambiente: nessuna. Non serve nessuna chiave API.

Prima di aggiungerlo, attiva Consenti agli agenti IA di usare Shotomatic in Impostazioni > Agenti IA e installa Node 18.3 o successivo. La prima volta che un client si collega, Shotomatic mostra una scheda di approvazione: seleziona Consenti. Per l'intera procedura, compresi Claude Code, Claude Desktop e Codex, vedi Collegare un agente IA.

Su Windows, nei percorsi qui sotto ~ indica la tua cartella utente (%USERPROFILE%). Se un client su Windows non riesce ad avviare npx, usa cmd come comando e /c, npx, -y, shotomatic, mcp come argomenti.

Ogni client ha le proprie impostazioni MCP e molti chiedono conferma prima di ogni chiamata a uno strumento. Aggiungi Shotomatic dove il client si aspetta un server locale (stdio), non un URL remoto.

Amp

Docs: Amp MCP. Esegui:

amp mcp add shotomatic -- npx -y shotomatic mcp

Esegui amp mcp doctor per controllare il server. Il manuale di Amp consiglia di includere i server MCP nelle skill quando non servono in ogni thread.

Cline

Docs: Configuring MCP servers. Nel pannello di Cline seleziona l'icona MCP Servers, apri Configure e seleziona Configure MCP Servers. Aggiungi questo al file JSON che si apre (la CLI di Cline usa ~/.cline/data/settings/cline_mcp_settings.json):

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

L'elenco autoApprove di Cline è vuoto per impostazione predefinita, quindi Cline chiede conferma prima di ogni chiamata a uno strumento.

Continue

Docs: Set up MCP in Continue. MCP funziona solo in modalità Agent. Crea .continue/mcpServers/shotomatic.yaml nel tuo workspace:

name: Shotomatic
version: 0.0.1
schema: v1
mcpServers:
  - name: Shotomatic
    type: stdio
    command: npx
    args:
      - "-y"
      - "shotomatic"
      - "mcp"

GitHub Copilot CLI

Docs: Adding MCP servers to Copilot CLI. Esegui:

copilot mcp add shotomatic -- npx -y shotomatic mcp

Il comando scrive in ~/.copilot/mcp-config.json. In una sessione, digita /mcp per aprire il pannello dei server MCP.

Cursor

Docs: Model Context Protocol in Cursor. Aggiungi questo a ~/.cursor/mcp.json per tutti i progetti, oppure a .cursor/mcp.json dentro un singolo progetto:

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

Controlla in Customize che il server sia abilitato. Cursor mostra gli errori di avvio in Output (Cmd + Shift + U, su Windows Ctrl + Shift + U) sotto MCP Logs. Per impostazione predefinita, Cursor chiede l'approvazione prima di usare gli strumenti MCP.

Devin (Windsurf)

Docs: Devin CLI MCP configuration e Devin Desktop customizations. L'indirizzo della documentazione di Windsurf ora rimanda alla documentazione di Devin Desktop. Esegui:

devin mcp add -s user shotomatic -- npx -y shotomatic mcp

Oppure aggiungi lo stesso JSON di sopra (senza type) a ~/.config/devin/mcp_config.json. Esegui devin mcp list oppure, in Devin Desktop, apri Customize > MCPs e guarda sotto This computer. Per impostazione predefinita, l'agente chiede l'approvazione prima di chiamare qualsiasi strumento MCP.

Gemini CLI

Docs: MCP servers with Gemini CLI. Aggiungi questo a ~/.gemini/settings.json (oppure a .gemini/settings.json in un progetto):

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

Esegui gemini mcp list in una shell oppure /mcp dentro una sessione. I server stdio risultano connessi solo se la cartella attuale è considerata attendibile. Lascia trust al valore predefinito (false), così Gemini CLI continua a chiedere conferma prima di ogni chiamata a uno strumento.

Goose

Docs: Using extensions. In Goose Desktop apri Extensions, seleziona Add custom extension e inserisci:

• Type: Standard IO
• ID: shotomatic
• Name: Shotomatic
• Command: npx -y shotomatic mcp

Nella CLI esegui goose configure, scegli Add Extension e Command-line Extension e inserisci lo stesso comando. Per una singola sessione, esegui goose session --with-extension "npx -y shotomatic mcp".

JetBrains AI Assistant e Junie

Docs: AI Assistant MCP e Junie CLI MCP configuration.

AI Assistant: apri Settings | Tools | AI Assistant | Model Context Protocol (MCP), seleziona Add, incolla il JSON qui sotto e seleziona Apply. La colonna Status mostra la connessione.

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

Junie: aggiungi lo stesso JSON a ~/.junie/mcp/mcp.json (oppure a .junie/mcp/mcp.json in un progetto), poi esegui /mcp per verificare che il server sia attivo.

Kiro

Docs: Kiro MCP configuration. Esegui Kiro: Open user MCP config (JSON) dalla Command Palette, oppure modifica ~/.kiro/settings/mcp.json (.kiro/settings/mcp.json per un solo workspace). Assicurati che l'impostazione del supporto MCP sia attiva, poi aggiungi:

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

Salvando il file, i server si ricollegano.

LM Studio

Docs: Use MCP servers in LM Studio. LM Studio supporta i server MCP locali e segue la notazione mcp.json di Cursor. Apri la scheda Program nella barra laterale destra e seleziona Install > Edit mcp.json. Aggiungi:

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

La documentazione di LM Studio sconsiglia di installare server MCP da fonti di cui non ti fidi e avverte che alcuni server consumano molti token, il che può saturare il contesto di un modello locale.

OpenCode

Docs: OpenCode MCP servers. Esegui questo comando nel progetto che deve usarlo e aggiungi --global per renderlo disponibile ovunque:

opencode mcp add shotomatic -- npx -y shotomatic mcp
opencode mcp list

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"]
      }
    }
  }
}

Qwen Code

Docs: Connect Qwen Code to tools via MCP. Aggiungi questo a ~/.qwen/settings.json (utente) oppure a .qwen/settings.json (progetto):

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

Riavvia Qwen Code nello stesso progetto, poi digita /mcp per vedere il server.

Roo Code

Docs: Using MCP in Roo Code. Apri la vista delle impostazioni MCP dall'icona in alto nel pannello di Roo Code, scorri in basso e seleziona Edit Global MCP (mcp_settings.json) oppure Edit Project MCP (.roo/mcp.json). Aggiungi:

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

VS Code con GitHub Copilot

Docs: MCP configuration reference e Manage MCP servers. VS Code usa servers, non mcpServers, e richiede type. Aggiungi questo a .vscode/mcp.json in un workspace:

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

Per aggiungerlo invece al tuo profilo utente, esegui:

code --add-mcp '{"name":"shotomatic","type":"stdio","command":"npx","args":["-y","shotomatic","mcp"]}'

Esegui MCP: List Servers dalla Command Palette per vedere il server e avviarlo o riavviarlo. VS Code può chiederti di considerare attendibile il server al primo avvio.

Warp

Docs: Model Context Protocol in Warp. Apri Settings > Agents > MCP servers, seleziona + Add e incolla:

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

La pagina MCP servers elenca ogni server e indica se è in esecuzione. L'agente di Warp chiede conferma prima di chiamare i server MCP, a meno che tu non consenta un server nel profilo dell'agente.

Zed

Docs: Model Context Protocol in 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": {}
    }
  }
}

Apri Settings > AI > MCP Servers: un punto verde con il tooltip "Server is active" indica che il server è connesso. Per impostazione predefinita, Zed chiede conferma prima delle chiamate agli strumenti.

Limiti da conoscere

• Shotomatic restituisce gli screenshot come immagini all'interno dei risultati degli strumenti. Cursor e Gemini CLI documentano il supporto alle immagini nei risultati degli strumenti MCP. Per gli altri client qui sopra la documentazione non lo dice, quindi l'agente potrebbe ricevere solo testo.
• Diversi client chiedono l'approvazione a ogni chiamata per impostazione predefinita, il che può significare molte richieste durante una lunga acquisizione. La documentazione di ciascun client descrive come consentire gli strumenti di un server; per ciò che Shotomatic stesso consente agli agenti, vedi Limiti e sicurezza.

Risoluzione dei problemi

• Il client non vede il server. Salva il file di configurazione, poi riavvia il client o ricarica il suo elenco MCP. Controlla che la voce si trovi sotto la chiave che il client si aspetta (mcpServers, servers o context_servers) e che il JSON o lo YAML sia valido.
• "MCP access is turned off." Apri Shotomatic, vai in Impostazioni > Agenti IA, attiva Consenti agli agenti IA di usare Shotomatic e riavvia il client.
• Non compare nessuna scheda di approvazione. Apri Shotomatic e cerca la scheda: sul Mac, l'icona nel Dock rimbalza quando compare. Finché non approvi, l'agente può solo leggere lo stato. Rimuovendo l'agente in Impostazioni > Agenti IA, la scheda ricompare alla connessione successiva.
• Il client non trova npx o Node. Sul Mac, le app che apri dal Dock o dal Finder spesso partono con un PATH più corto di quello del Terminale. La documentazione di Cursor dice che il comando deve trovarsi nel percorso di sistema o essere indicato con il percorso completo, e quella di Qwen Code consiglia un percorso assoluto del comando quando un server non si avvia. Nel Terminale esegui which npx e usa quel percorso completo come comando, per esempio /opt/homebrew/bin/npx. npx richiede anche node nel proprio PATH; se continua a non funzionare, aggiungi la cartella restituita da which node a una voce PATH sotto env del server (dove il client supporta env). I gestori di versioni come mise o asdf possono richiedere lo stesso accorgimento.

Torna a Collegare un agente IA.