Resolução de problemas

Os problemas mais comuns ao instalar e ligar.

command not found: sddvault

O seu terminal foi aberto antes de o instalador atualizar o PATH. Abra uma nova janela de terminal ou recarregue a sua shell:

Terminal
exec $SHELL -l

O PowerShell lê o PATH quando arranca. Feche todas as janelas do PowerShell e abra uma nova.

Não está no meu PATH

Adicione a pasta de instalação ao PATH manualmente e abra um novo terminal.

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

Estou atrás de um proxy empresarial

Configure o proxy antes de executar o instalador. O sddvault usa as mesmas variáveis depois. Use NO_PROXY para os anfitriões que têm de ser alcançados diretamente.

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"

O Windows SmartScreen avisa sobre uma aplicação sem assinatura

Enquanto o SDD Vault estiver em beta, a versão para Windows não tem assinatura de código, pelo que o SmartScreen pode dizer «O Windows protegeu o seu PC». Escolha Mais informações e depois Executar mesmo assim. Faça-o apenas se o comando vier de {host}.

O agente não vê o SDD Vault

Reinicie o agente depois do sddvault init. Confirme que o ficheiro de configuração existe (.mcp.json, .cursor/mcp.json ou .vscode/mcp.json) e que o seu URL tem o slug da sua organização. Com um token, confirme que SDD_VAULT_TOKEN está definida no ambiente onde o agente corre.

A sessão expirou

Execute sddvault login de novo. O sddvault whoami mostra quem tem sessão iniciada.

Uma escrita é recusada com conflict

Alguém escreveu o documento depois da sua última leitura. Leia a revisão atual, una a sua alteração e escreva de novo com essa revisão como expected_revision.

As chamadas MCP são recusadas ao atingir o limite

O Free e o Pro têm um limite mensal de chamadas MCP (plan_mcp_call_limit) que se repõe no primeiro dia do mês seguinte. Veja a política de utilização justa ou mude de plano.

Continua com problemas? Contacte o suporte. Costumamos responder num dia útil.