Ön koşullar
- Linux (Ubuntu/Debian/CentOS vb.) veya macOS
- 2 GB+ RAM, 10 GB+ boş disk alanı
- Genel npm registry’sine erişebilen shell erişimi
- Node.js 18.x veya 20.x LTS (bkz. Adım 1)
- Etkin bir API anahtarına sahip bir CometAPI hesabı — buradan alın
1
CometAPI API anahtarınızı alın
CometAPI konsolunda oturum açın. Add API Key seçeneğine tıklayın ve CometAPI API anahtarınızı kopyalayın.



2
Node.js'i nvm ile yükleyin
n8n 1.x, Node.js 18.x veya 20.x gerektirir. Önerilen yaklaşım nvm’dir:
Daha sonra
n8n: command not found görürseniz terminali yeniden başlatın veya nvm tarafından yönetilen npm global bin dizininin PATH içinde olduğundan emin olun.3
n8n'i yükleyin ve başlatın


4
Owner hesabınızı oluşturun
Tarayıcınızda http://localhost:5678/ adresini açın. İlk çalıştırmada, kurulum sihirbazı sizden bir Owner hesabı (e-posta + parola) oluşturmanızı ister. Bunu tamamlayın ve oturum açın.

5
CometAPI community node'unu yükleyin
- Settings’e gidin (sol alt) → Community nodes
- Install a community node seçeneğine tıklayın
- Paket adını girin:
@cometapi-dev/n8n-nodes-cometapi - Risk onayı kutusunu işaretleyin ve Install seçeneğine tıklayın


Community Nodes bölümü görünmüyorsa: Owner hesabıyla oturum açtığınızdan emin olun ve community node kurulumunun etkin olduğunu doğrulamak için Settings → Security bölümünü kontrol edin.
6
Bir workflow oluşturun ve credentials yapılandırın
- Bir workflow oluşturmak için üstteki + New seçeneğine tıklayın.
- Tuval üzerinde + seçeneğine tıklayın ve node’u eklemek için CometAPI aratın.


- Bir Manual Trigger node’u ekleyin ve bunu CometAPI node’una bağlayın.
- CometAPI node’unda, Credential to connect with altında Create new seçeneğini seçin. CometAPI API anahtarınızı CometAPI Key alanına yapıştırın ve Save seçeneğine tıklayın. Base URL varsayılan olarak
https://api.cometapi.comolur ve genellikle değiştirilmesi gerekmez.

- node’u yapılandırın:
- Model: kullanmak istediğiniz güncel model ID değerini girin
- Messages: Role değerini
user, Content değerini test prompt’unuz olarak ayarlayın (ör.Hello) - İsteğe bağlı: bir
systemmesajı ekleyin, Max Tokens, Temperature vb. ayarlayın
- node’u çalıştırmak için Execute step seçeneğine tıklayın. Output paneli JSON yanıtını gösterir.

Sorun giderme
Sorun giderme
node-gypveya native build hataları — build araçlarını yükleyin:sudo apt install build-essential python3(Debian/Ubuntu) veya Xcode Command Line Tools (macOS).- npm izin hataları (EACCES) — kullanıcı düzeyinde bir Node.js kurulumu için nvm kullanın;
sudogerekmez. - Port çakışması (
localhost:5678kullanılamıyor) —n8n startçalıştırmadan önceN8N_PORT=5679(veya başka bir boş port) ayarlayın. - Community Nodes bölümü eksik — Owner hesabıyla oturum açın ve Settings → Security bölümünü kontrol edin.
- Kurumsal ağlarda npm install başarısız oluyor — bir proxy yapılandırın:
npm config set proxy http://user:pass@host:port - CometAPI node’u 401/403 döndürüyor — API anahtarınızı ve modelin CometAPI planınızda erişilebilir olduğunu doğrulayın.
- Boş yanıtlar veya token limit hataları — Max Tokens değerini artırın; gerektiğinde Temperature ve Top P değerlerini ayarlayın.
- Terminal kapandığında n8n duruyor — pm2 kullanın:
pm2 start "n8n" --name n8n && pm2 save.