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:
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.
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.
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.