coolify-mcp MCP工具

Install

You need a running Coolify v4 instance and an API token (Coolify → Settings → API).

Claude Desktop, one-click: download coolify-mcp.mcpb and drag it into Settings → Extensions. You'll be prompted for your Coolify URL and token. No Node install, no JSON editing.

Claude Code:

claude mcp add coolify \
  -e COOLIFY_BASE_URL="https://your-coolify-instance.com" \
  -e COOLIFY_ACCESS_TOKEN="your-api-token" \
  -- npx @masonator/coolify-mcp@latest

Codex CLI:

codex mcp add coolify \
  --env COOLIFY_BASE_URL="https://your-coolify-instance.com" \
  --env COOLIFY_ACCESS_TOKEN="your-api-token" \
  -- npx -y @masonator/coolify-mcp@latest

Any MCP client (JSON config):

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "@masonator/coolify-mcp"],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify-instance.com",
        "COOLIFY_ACCESS_TOKEN": "your-api-token"
      }
    }
  }
}

Behind Cloudflare Access or an auth proxy? Add --header "Key: Value" args (repeatable). The same config works in Cursor, Claude Code and any other MCP client, and can be repeated for multiple Coolify instances.

Remote (HTTP + OAuth, v3): deploy the server as a container inside your own Coolify and connect claude.ai or any remote MCP client to https://your-domain/mcp. Your Coolify token stays server-side; clients authenticate with OAuth 2.1. See docs/http-mode.md.

Coolify behind Cloudflare Access? Set CF_ACCESS_CLIENT_ID and CF_ACCESS_CLIENT_SECRET (a Cloudflare Access service token) and every request to COOLIFY_BASE_URL carries the Access headers — works in both stdio and HTTP mode. Setup in docs/http-mode.md.

Example prompts

Give me an overview of my infrastructure
Diagnose my stuartmason.co.uk app
Find any issues in my infrastructure
Deploy application {uuid} and wait for it to finish
Update the DATABASE_URL env var for application {uuid}
Create a staging environment in project {uuid}
Restart all applications in project {uuid}
How do I fix a 502 Bad Gateway error in Coolify?