Solución de problemas

Los problemas más habituales al instalar y conectar.

command not found: sddvault

Tu terminal se abrió antes de que el instalador actualizara el PATH. Abre una ventana nueva o recarga tu shell:

Terminal
exec $SHELL -l

PowerShell lee el PATH al iniciarse. Cierra todas las ventanas de PowerShell y abre una nueva.

No está en mi PATH

Añade la carpeta de instalación al PATH tú mismo y abre una terminal nueva.

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

Estoy detrás de un proxy corporativo

Configura el proxy antes de ejecutar el instalador. sddvault usa las mismas variables después. Usa NO_PROXY para los hosts a los que debas llegar directamente.

Terminal
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 avisa de una app sin firmar

Mientras SDD Vault esté en beta, la versión de Windows no está firmada, así que SmartScreen puede decir «Windows protegió su PC». Elige Más información y luego Ejecutar de todas formas. Hazlo solo si el comando viene de {host}.

El agente no ve SDD Vault

Reinicia el agente después de sddvault init. Comprueba que existe el archivo de configuración (.mcp.json, .cursor/mcp.json o .vscode/mcp.json) y que su URL lleva el slug de tu organización. Con un token, comprueba que SDD_VAULT_TOKEN está definida en el entorno donde se ejecuta el agente.

La sesión caducó

Vuelve a ejecutar sddvault login. sddvault whoami muestra quién tiene la sesión iniciada.

Una escritura se rechaza con conflict

Alguien escribió el documento después de tu última lectura. Lee la revisión actual, fusiona tu cambio y vuelve a escribir con esa revisión como expected_revision.

Las llamadas MCP se rechazan al llegar al límite

Free y Pro tienen un límite mensual de llamadas MCP (plan_mcp_call_limit) que se restablece el primer día del mes siguiente. Consulta la política de uso justo o cambia de plan.

¿Sigues atascado? Contacta con soporte. Solemos responder en un día laborable.