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çinAvertGate 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

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:

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:

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

npx @avertgate/cli verify    # zincir bütünlüğünü doğrula
npx @avertgate/cli report    # yönetici özeti

Önce gölgede deneyinCanlı 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.