Kurulum - ComfyUI MCP

1. ComfyUI’yi kurun

ComfyUI Desktop

macOS / Windows’ta yönetilen bir kurulum edinmenin en kolay yolu.

Kaynaktan

Klonlayıp elle çalıştırın — ya da install_comfyui aracını kullanın.

2. MCP sunucusunu ekleyin

ComfyUI MCP, npm’de comfyui-mcp olarak yayımlanır ve npx ile çalışır — global kuruluma gerek yoktur.

Yerel ComfyUI
Uzak ComfyUI
Comfy Cloud

Sunucu, yerel kurulumu ve portunu kendiliğinden algılar. ~/.claude/settings.json dosyasına ekleyin:

{
  "mcpServers": {
    "comfyui": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp"]
    }
  }
}

--comfyui-url ile erişilebilen herhangi bir örneği hedefleyin. HTTP tabanlı araçlar (üretim, kuyruk, iş akışları, model arama vb.) için yerel kurulum gerekmez. Ana makine loopback dışındaysa sunucu uzak kipe geçer ve COMFYUI_PATH otomatik algılamasını atlar; böylece eski kalmış bir yerel kurulum yüklemeleri sessizce içine çekemez.

{
  "mcpServers": {
    "comfyui": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp", "--comfyui-url", "https://my-comfy.example.com"]
    }
  }
}

Araçların çoğu uzak bir ComfyUI ile sorunsuz çalışır — ComfyUI-Manager HTTP API’si üzerinden özel düğüm kurulumu da buna dahildir. Gerçekten yerel bir kurulum yolu gerektirenler şunlardır: ComfyUI’nin kendisini kurmak, comfy-cli tabanlı işlemler, günlükleri okumak ve model dosyalarını silmek; bunlar uzak kipte açık bir hata döndürür. Bkz. Nasıl çalışır.

COMFYUI_API_KEY ayarlayarak Comfy Cloud hedefleyin. Sunucu bulut kipine geçer: HTTP temel işlemleri X-API-Key kimlik doğrulamasıyla cloud.comfy.org üzerinden yönlendirilir. WebSocket’e bağlı araçlar ile yerel dosya sistemi/süreç araçları açık bir CLOUD_UNSUPPORTED hatası fırlatır.

{
  "mcpServers": {
    "comfyui": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp"],
      "env": {
        "COMFYUI_API_KEY": "your-comfy-cloud-api-key"
      }
    }
  }
}

Bulut kipi yerel COMFYUI_PATH otomatik algılamasını atlar ve bulutun kendi model kitaplığını kullanır. Yerel bir sürece ya da dosya sistemine uzanan araçlar CLOUD_UNSUPPORTED fırlatır; diğerleri hata fırlatmak yerine kısıtlı çalışır — list_local_models boş bir liste döndürür, apply_manifest ise topluca hata vermek yerine öğe başına skipped/failed bildirir. Tam özellik denklik tablosu için Yapılandırma sayfasına bakın.

Yalnızca bulut mu? Comfy-Org’un Comfy Cloud MCP’si (herkese açık beta) buradaki asıl seçenektir — bkz. Yerel ile Comfy Cloud karşılaştırması. Yerel / uzak / bulut için tek bir MCP istiyorsanız ya da bugün bulut desteğine ihtiyacınız varsa comfyui-mcp’nin bulut kipini kullanın.

Sonra bağlanmak için Claude Code’da /mcp çalıştırın.

3. Panel orkestratörünü başlatma

Yalnızca kenar çubuğu paneli için gereklidir. ComfyUI’yi Claude Code ya da başka bir MCP istemcisinden sürüyorsanız bu adımı atlayın — o yol, yukarıda yapılandırdığınız MCP sunucusunu kullanır. Panel, saf ön uç bir ComfyUI eklentisidir: makinenizde bir süreç başlatamaz, bu yüzden orkestratörü siz başlatırsınız ve panel ona bağlanır.

npx -y comfyui-mcp@latest connect

Bu, --panel-orchestrator için bir kısayoldur. Tarayıcınızın üzerinde olduğu ComfyUI’yi kendiliğinden hedefler, köprüyü ws://127.0.0.1:9180 üzerinde sunar (COMFYUI_MCP_BRIDGE_PORT ile değiştirilebilir) ve paneli kullandığınız sürece çalışır durumda kalmalıdır. Sonra Ajan sekmesini açın, bir sağlayıcı seçin ve Bağlan’a tıklayın. Uzak bir ComfyUI mi sürüyorsunuz — bir bulut podu ya da yerel ağınızdaki başka bir makine? Aynı komutu uzaktaki makinede değil, kendi makinenizde çalıştırın ve adresi verin:

npx -y comfyui-mcp@latest connect https://your-pod-url

Sağlayıcı girişiniz ve ajan yerelde kalır; uzak ana makineye hiçbir şey kurulmaz. Tünel ayrıntıları için Bulut dağıtımı sayfasına bakın.

4. (İsteğe bağlı) Token’lar

Bazı araçlar API token’ları kullanır. Bunları sunucunun env bloğunda ayarlayın (bkz. Yapılandırma):

CIVITAI_API_TOKEN — kısıtlı CivitAI indirmeleri
HUGGINGFACE_TOKEN — daha yüksek HuggingFace hız sınırları
GITHUB_TOKEN — skill üretimi / düğüm meta verisi çekme
COMFY_API_KEY — barındırılan comfy.org API düğümleri

Yerel geliştirme

Proje npm link kullanır; böylece npx comfyui-mcp yerel derlemenize çözümlenir:

git clone https://github.com/artokun/comfyui-mcp
cd comfyui-mcp
npm install
npm run build
npm link

Kod değişikliklerinden sonra: npm run build, ardından yeniden bağlanmak için /mcp.

​1. ComfyUI’yi kurun

ComfyUI Desktop

Kaynaktan

​2. MCP sunucusunu ekleyin

​3. Panel orkestratörünü başlatma

​4. (İsteğe bağlı) Token’lar

​Yerel geliştirme

1. ComfyUI’yi kurun

2. MCP sunucusunu ekleyin

3. Panel orkestratörünü başlatma

4. (İsteğe bağlı) Token’lar

Yerel geliştirme