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

npm install @pryazilim/clickup-mcp-server

Kaynak koddan / From source

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

# 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:

{
  "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 dosyasına bakın / See 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: [email protected]
• GitHub: 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