Fehlerbehebung
Die häufigsten Probleme beim Installieren und Verbinden.
command not found: sddvault
Dein Terminal wurde gestartet, bevor das Installationsprogramm PATH aktualisiert hat. Öffne ein neues Terminalfenster oder lade deine Shell neu:
PowerShell liest PATH beim Start. Schließe alle PowerShell-Fenster und öffne ein neues.
Es ist nicht in meinem PATH
Füge den Installationsordner selbst zu PATH hinzu und öffne dann ein neues Terminal.
Ich bin hinter einem Unternehmensproxy
Setze deinen Proxy, bevor du das Installationsprogramm ausführst. sddvault verwendet danach dieselben Variablen. Nutze NO_PROXY für Hosts, die direkt erreicht werden müssen.
Windows SmartScreen warnt vor einer nicht signierten App
Solange SDD Vault in der Beta ist, ist der Windows-Build nicht signiert, daher kann SmartScreen „Der Computer wurde durch Windows geschützt“ anzeigen. Wähle Weitere Informationen und dann Trotzdem ausführen. Tu das nur, wenn der Befehl von {host} stammt.
Der Agent sieht SDD Vault nicht
Starte den Agenten nach sddvault init neu. Prüfe, ob die Konfigurationsdatei existiert (.mcp.json, .cursor/mcp.json oder .vscode/mcp.json) und ob ihre URL den Slug deiner Organisation enthält. Prüfe bei einem Token, ob SDD_VAULT_TOKEN in der Umgebung gesetzt ist, in der der Agent läuft.
Die Anmeldung ist abgelaufen
Führe sddvault login erneut aus. sddvault whoami zeigt, wer angemeldet ist.
Ein Schreibvorgang wird mit conflict abgelehnt
Jemand hat das Dokument nach deinem letzten Lesen geschrieben. Lies die aktuelle Revision, führe deine Änderung zusammen und schreibe erneut mit dieser Revision als expected_revision.
MCP-Aufrufe werden am Limit abgelehnt
Free und Pro haben ein monatliches MCP-Aufruflimit (plan_mcp_call_limit), das am ersten Tag des nächsten Monats zurückgesetzt wird. Siehe die Richtlinie zur fairen Nutzung oder wechsle den Tarif.