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:

Terminal
exec $SHELL -l

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.

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

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.

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

Immer noch Probleme? Kontaktiere den Support. Wir antworten in der Regel innerhalb eines Werktags.