← Back to Dokploy MCP Server

Install Dokploy MCP Server

Pick your client, copy the command, done.

1

Add it to Claude Code

claude mcp add -e "DOKPLOY_URL=${DOKPLOY_URL}" -e "DOKPLOY_API_KEY=${DOKPLOY_API_KEY}" dokploy-mcp -- npx -y @ahdev/dokploy-mcp
Required:DOKPLOY_URLDOKPLOY_API_KEY

Environment Variables

Set these before running Dokploy MCP Server.

VariableDescriptionRequired
DOKPLOY_URLThe base URL of your Dokploy server APIYes
DOKPLOY_API_KEYThe API token for authenticating with your Dokploy instanceYes

Available Tools (1)

Once configured, Dokploy MCP Server gives your AI agent access to:

dokploy_api_operationsExecutes direct API operations for project and application management on Dokploy servers.
endpointmethodpayload

Try It Out

After setup, try these prompts with your AI agent:

List all the projects currently deployed on my Dokploy server.
Check the status of the application with ID 'my-app-id'.
Trigger a new deployment for the production environment of my web project.
Get the logs for the latest deployment of my backend service.
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Node.js 18+ with npm/npx installed
  • DOKPLOY_URL — The base URL of your Dokploy server API
  • DOKPLOY_API_KEY — The API token for authenticating with your Dokploy instance
Alternative installation methods

Cursor

npx -y @ahdev/dokploy-mcp

VS Code

npx -y @ahdev/dokploy-mcp

Keep this setup from going cold

Save the docs, env vars, and workflow around Dokploy MCP Server in Conare so Claude Code, Codex, and Cursor remember it next time.

Remember this setup