Dokploy MCP Server

by vcode-shio.github.vcode-sh/dokploy-mcpv4.0.0

Dokploy MCP server for Codex, Cursor, and Claude with compact stdio and hosted HTTP modes

4Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing3mo ago

Install Dokploy MCP server

claude mcp add dokploy-vcode-sh -e DOKPLOY_API_KEY='<dokploy-api-key>' -e DOKPLOY_PROFILES_JSON='<dokploy-profiles-json>' -- npx -y @vibetools/dokploy-mcp

{
  "mcpServers": {
    "dokploy-vcode-sh": {
      "command": "npx",
      "args": [
        "-y",
        "@vibetools/dokploy-mcp"
      ],
      "env": {
        "DOKPLOY_API_KEY": "<dokploy-api-key>",
        "DOKPLOY_PROFILES_JSON": "<dokploy-profiles-json>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "dokploy-vcode-sh": {
      "command": "npx",
      "args": [
        "-y",
        "@vibetools/dokploy-mcp"
      ],
      "env": {
        "DOKPLOY_API_KEY": "<dokploy-api-key>",
        "DOKPLOY_PROFILES_JSON": "<dokploy-profiles-json>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "dokploy-vcode-sh": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@vibetools/dokploy-mcp"
      ],
      "env": {
        "DOKPLOY_API_KEY": "<dokploy-api-key>",
        "DOKPLOY_PROFILES_JSON": "<dokploy-profiles-json>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "dokploy-vcode-sh": {
      "command": "npx",
      "args": [
        "-y",
        "@vibetools/dokploy-mcp"
      ],
      "env": {
        "DOKPLOY_API_KEY": "<dokploy-api-key>",
        "DOKPLOY_PROFILES_JSON": "<dokploy-profiles-json>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
DOKPLOY_URL	—	—	Optional when local Dokploy credentials already exist. Otherwise provide the Dokploy panel URL.
DOKPLOY_API_KEY	—	yes	Optional when local Dokploy credentials already exist. Otherwise provide the Dokploy API key.
DOKPLOY_PROFILES_JSON	—	yes	Optional JSON object of named Dokploy targets. Use this when you want explicit named profiles in addition to the local default target.

Remote endpoints

streamable-httphttps://{remoteHost}{mcpPath}

Freshness

Slowing — last maintenance signal 3mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-07-09 · 3mo ago · GitHub
Latest release
2026-07-09 · 3mo ago · GitHub · v4.0.0
Package published
no data · npm/PyPI
Registry entry updated
2026-07-09 · 3mo ago · official registry · v4.0.0

FAQ

›How do I install the Dokploy MCP server in Claude Code?

Run: claude mcp add dokploy-vcode-sh -e DOKPLOY_API_KEY='<dokploy-api-key>' -e DOKPLOY_PROFILES_JSON='<dokploy-profiles-json>' -- npx -y @vibetools/dokploy-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Dokploy require an API key?

Yes. It expects DOKPLOY_API_KEY, DOKPLOY_PROFILES_JSON, of which 2 are secrets.

›Can I use Dokploy as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Dokploy in the official MCP registry?

Yes, as io.github.vcode-sh/dokploy-mcp.