# Zed itu cepat. Agennya tetap harus menemukan kodenya.

Canonical source: https://maguyva.ai/id/for-zed

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

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.

> Satu entri context_servers: sebuah URL dan header Authorization.

## Yang perlu diketahui soal Zed

Empat fakta khusus Zed. Tidak ada yang sulit.

### 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.

### Jarak jauh, lewat URL

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

### 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.

### 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.

```text
# .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.

### 01. Temukan implementasinya sebelum agen membuka tab

```text
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.

### 02. Periksa dependen sebelum mengubah signature

```text
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.

### 01. Indeks repo di maguyva.ai

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

### 02. Tambahkan Maguyva ke context_servers di setting Zed Anda

`~/.config/zed/settings.json`

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

### 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.

[Dokumentasi MCP](https://zed.dev/docs/ai/mcp) milik Zed sendiri membahas context server, profil agen, dan izin alat.

## Indeks satu repo yang sudah Anda kenal.

Hubungkan Zed lewat MCP, lalu ajukan satu pertanyaan yang bisa Anda periksa.