Zed kullanıcıları için

Zed hızlı. Ajanın yine de kodu bulması gerekiyor.

Zed ajanı, açtığınız dosyalar ve verdiğiniz talimatlarla çalışır. Maguyva tüm repoyu dizinler ve MCP üzerinden geri sunar; böylece ajan tahmin etmek yerine bir sembolün nerede olduğunu sorar.

Ücretsiz başlayın Zed kurulumunu okuyun

Free katmanı: 3 repo, 50K'ya kadar indekslenmiş repo satırı, kart gerektirmez.

Tek bir context_servers girdisi: bir URL ve bir Authorization başlığı.

Zed hakkında bilmeniz gerekenler

Zed’e özgü dört gerçek. Hiçbiri zor değil.

// yapılandırma dosyası

settings.json

Uzak sunucular context_servers altında tanımlanır. Dosyayı zed: open settings file ile açın ya da Settings → AI → MCP Servers üzerinden bir sunucu ekleyin.

// aktarım

URL ile uzak bağlantı

Zed, Maguyva’nın uzak uç noktasına HTTP üzerinden doğrudan bağlanır. Yerel süreç yok, Node.js yok.

// anahtar

Olduğu gibi bir başlık

Bu kılavuz anahtarı doğrudan Authorization başlığına yazar, çünkü Zed başlıklarında ortam değişkeni genişletmesi burada doğrulanmadı. Anahtarı commit ettiğiniz bir dosyada değil, kullanıcı ayarlarınızda tutun.

// onaylar

Araç izinleri

Zed varsayılan olarak her araç çağrısından önce onay ister. Maguyva araçlarına agent.tool_permissions.tools altında, mcp:maguyva:find_symbol gibi anahtarlarla tek tek izin verin.

Proje talimatları bir çalışma sözleşmesidir. Kullanın.

# .rules
- Bir değişikliği bitti saymadan önce reponun test komutunu çalıştır.
- Yalnızca değiştirmen istenen paketi düzenle.

Zed tek bir proje talimat dosyası yükler: .rules ile başlayan ve AGENTS.md ile CLAUDE.md dosyalarını içeren sabit bir listedeki ilk eşleşme. Kişisel talimatlar ~/.config/zed/AGENTS.md dosyasına gider. Şunlar için kullanın:

Derleme, test ve lint komutları.
Ajanın sürekli yanlış yaptığı kurallar.
Ajanın dokunmaması gereken dizinler.

Bir talimat dosyası ajana nasıl çalışacağını söyler. Değiştirmek üzere olduğu fonksiyonu dört bin dosyadan hangilerinin çağırdığını söyleyemez.

Açık arabelleğin yetmediği yer

Zed ajanının önündeki dosyalardan öğrenemeyeceği üç şey.

// açık dosya repo değildir

Ajan, sizin açtığınızı ve grep ile bulduğunu görür. Başka bir paketteki aynı adlı yardımcı fonksiyon, yanlış olanı yayına çıkana kadar birebir aynı görünür.

// çağıranlar ekranda değil

“Bu imzayı değiştirirsem ne bozulur?” bir graf sorusudur. Dizin olmadan ajan, turları ya da bağlamı tükenene kadar dosyaları tek tek okur.

// bağlamın bir bütçesi var

Ajanın yönünü bulmak için açtığı her dosya, değişikliğin kendisine harcayamayacağı token’ları tüketir. file:line içeren tek bir sıralı yanıt, on keşif okumasından daha ucuzdur.

Zed bağlam sunucusu olarak Maguyva

Tek bir context_servers girdisi Zed ajanına şunları verir:

Dizinlenmiş reponuz üzerinde 11 araç anlamsal, yapısal (AST), graf ve metin araması; ayrıca sembol arama, bağımlılar ve dosya alma.
Dosya yolları ve satır numaralarıyla yanıtlar 285+ dilde; böylece ajan doğru dosyayı ilk seferde açar.
Güncel kalan bir araç listesi Sunucu bir değişiklik bildirdiğinde Zed, yeniden başlatmadan o sunucunun araçlarını yeniden yükler.

Zed ajana hızlı bir editör verir.
Maguyva ajana kodun haritasını verir.

İki iş akışı

Önce haritaya sorun, sonra düzenleyin.

// workflow 01

Ajan bir sekme açmadan uygulamayı bulun

zed agent> giden webhook’ların yeniden deneme politikası nerede?

find_symbol("retryPolicy")
  src/webhooks/dispatch.ts:41   retryPolicy()   ← uygulama
  src/webhooks/__mocks__/dispatch.ts:9   ← mock

→ Ajan mock’u değil, dispatch.ts:41’i açar.
[exit 0]

Tek bir sıralı arama, bir tur grep’in yerini alır. Yanıt, ajanın doğrudan açabileceği bir yol ve satır olarak gelir.

// workflow 02

İmza değişikliğinden önce bağımlıları kontrol edin

zed agent> fetchInvoice’a bir timeout argümanı ekle

dependency_search("fetchInvoice", dependents)
  4 pakette 7 çağıran

→ Ajan yedi çağrı noktasının hepsini tek seferde günceller.
[exit 0]

Etki yarıçapı, derleme başarısız olduktan sonra değil, ilk düzenlemeden önce gelir.

Zed’de kurulum

Üç adım. Free katmanı: 3 repo, 50K'ya kadar indekslenmiş repo satırı, kart gerektirmez.

// step 01

maguyva.ai’de bir repo dizinleyin

Yanıtları değerlendirebilmek için zaten bildiğiniz birini seçin.

// step 02

Maguyva’yı Zed ayarlarında context_servers altına ekleyin

~/.config/zed/settings.json

{
  "context_servers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

// step 03

Yer tutucuyu değiştirin ve bir soru sorun

mgv_xxxx değerini API anahtarınızla değiştirip kaydedin. Ajana yanıtını zaten bildiğiniz bir soru sorun, ardından alıntılanan dosyayı açın.