WUNDERVAULT START FREE

Add an agent

Make the agent in your vault, then paste one message into its chat.

Before you start

Step 1: Make the agent

  1. In your vault, open Agents and select Add an agent.
  2. Type the agent's name and choose the computer it runs on.
  3. Select Make the agent.
Add an agent in the vault: a name, the computer it runs on, and Make the agent Add an agent in the vault: a name, the computer it runs on, and Make the agent

Step 2: Paste the message into its chat

  1. Under Message for your agent, select Copy message.
  2. Paste it into the agent's chat.

The agent connects itself and lists the secrets it can see. None yet is normal: give it a secret.

The Message for your agent, with Copy message The Message for your agent, with Copy message

Set it up yourself

Under the message, open Or set it up yourself.

  1. On that computer, run this and paste the claim code when it asks:
    Terminal or PowerShell
    wundervault-agent --enrol
  2. Add Wundervault to the agent's settings, with its name exactly as in your vault.

    OpenClaw

    Terminal
    openclaw mcp add wundervault --command wundervault-mcp --env 'WUNDERVAULT_AGENT_NAME=Your agent'

    Claude Code

    Terminal
    claude mcp add --scope user wundervault -e 'WUNDERVAULT_AGENT_NAME=Your agent' -- wundervault-mcp

    Other apps

    Cursor (~/.cursor/mcp.json), Windsurf (~/.codeium/windsurf/mcp_config.json) and others: a new file takes all of this; a file that already has mcpServers takes only the "wundervault" part, inside it.

    Settings file
    {
  "mcpServers": {
    "wundervault": {
      "command": "wundervault-mcp",
      "env": { "WUNDERVAULT_AGENT_NAME": "Your agent" }
    }
  }
}

Several copies of one agent can run at once: they share its connection.

NextGive an agent a secret

Get help

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

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

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.

More in Troubleshooting.