What is the Helmdeck MCP server?
Self-hosted MCP server: sandboxed browser, desktop, vision, code-edit packs for any agent.
How to install Helmdeck
Copy-paste configuration for popular MCP clients.
transport: stdio
Config generated by PluginBench — verify against the source before use.Environment / auth
HELMDECK_URLrequiredBase URL of your helmdeck control plane (e.g. http://localhost:3000 for a local Compose install, or your reverse-proxied https URL)
HELMDECK_TOKENrequiredsecretJWT bearer token minted from your helmdeck control plane. Generate with: curl -X POST $HELMDECK_URL/api/v1/auth/login -d '{"username":"admin","password":"..."}'
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"helmdeck": {
"command": "npx",
"args": [
"-y",
"@helmdeck/mcp-bridge"
],
"env": {
"HELMDECK_URL": "<YOUR_HELMDECK_URL>",
"HELMDECK_TOKEN": "<YOUR_HELMDECK_TOKEN>"
}
}
}
}Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"helmdeck": {
"command": "npx",
"args": [
"-y",
"@helmdeck/mcp-bridge"
],
"env": {
"HELMDECK_URL": "<YOUR_HELMDECK_URL>",
"HELMDECK_TOKEN": "<YOUR_HELMDECK_TOKEN>"
}
}
}
}Windsurf
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"helmdeck": {
"command": "npx",
"args": [
"-y",
"@helmdeck/mcp-bridge"
],
"env": {
"HELMDECK_URL": "<YOUR_HELMDECK_URL>",
"HELMDECK_TOKEN": "<YOUR_HELMDECK_TOKEN>"
}
}
}
}VS Code
.vscode/mcp.json
{
"servers": {
"helmdeck": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@helmdeck/mcp-bridge"
],
"env": {
"HELMDECK_URL": "<YOUR_HELMDECK_URL>",
"HELMDECK_TOKEN": "<YOUR_HELMDECK_TOKEN>"
}
}
}
}Claude Code
claude mcp add helmdeck --env HELMDECK_URL=<YOUR_HELMDECK_URL> --env HELMDECK_TOKEN=<YOUR_HELMDECK_TOKEN> -- npx -y @helmdeck/mcp-bridgeRelated MCP servers
AI-powered MCP server for analyzing Architectural Decision Records (ADRs).
View repository →