# Pryazilim ClickUp MCP Server 🚀

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![MCP](https://img.shields.io/badge/MCP-1.0-blue)](https://modelcontextprotocol.io)
[![Security](https://img.shields.io/badge/Security-Enhanced-green)](https://github.com/pryazilim/clickup-mcp-server)

Güvenli ve optimize edilmiş ClickUp entegrasyonu için Model Context Protocol (MCP) sunucusu.

A secure and optimized Model Context Protocol (MCP) server for ClickUp integration.

## 🌟 Özellikler / Features

### 🔒 Güvenlik / Security
- ✅ Varsayılan olarak tüm güvenlik özellikleri aktif / All security features enabled by default
- ✅ HTTPS desteği / HTTPS support
- ✅ CORS ve origin doğrulama / CORS and origin validation
- ✅ Rate limiting
- ✅ Dosya yükleme doğrulaması / File upload validation
- ✅ Hassas bilgiler log dosyalarında maskelenir / Sensitive information masked in logs

### 🎯 İşlevsellik / Functionality
- 📋 Tam kapsamlı görev yönetimi (CRUD işlemleri) / Complete task management (CRUD operations)
- 📁 Çalışma alanı organizasyonu (spaces, folders, lists) / Workspace organization
- 🔄 Toplu işlemler / Bulk operations
- 📎 Dosya ekleme desteği / File attachment support
- 🏷️ Etiket yönetimi / Tag management
- ⏰ Doğal dil tarih işleme / Natural language date parsing
- 👥 Takım üyesi yönetimi / Team member management

### 🌍 Dil Desteği / Language Support
- 🇹🇷 Türkçe dokümantasyon ve yorumlar / Turkish documentation and comments
- 🇬🇧 İngilizce dokümantasyon / English documentation

## 📋 Gereksinimler / Requirements

- Node.js >= 18.0.0
- ClickUp API anahtarı / ClickUp API key
- ClickUp Team ID

## 🚀 Kurulum / Installation

### NPM ile / With NPM
```bash
npm install @pryazilim/clickup-mcp-server
```

### Kaynak koddan / From source
```bash
git clone https://github.com/karaokmert/pryazilim-clickup-mcp.git
cd pryazilim-clickup-mcp
npm install
npm run build
```

## ⚙️ Yapılandırma / Configuration

### Ortam Değişkenleri / Environment Variables

```bash
# Zorunlu / Required
CLICKUP_API_KEY=your_api_key
CLICKUP_TEAM_ID=your_team_id

# Güvenlik (varsayılan: true) / Security (default: true)
ENABLE_SECURITY_FEATURES=true
ENABLE_HTTPS=true
ENABLE_ORIGIN_VALIDATION=true
ENABLE_RATE_LIMIT=true
ENABLE_CORS=true

# HTTPS Sertifikaları / HTTPS Certificates
SSL_KEY_PATH=/path/to/key.pem
SSL_CERT_PATH=/path/to/cert.pem

# Log Seviyesi / Log Level
LOG_LEVEL=ERROR  # TRACE, DEBUG, INFO, WARN, ERROR

# Sunucu / Server
PORT=3231
HTTPS_PORT=3443
```

### Claude Desktop Yapılandırması / Claude Desktop Configuration

`claude_desktop_config.json` dosyanıza ekleyin / Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "pryazilim-clickup": {
      "command": "npx",
      "args": ["@pryazilim/clickup-mcp-server"],
      "env": {
        "CLICKUP_API_KEY": "your_api_key",
        "CLICKUP_TEAM_ID": "your_team_id",
        "LOG_LEVEL": "ERROR"
      }
    }
  }
}
```

## 🔧 Kullanım Örnekleri / Usage Examples

### Görev Oluşturma / Create Task
```
"ProjectX için yeni bir görev oluştur: 'API entegrasyonunu tamamla', öncelik yüksek, bitiş tarihi yarın"
"Create a new task in ProjectX: 'Complete API integration', priority high, due tomorrow"
```

### Görev Güncelleme / Update Task
```
"API entegrasyonu görevinin durumunu 'devam ediyor' olarak güncelle"
"Update the API integration task status to 'in progress'"
```

### Dosya Ekleme / Attach File
```
"Tasarım dosyasını göreve ekle: /path/to/design.pdf"
"Attach design file to task: /path/to/design.pdf"
```

## 🛡️ Güvenlik Özellikleri / Security Features

### Dosya Doğrulama / File Validation
- ✅ İzin verilen dosya uzantıları kontrolü / Allowed file extensions check
- ✅ Maksimum dosya boyutu limiti (100MB) / Maximum file size limit (100MB)
- ✅ MIME type doğrulaması / MIME type validation
- ❌ Çalıştırılabilir dosyalar engellenir / Executable files blocked

### API Güvenliği / API Security
- 🔑 API anahtarı güvenli şekilde saklanır / API key stored securely
- 🚦 Rate limiting (dakikada 100 istek) / Rate limiting (100 requests per minute)
- 🔒 HTTPS ile şifreli iletişim / Encrypted communication with HTTPS

## 📝 Notlar / Notes

- Production ortamında `LOG_LEVEL=ERROR` kullanın / Use `LOG_LEVEL=ERROR` in production
- HTTPS sertifikalarınızı güvenli bir yerde saklayın / Store your HTTPS certificates securely
- API anahtarınızı asla paylaşmayın / Never share your API key

## 🤝 Katkıda Bulunma / Contributing

Pull request'ler kabul edilir. Büyük değişiklikler için önce bir issue açın.
Pull requests are welcome. For major changes, please open an issue first.

## 📄 Lisans / License

MIT - Detaylar için [LICENSE](LICENSE) dosyasına bakın / See [LICENSE](LICENSE) for details

## 🙏 Teşekkürler / Credits

Original author: Talib Kareem
Güvenlik iyileştirmeleri ve Türkçe desteği: Pryazilim Team

## 📧 İletişim / Contact

- Email: info@pryazilim.com
- GitHub: [https://github.com/karaokmert/pryazilim-clickup-mcp](https://github.com/karaokmert/pryazilim-clickup-mcp)
- Issues: [https://github.com/karaokmert/pryazilim-clickup-mcp/issues](https://github.com/karaokmert/pryazilim-clickup-mcp/issues)

## 🔄 Değişiklik Geçmişi / Changelog

### v1.0.0 (2024)
- 🔒 Tüm güvenlik özellikleri varsayılan olarak aktif / All security features enabled by default
- 📝 Console.log ifadeleri kaldırıldı / Removed console.log statements
- 📁 Dosya yükleme doğrulaması eklendi / Added file upload validation
- 🌍 Türkçe dokümantasyon eklendi / Added Turkish documentation
- 🚀 Pryazilim özelleştirmeleri / Pryazilim customizations

---

**Pryazilim** - Güvenli ve güvenilir yazılım çözümleri / Secure and reliable software solutions