WUNDERVAULT START FREE

Troubleshooting

Find the message you see.

In the agent's chat

If the agent says Claim expired

The claim code ran out: each lasts 15 minutes. Repair the agent and paste the new message.

If the agent says Claim already used

Each code works once. If the agent isn't connected, repair it for a new one.

If the agent says Unknown claim code

It was mistyped, or a newer repair replaced it. Copy the message again from your vault.

If the agent says Agent has been revoked

That agent was removed. Add it again.

If the agent says unauthorized

It has an old connection, usually after a repair. Paste the repair's message into its chat, and remove any WUNDERVAULT_AGENT_TOKEN line from its settings.

If the agent says wundervault-agent is not running for agent …

The broker isn't running on that computer, or the agent hasn't enrolled. Set up the computer, then paste the message again.

If the agent says an older copy of Wundervault … is still running

Restart the agent's app to close the old copy, then reconnect.

If the agent says WUNDERVAULT_AGENT_NAME is not set.

Its settings don't say which agent it is. Add the setting from Set it up yourself.

On the computer

If the computer says npm isn't found

Install Node.js 22.23.4, 24.22.1 or 26.12.1 or newer from nodejs.org, then open a new terminal.

If it says Node.js lacks the October 21, 2026 security fix

Install Node.js 22.23.4, 24.22.1 or 26.12.1 or newer, then run the step again.

If npm stops with a permission error (EACCES)

On Linux or macOS, run it again with sudo:

Terminal
sudo npm install -g @wundervault/mcp-server@2

If the app can't start wundervault-mcp

The app doesn't look where npm installs. Find the full path, and use it as the command in the app's settings:

Linux

Terminal
which wundervault-mcp

macOS

Terminal
which wundervault-mcp

Windows

PowerShell
(Get-Command wundervault-mcp).Source

In your vault

If the agent sees no secrets

You haven't given it any yet. Give it a secret.

If the agent says a use is waiting

That secret asks you first. Open Approvals in your vault and answer.

If the agent's name has an apostrophe, a quote or a backslash

The vault's message handles it. By hand, type each apostrophe as '\'' in the Claude Code line (PowerShell: ''), and in a settings file put a backslash before each double quote or backslash.

Still stuck? Tell us what the agent or the page said.