Claude, Cursor 또는 모든 MCP 클라이언트에서 Coolify를 관리하기: 셀프 호스팅 PaaS를 배포, 디버깅, 운영할 수 있는 46가지 도구, 쉬운 영어로 설명하세요. 파괴적인 작업은 먼저 사람에게 요청합니다; 비밀은 숨기세요.

📖 coolify-mcp.stumason.dev · 도구 참고 · 프롬프트 및 자료 · 원격 / HTTP 모드 · 플릿 · 의사 · 안전 및 보안 · 변경 기록

설치

실행 중인 Coolify v4 인스턴스와 API 토큰(Coolify → 키 및 토큰 → API 토큰)이 필요합니다. 서버를 실행하는 세 가지 방법 중 하나를 선택하세요.

Claude 데스크톱, 원클릭. coolify-mcp.mcpb를 다운로드하여 확장 프로그램 설정→ 드래그하세요. Coolify URL과 토큰을 입력하라는 안내가 나옵니다. 노드 설치나 JSON 편집은 없습니다.

로컬 내 모든 MCP 클라이언트에서. Claude 코드:

Codex CLI는 codex mcp add와 [--env와 동일합니다. 커서, Claude Desktop 또는 JSON 설정을 사용하는 모든 것에 대해:

원격으로, Coolify 내부의 컨테이너로 운영됩니다. 서버를 Coolify가 관리하는 Coolify 옆에 서버를 배포하고, claude.ai, Claude Desktop 또는 Claude Code를 https://your-domain/mcp에 연결하세요. Coolify 토큰은 서버 측에 머무릅니다; 클라이언트는 OAuth 2.1로 인증합니다. docs/http-mode.md에서 5분 만에 설정할 수 있습니다.

그럼 닥터, 달려가세요

Coolify MCP Server

Manage Coolify from Claude, Cursor, or any MCP client: 46 tools for deploying, debugging, and operating your self-hosted PaaS in plain English. Destructive operations ask a human first; secrets stay masked.

📖 coolify-mcp.stumason.dev · Tool reference · Prompts and resources · Remote / HTTP mode · Fleet · Doctor · Safety and security · Changelog

Install

You need a running Coolify v4 instance and an API token (Coolify → Keys & Tokens → API tokens). Pick one of three ways to run the server.

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

Locally, in any MCP client. 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 is the same with codex mcp add and --env. For Cursor, Claude Desktop or anything that takes a 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"
      }
    }
  }
}

Remotely, as a container inside your Coolify. Deploy the server next to the Coolify it manages and connect claude.ai, Claude Desktop or Claude Code to https://your-domain/mcp. Your Coolify token stays server-side; clients authenticate with OAuth 2.1. Five-minute setup in docs/http-mode.md.

Then run doctor

Whatever you configured, verify it in one command: