MCP Server

Dokploy MCP MCP Server

Name: Dokploy MCP MCP Server
Author: io.github.vcode-sh

io.github.vcode-sh/dokploy-mcp

Repository Registry

What is the Dokploy MCP MCP server?

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

How to install Dokploy MCP

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

DOKPLOY_URL
Optional when local Dokploy credentials already exist. Otherwise provide the Dokploy panel URL.
DOKPLOY_API_KEY
secret
Optional when local Dokploy credentials already exist. Otherwise provide the Dokploy API key.
DOKPLOY_PROFILES_JSON
secret
Optional JSON object of named Dokploy targets. Use this when you want explicit named profiles in addition to the local default target.
X-Dokploy-Url
required
Dokploy panel URL for this request. Accepts the panel URL, /api, or /api/trpc and is normalized automatically.
X-Dokploy-Api-Key
required
secret
Dokploy API key from Settings > Profile > API/CLI.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "dokploy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@vibetools/dokploy-mcp"
      ],
      "env": {
        "DOKPLOY_URL": "<YOUR_DOKPLOY_URL>",
        "DOKPLOY_API_KEY": "<YOUR_DOKPLOY_API_KEY>",
        "DOKPLOY_PROFILES_JSON": "<YOUR_DOKPLOY_PROFILES_JSON>",
        "X-Dokploy-Url": "<YOUR_X_DOKPLOY_URL>",
        "X-Dokploy-Api-Key": "<YOUR_X_DOKPLOY_API_KEY>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "dokploy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@vibetools/dokploy-mcp"
      ],
      "env": {
        "DOKPLOY_URL": "<YOUR_DOKPLOY_URL>",
        "DOKPLOY_API_KEY": "<YOUR_DOKPLOY_API_KEY>",
        "DOKPLOY_PROFILES_JSON": "<YOUR_DOKPLOY_PROFILES_JSON>",
        "X-Dokploy-Url": "<YOUR_X_DOKPLOY_URL>",
        "X-Dokploy-Api-Key": "<YOUR_X_DOKPLOY_API_KEY>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "dokploy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@vibetools/dokploy-mcp"
      ],
      "env": {
        "DOKPLOY_URL": "<YOUR_DOKPLOY_URL>",
        "DOKPLOY_API_KEY": "<YOUR_DOKPLOY_API_KEY>",
        "DOKPLOY_PROFILES_JSON": "<YOUR_DOKPLOY_PROFILES_JSON>",
        "X-Dokploy-Url": "<YOUR_X_DOKPLOY_URL>",
        "X-Dokploy-Api-Key": "<YOUR_X_DOKPLOY_API_KEY>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "dokploy-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@vibetools/dokploy-mcp"
      ],
      "env": {
        "DOKPLOY_URL": "<YOUR_DOKPLOY_URL>",
        "DOKPLOY_API_KEY": "<YOUR_DOKPLOY_API_KEY>",
        "DOKPLOY_PROFILES_JSON": "<YOUR_DOKPLOY_PROFILES_JSON>",
        "X-Dokploy-Url": "<YOUR_X_DOKPLOY_URL>",
        "X-Dokploy-Api-Key": "<YOUR_X_DOKPLOY_API_KEY>"
      }
    }
  }
}

Claude Code

claude mcp add dokploy-mcp --env DOKPLOY_URL=<YOUR_DOKPLOY_URL> --env DOKPLOY_API_KEY=<YOUR_DOKPLOY_API_KEY> --env DOKPLOY_PROFILES_JSON=<YOUR_DOKPLOY_PROFILES_JSON> --env X-Dokploy-Url=<YOUR_X_DOKPLOY_URL> --env X-Dokploy-Api-Key=<YOUR_X_DOKPLOY_API_KEY> -- npx -y @vibetools/dokploy-mcp