Dépannage
Les problèmes les plus courants à l’installation et à la connexion.
command not found: sddvault
Votre terminal a été ouvert avant que le programme d’installation ne mette à jour le PATH. Ouvrez une nouvelle fenêtre de terminal ou rechargez votre shell :
PowerShell lit le PATH au démarrage. Fermez toutes les fenêtres PowerShell et ouvrez-en une nouvelle.
Il n’est pas dans mon PATH
Ajoutez vous-même le dossier d’installation au PATH, puis ouvrez un nouveau terminal.
Je suis derrière un proxy d’entreprise
Configurez votre proxy avant d’exécuter le programme d’installation. sddvault utilise ensuite les mêmes variables. Utilisez NO_PROXY pour les hôtes à joindre directement.
Windows SmartScreen signale une application non signée
Tant que SDD Vault est en bêta, la version Windows n’est pas signée, et SmartScreen peut afficher « Windows a protégé votre ordinateur ». Choisissez Informations complémentaires, puis Exécuter quand même. Ne le faites que si la commande provient de {host}.
L’agent ne voit pas SDD Vault
Redémarrez l’agent après sddvault init. Vérifiez que le fichier de configuration existe (.mcp.json, .cursor/mcp.json ou .vscode/mcp.json) et que son URL contient le slug de votre organisation. Avec un jeton, vérifiez que SDD_VAULT_TOKEN est définie dans l’environnement où l’agent s’exécute.
La session a expiré
Relancez sddvault login. sddvault whoami indique qui est connecté.
Une écriture est refusée avec conflict
Quelqu’un a écrit le document après votre dernière lecture. Lisez la révision courante, fusionnez votre modification et écrivez de nouveau avec cette révision comme expected_revision.
Les appels MCP sont refusés à la limite
Free et Pro ont une limite mensuelle d’appels MCP (plan_mcp_call_limit) qui se réinitialise le premier jour du mois suivant. Voir la politique d’usage raisonnable ou changez d’offre.