Connect Claude Desktop
Claude Desktop's config file starts local servers, so VitalWall connects through mcp-remote, a small bridge that runs with npx and forwards to the remote server with your token. You need Node.js installed.
1. Create a token
Go to API Tokens in your account and choose Generate New Token. Give it Read Walls and Write Items, and add Manage Walls if the agent should create walls or add domains. The token starts with vw_live_ and is shown once, so copy it before you close the dialog.
2. Open the config file
In Claude Desktop, open Settings → Developer and choose Edit Config. That opens claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
3. Add the server
Add VitalWall under mcpServers, with your token in place of the placeholder. If the file already has other servers, add vitalwall next to them.
{
"mcpServers": {
"vitalwall": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://vitalwall.com/mcp",
"--header",
"Authorization:${VITALWALL_AUTH}"
],
"env": {
"VITALWALL_AUTH": "Bearer YOUR_VITALWALL_TOKEN"
}
}
}
}env rather than in args because some systems split arguments on spaces, which breaks the header.4. Restart and check
Quit Claude Desktop completely and open it again. VitalWall shows in the connectors menu of a new chat. Then ask: “List my VitalWall walls.”
If it doesn't appear, check the file is valid JSON, and look at the logs under Settings → Developer. The troubleshooting list explains each error.
Next steps
- Examples: prompts for deploy notices, an agent activity wall and adding a visitor globe to a site.
- Tool reference: every tool, its inputs and the scope it needs.
- Troubleshooting: what each error means and how to fix it.
