# Coolify MCP 서버

Coolify를 위한 가장 포괄적인 모델 컨텍스트 프로토콜(MCP) 서버입니다. Claude, Cursor, Claude Code와 같은 AI 어시스턴트가 셀프호스팅 PaaS를 관리할 수 있게 합니다 — 자연어를 통해 애플리케이션 배포, 인프라 디버깅, 배치 작업 실행, 문서 검색이 가능합니다.

Canonical URL: https://a2a-mcp.org/entry/coolify-mcp-ko

Language: ko

Category: MCP Servers

Updated: 2026-04-01

## 개요

**Coolify MCP 서버**는 인기 있는 오픈소스 셀프 호스팅 PaaS인 [Coolify](https://coolify.io/)(Heroku, Vercel, Netlify의 대안)를 위한 최고의 커뮤니티 구축 Model Context Protocol (MCP) 서버입니다. AI 코딩 어시스턴트(Claude Desktop, Cursor, Claude Code 등)가 자연어 명령을 사용하여 Coolify 인스턴스를 완전히 관리하고 디버깅할 수 있도록 합니다.

**38개의 최적화된 도구**, 스마트 리소스 조회(UUID 대신 이름/도메인/IP), 토큰 효율적인 응답 및 내장된 전문 텍스트 문서 검색 기능을 통해, AI를 셀프 호스팅 배포를 위한 강력한 DevOps 공동 조종사로 만들어줍니다.

## 주요 기능

- **38개 최적화 도구**: 인프라, 서버, 프로젝트, 애플리케이션, 데이터베이스, 서비스, 배포, 환경 변수, 개인 키, 팀, 클라우드 토큰(Hetzner, DigitalOcean) 등을 포괄합니다.
- **스마트 진단**: 사람이 읽기 쉬운 식별자를 사용하는 `diagnose_app`, `diagnose_server`, `find_issues`.
- **일괄 작업**: 전체 프로젝트 재시작, 일괄 환경 업데이트, 여러 앱 중지/재배포.
- **토큰 효율성**: 응답이 원시 Coolify API보다 85~99% 더 작습니다(예: list_applications가 ~170KB에서 ~4.4KB로 축소).
- **전문 텍스트 문서 검색**: 1,500개 이상의 Coolify 문서 청크를 내장 검색.
- **HATEOAS 스타일 응답**: 더 나은 AI 컨텍스트를 위한 제안된 다음 작업 및 페이징 포함.
.

- **프로덕션 준비 완료**: 98% 이상 테스트 커버리지, 엄격한 TypeScript, 견고한 오류 처리.

## 사용 사례

- **AI 기반 배포**: "GitHub 저장소 X의 Next.js 앱을 프로덕션에 배포해 줘."
- **인프라 관리**: "모든 서버를 나열하고, 리소스 사용량을 표시하고, 데이터베이스 서버를 재시작해 줘."
- **디버깅 및 진단**: "내 앱이 왜 실패하는지 진단하고 해결 방법을 제안해 줘."
- **일괄 관리**: "프로젝트 Y의 모든 앱에서 환경 변수를 업데이트하고 재배포해 줘."
- **문서 지원**: "PostgreSQL 백업 설정 방법을 Coolify 문서에서 검색해 줘."
- **완전한 DevOps 워크플로**: 다른 MCP 서버와 결합하여 엔드투엔드 AI 조율 배포 파이프라인 구성.

## 설치 (가장 쉬운 방법)

### npx를 통해 (Claude Desktop / Cursor / Claude Code에 권장)

```bash
# Claude Desktop용 – claude_desktop_config.json에 추가
npx -y @masonator/coolify-mcp
```

다음 환경 변수를 설정하세요:
- `COOLIFY_ACCESS_TOKEN` (Coolify API 토큰)
- `COOLIFY_BASE_URL` (예: `https://your-coolify-instance.com`)

**Claude Code용 빠른 한 줄 명령**:
```bash
claude mcp add coolify -e COOLIFY_ACCESS_TOKEN=xxx -e COOLIFY_BASE_URL=https://your-coolify.com -- npx @masonator/coolify-mcp@latest
```

전체 소스 및 Docker/수동 설정은 저장소에서 확인할 수 있습니다.

## 호환성

- **클라이언트**: Claude Desktop, Cursor, Claude Code, 모든 MCP 호환 AI 도구.
- **Coolify 버전**: v4.0.0-beta.460+에서 테스트됨 (기능 자동 감지).
- **라이선스**: MIT

## 커뮤니티 & 대안

이것은 가장 활발하게 관리되고 기능이 풍부한 구현체입니다(2026년 2월 기준 v2.7.3), 공식 MCP 레지스트리에 등록되어 있습니다. 향상된 포크 버전(예: dazeb/coolify-mcp-enhanced)은 필요한 경우 추가 배포 도구를 제공합니다.

오늘부터 AI를 통해 셀프 호스팅 PaaS를 관리해 보세요 — Coolify MCP 서버가 DevOps를 대화형으로 손쉽게 만듭니다.

## Tags

- 쿨리파이
- MCP
- PaaS
- 셀프호스팅
- 배포
- 데브옵스
- AI 통합
- 클로드
- 커서
- 인프라

## Sources

- [Project website](https://github.com/StuMason/coolify-mcp)