<!-- https://avertgate.com/tr/docs/quickstart · Başlarken -->

# Hızlı başlangıç

Bu sayfa, mevcut bir MCP sunucusunu AvertGate arkasına almanın en kısa yolunu gösterir. Araç çağrıları ve sonuçları makinenizde işlenir.

> **Müşteriler ve POC ortakları için**: AvertGate kurumsal müşterilere satılır; CLI, demo ve kanıt çalışmanız (POC) başladığında verilir. Bu hızlı başlangıç, o aşamada mühendisinizin izleyeceği yoldur.

## 1. Başlangıç dosyalarını oluşturun

<!-- terminal -->
```
npx @avertgate/cli init
```

Komut, bulunduğunuz klasöre iki dosya yazar: örnek bir `policy.yaml` ve ortam ayarları için `.env`.

## 2. Politikayı düzenleyin

Politika, ajanın hangi araçları çağırabileceğini söyler. Listede olmayan araç **reddedilir**; bu yüzden buradaki araç adları, upstream MCP sunucunuzun gerçekten sunduğu adlarla aynı olmalıdır. Aşağıdaki örnek, 3. adımda başlatılan dosya sistemi sunucusuna uygundur:

<!-- policy.yaml -->
```yaml
agent: quickstart-agent

tools:
  - name: "read_text_file"    # salt okunur: serbest
    allow: true
  - name: "list_directory"    # salt okunur: serbest
    allow: true
  - name: "write_file"        # yazma: insan onayı
    allow: true
    require_approval: true
  - name: "move_file"         # geri alınması zor: yasak
    allow: false

defaults:
  unlisted_tools: deny
  fail_closed: true
```

## 3. Ağ geçidini başlatın

Gerçek MCP sunucunuzu `UPSTREAM_COMMAND` ile tanıtın:

<!-- terminal -->
```
UPSTREAM_COMMAND="npx" \
UPSTREAM_ARGS="-y @modelcontextprotocol/server-filesystem /tmp" \
npx @avertgate/cli start
```

> **Başka bir MCP sunucusu mu kullanıyorsunuz?**: Araç adlarını sunucunuzun listelediği adlarla değiştirin. Unuttuğunuz her araç reddedilir; bu, istenen güvenli davranıştır.

## 4. İstemcinizi AvertGate'e yönlendirin

MCP istemcinizin (ajan çerçeveniz, IDE, vb.) yapılandırmasında gerçek sunucu yerine AvertGate sürecini gösterin. Artık her araç çağrısı politika kontrolünden, tarayıcılardan ve denetim kaydından geçer.

## 5. Doğrulayın

<!-- terminal -->
```
npx @avertgate/cli verify    # zincir bütünlüğünü doğrula
npx @avertgate/cli report    # yönetici özeti
```

> **Önce gölgede deneyin**: Canlı trafiği hemen engellemek istemiyorsanız `--shadow` ile başlatın. Karar verilir ve kaydedilir ama hiçbir çağrı durdurulmaz. Ayrıntı: [Shadow mode](/docs/shadow-mode).