Untuk pengguna Zed

Zed itu cepat. Agennya tetap harus menemukan kodenya.

Agen Zed bekerja dari berkas yang Anda buka dan instruksi yang Anda berikan. Maguyva mengindeks seluruh repo dan menyajikannya kembali lewat MCP, jadi agen menanyakan letak sebuah symbol alih-alih menebak.

Mulai gratis Baca setup Zed-nya

Paket Free: 3 repository, Hingga 50K baris repo terindeks, tanpa kartu kredit.

Satu entri context_servers: sebuah URL dan header Authorization.

Yang perlu diketahui soal Zed

Empat fakta khusus Zed. Tidak ada yang sulit.

// berkas konfigurasi

settings.json

Server jarak jauh ditaruh di bawah context_servers. Buka berkasnya dengan zed: open settings file, atau tambahkan server dari Settings → AI → MCP Servers.

// transport

Jarak jauh, lewat URL

Zed terhubung ke endpoint jarak jauh Maguyva lewat HTTP. Tanpa proses lokal, tanpa Node.js.

// kunci

Header apa adanya

Panduan ini menaruh kunci langsung di header Authorization, karena ekspansi variabel lingkungan di header Zed belum diverifikasi di sini. Simpan di setting pengguna Anda, bukan di berkas yang Anda commit.

// persetujuan

Izin alat

Secara default, Zed meminta persetujuan sebelum setiap pemanggilan alat. Izinkan alat Maguyva satu per satu di bawah agent.tool_permissions.tools, dengan kunci seperti mcp:maguyva:find_symbol.

Instruksi proyek adalah kesepakatan kerja. Pakai itu.

# .rules
- Jalankan perintah test repo sebelum menyatakan perubahan selesai.
- Batasi edit di dalam package yang diminta untuk diubah.

Zed memuat satu berkas instruksi proyek: kecocokan pertama dari daftar tetap yang diawali .rules dan mencakup AGENTS.md serta CLAUDE.md. Instruksi pribadi masuk ke ~/.config/zed/AGENTS.md. Pakai untuk:

Perintah build, test, dan lint.
Konvensi yang terus-menerus dilanggar agen.
Direktori yang tidak boleh disentuh agen.

Berkas instruksi memberi tahu agen cara bekerja. Ia tidak bisa memberi tahu mana dari empat ribu berkas yang memanggil fungsi yang akan diubah.

Saat buffer yang terbuka tidak cukup

Tiga hal yang tidak bisa dipelajari agen Zed dari berkas di depannya.

// berkas yang terbuka bukan repo

Agen melihat apa yang Anda buka dan apa yang ia grep. Helper bernama sama di package lain tampak identik sampai yang salah ikut rilis.

// pemanggil tidak ada di layar

“Apa yang rusak kalau signature ini saya ubah?” adalah pertanyaan graf. Tanpa index, agen membaca berkas satu per satu sampai kehabisan giliran atau konteks.

// konteks punya anggaran

Setiap berkas yang dibuka agen untuk orientasi menghabiskan token yang tidak bisa dipakai untuk perubahannya. Satu jawaban berperingkat dengan file:line lebih murah daripada sepuluh pembacaan eksploratif.

Maguyva sebagai context server Zed

Satu entri context_servers memberi agen Zed:

11 alat di atas repo yang terindeks pencarian semantik, struktural (AST), graf, dan teks, ditambah pencarian simbol, dependen, dan pengambilan berkas.
Jawaban dengan jalur berkas dan nomor baris di 285+ bahasa, jadi agen langsung membuka berkas yang tepat.
Daftar alat yang selalu mutakhir Zed memuat ulang alat sebuah server saat server mengumumkan perubahan, tanpa restart.

Zed memberi agen editor yang cepat.
Maguyva memberi agen peta kode.

Dua alur kerja

Tanya peta dulu, lalu edit.

// workflow 01

Temukan implementasinya sebelum agen membuka tab

zed agent> di mana retry policy untuk webhook keluar?

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

→ Agen membuka dispatch.ts:41, bukan mock-nya.
[exit 0]

Satu lookup berperingkat menggantikan satu putaran grep. Jawabannya kembali sebagai jalur dan baris yang bisa langsung dibuka agen.

// workflow 02

Periksa dependen sebelum mengubah signature

zed agent> tambahkan argumen timeout ke fetchInvoice

dependency_search("fetchInvoice", dependents)
  7 pemanggil di 4 package

→ Agen memperbarui ketujuh call site dalam sekali jalan.
[exit 0]

Cakupan dampak muncul sebelum edit pertama, bukan setelah build gagal.

Setup di Zed

Tiga langkah. Paket Free: 3 repository, Hingga 50K baris repo terindeks, tanpa kartu kredit.

// step 01

Indeks repo di maguyva.ai

Pilih yang sudah Anda kenal, agar Anda dapat menilai jawabannya.

// step 02

Tambahkan Maguyva ke context_servers di setting Zed Anda

~/.config/zed/settings.json

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

// step 03

Ganti placeholder dan ajukan satu pertanyaan

Ganti mgv_xxxx dengan kunci API Anda lalu simpan. Ajukan ke agen satu pertanyaan yang jawabannya sudah Anda ketahui, lalu buka berkas yang dikutip.