Dokploy

Deploy and manage applications on VPS through Dokploy. Control deployments, environment variables, domains, and databases.

MCP Server·3 sections·1 min read

devopscoding

Install Prompt

Paste this into Claude Code to set it up:

I want to add the Dokploy MCP Server to my Claude Code setup.

IMPORTANT: Never use Read/Edit tools on ~/.claude.json. Use jq via Bash instead.

Prerequisites: You need a running Dokploy instance on your VPS and an API token. Generate the token from your Dokploy dashboard settings.

Run this command to add the MCP server (replace the URL and token with your actual values):
```bash
jq '.mcpServers["dokploy"] = {"type": "stdio", "command": "npx", "args": ["-y", "dokploy-mcp@latest"], "env": {"DOKPLOY_API_URL": "https://your-dokploy-instance.com", "DOKPLOY_API_TOKEN": "your-api-token"}}' ~/.claude.json > /tmp/claude-json-tmp && mv /tmp/claude-json-tmp ~/.claude.json
```

After adding, restart Claude Code. The server connects to your Dokploy instance and gives the agent control over applications, databases, domains, and deployment pipelines.

01What It Does

Your self hosted deployment platform, from the terminal

Dokploy is a self hosted alternative to platforms like Vercel and Railway, running on your own VPS. The MCP server connects your AI agent directly to it, so you can deploy applications, manage databases, configure domains, and update environment variables without opening the Dokploy dashboard. Combined with the GitHub MCP, you get a complete CI/CD pipeline controlled entirely from your conversation.

🚢

Application DeploymentsDeploy, redeploy, start, stop, and manage applications. Configure build types, connect git providers, and manage deployment queues.

🗄️

Database ManagementCreate and manage PostgreSQL and MySQL databases. Configure external ports, update environment variables, and control database lifecycle.

🌐

Domain ConfigurationAdd, update, and validate custom domains for your applications. Generate Traefik domains and manage SSL certificates automatically.

02Setup

# Add to ~/.claude.json under mcpServers
"dokploy": {
  "type": "stdio",
  "command": "npx",
  "args": ["-y", "dokploy-mcp@latest"],
  "env": {
    "DOKPLOY_API_URL": "https://your-instance.com",
    "DOKPLOY_API_TOKEN": "your-token"
  }
}

If you manage multiple Dokploy instances (for example, personal and company servers), add separate MCP entries with different names and credentials. Each connects independently.

03Available Tools

📋

Project OrganizationCreate, list, duplicate, and remove projects. Projects group related applications and databases together.

🔄

Deployment PipelineDeploy from GitHub, GitLab, Bitbucket, or Docker images. Cancel deployments, clean queues, and reload configurations.

⚙️

Environment and ConfigUpdate environment variables, modify Traefik configurations, and manage application settings without redeploying.