SimpliGen Docs
AI Agents

Connetti un agente

Installa il connettore SimpliGen in Claude Code, Cursor e altri client AI.

Apri l'app e vai su Impostazioni -> Connetti un agente. Vedrai una griglia di client supportati, con un badge "rilevato" su quelli già installati sul tuo computer. La generazione locale è sempre gratuita; la generazione cloud avviene solo se colleghi SimpliGen Cloud e lo consenti.

Cosa ti serve

Node.js installato (il connettore funziona attraverso npx) e l'app SimpliGen aperta mentre l'agente lavora.

Installazione con un clic

La maggior parte dei client (Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Gemini CLI, OpenAI Codex, OpenClaw, Zed) si installano con un clic:

  1. Fai clic sul client, facoltativamente imposta un limite di spesa cloud e fai clic su Installa.
  2. SimpliGen crea un token e scrive il suo connettore, token incluso, nella configurazione di quel client per te, lasciando intatti gli altri server configurati. Non c'è nessuna chiave da copiare o incollare; la nuova voce sotto Agenti connessi è quel token.
  3. Esci completamente e riapri il client in modo che rilegga la sua configurazione. Chiudere la finestra non è sufficiente per i client che continuano a funzionare nel vassoio di sistema (Codex e Claude Desktop lo fanno): fai clic destro sull'icona del vassoio, scegli Esci, quindi aprilo di nuovo.

È tutto. L'agente ora può raggiungere SimpliGen.

OpenAI Codex

Codex mantiene la sua configurazione in ~/.codex/config.toml (o $CODEX_HOME/config.toml), condivisa dall'app Codex, dalla CLI e dall'estensione IDE, quindi un'installazione copre tutti e tre. SimpliGen aggiunge una tabella [mcp_servers.simpligen] e lascia il resto del file invariato. Se il file non può essere scritto, il pannello mostra il blocco esatto da incollare alla fine.

Configurazione guidata

Goose e Hermes utilizzano formati di configurazione che non scriviamo automaticamente. Per questi, SimpliGen mostra passaggi numerati con il comando o lo snippet esatto da incollare, incluso il tuo token. Segui i passaggi in ordine, quindi riavvia il client.

Configurazione manuale

Per qualsiasi altro client MCP, scegli Configurazione manuale. SimpliGen crea un token e mostra la configurazione da incollare:

{
  "mcpServers": {
    "simpligen": {
      "command": "npx",
      "args": ["-y", "@simpligen/mcp"],
      "env": { "SIMPLIGEN_TOKEN": "sg-agent-..." }
    }
  }
}

Riavvia il client dopo.

Il tuo token viene mostrato una sola volta

Copialo prima di chiudere il pannello. Se lo perdi, crea semplicemente un nuovo token; non costa nulla e puoi averne quanti ne desideri.

Gestione degli agenti connessi

L'elenco Agenti connessi mostra ogni agente configurato, il suo limite di spesa e la spesa finora, e quando è stato utilizzato l'ultima volta. Fai clic su Rimuovi per revocare il suo token e rimuovere SimpliGen dalla configurazione di quel client. La revoca ha effetto immediato, quindi è un modo sicuro per interrompere un agente che non usi più.

Prossimo: vedi Utilizzo di un agente per scoprire cosa può effettivamente fare.