> ## Documentation Index
> Fetch the complete documentation index at: https://comfyui-mcp.artokun.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Kurulum

> ComfyUI'yi kurun ve MCP sunucusunu bağlayın — yerel, uzak ya da Comfy Cloud.

## 1. ComfyUI'yi kurun

<CardGroup cols={2}>
  <Card title="ComfyUI Desktop" icon="desktop" href="https://www.comfy.org/download">
    macOS / Windows'ta yönetilen bir kurulum edinmenin en kolay yolu.
  </Card>

  <Card title="Kaynaktan" icon="github" href="https://github.com/comfyanonymous/ComfyUI">
    Klonlayıp elle çalıştırın — ya da [`install_comfyui`](/docs/docs/tools/install-environment) aracını kullanın.
  </Card>
</CardGroup>

## 2. MCP sunucusunu ekleyin

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

<Tabs>
  <Tab title="Yerel ComfyUI">
    Sunucu, yerel kurulumu ve portunu kendiliğinden algılar. `~/.claude/settings.json` dosyasına ekleyin:

    ```json theme={null}
    {
      "mcpServers": {
        "comfyui": {
          "command": "npx",
          "args": ["-y", "comfyui-mcp"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="Uzak ComfyUI">
    `--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.

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

    <Note>
      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](/docs/docs/concepts).
    </Note>
  </Tab>

  <Tab title="Comfy Cloud">
    `COMFYUI_API_KEY` ayarlayarak [Comfy Cloud](https://cloud.comfy.org) 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.

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

    <Note>
      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](/docs/docs/configuration#deployment-modes) sayfasına bakın.
    </Note>

    <Note>
      **Yalnızca bulut mu?** [Comfy-Org'un Comfy Cloud MCP'si](https://docs.comfy.org/agent-tools) (herkese açık beta) buradaki asıl seçenektir — bkz. [Yerel ile Comfy Cloud karşılaştırması](/docs/docs/local-vs-comfy-cloud). 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.
    </Note>
  </Tab>
</Tabs>

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.

```bash theme={null}
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:

```bash theme={null}
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ı](/docs/docs/cloud-deployment) 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](/docs/docs/configuration)):

* `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:

```bash theme={null}
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`.