Risoluzione dei problemi

I problemi più comuni nell’installare e nel collegare.

command not found: sddvault

Il terminale è stato avviato prima che il programma di installazione aggiornasse il PATH. Apri una nuova finestra del terminale oppure ricarica la shell:

Terminale
exec $SHELL -l

PowerShell legge il PATH all’avvio. Chiudi tutte le finestre di PowerShell e aprine una nuova.

Non è nel mio PATH

Aggiungi tu la cartella di installazione al PATH, poi apri un nuovo terminale.

Terminale
echo 'export PATH="$HOME/.sddvault/bin:$PATH"' >> ~/.zshrc
PowerShell
[Environment]::SetEnvironmentVariable("Path", "$env:Path;$env:LOCALAPPDATA\sddvault\bin", "User")

Sono dietro un proxy aziendale

Imposta il proxy prima di eseguire il programma di installazione. In seguito sddvault usa le stesse variabili. Usa NO_PROXY per gli host da raggiungere direttamente.

Terminale
export HTTPS_PROXY=http://proxy.example.com:8080 export NO_PROXY=localhost,.internal.example.com
PowerShell
$env:HTTPS_PROXY = "http://proxy.example.com:8080" $env:NO_PROXY = "localhost,.internal.example.com"

Windows SmartScreen avvisa di un’app non firmata

Finché SDD Vault è in beta, la build per Windows non è firmata, quindi SmartScreen potrebbe dire “PC protetto da Windows”. Scegli Ulteriori informazioni, poi Esegui comunque. Fallo solo se il comando proviene da {host}.

L’agente non vede SDD Vault

Riavvia l’agente dopo sddvault init. Controlla che il file di configurazione esista (.mcp.json, .cursor/mcp.json o .vscode/mcp.json) e che il suo URL contenga lo slug della tua organizzazione. Con un token, controlla che SDD_VAULT_TOKEN sia impostata nell’ambiente in cui gira l’agente.

L’accesso è scaduto

Esegui di nuovo sddvault login. sddvault whoami mostra chi ha eseguito l’accesso.

Una scrittura viene rifiutata con conflict

Qualcuno ha scritto il documento dopo la tua ultima lettura. Leggi la revisione corrente, unisci la tua modifica e scrivi di nuovo con quella revisione come expected_revision.

Le chiamate MCP vengono rifiutate al limite

Free e Pro hanno un limite mensile di chiamate MCP (plan_mcp_call_limit) che si azzera il primo giorno del mese successivo. Vedi la politica di uso corretto o cambia piano.

Sei ancora bloccato? Contatta il supporto. Di solito rispondiamo entro un giorno lavorativo.