Untuk pengguna Zed

Zed pantas. Ejennya masih perlu mencari kod.

Ejen Zed bekerja daripada fail yang anda buka dan arahan yang anda beri. Maguyva mengindeks seluruh repo dan menyajikannya semula melalui MCP, jadi ejen bertanya di mana sesuatu simbol berada dan bukan meneka.

Mula percuma Baca persediaan Zed

Peringkat Free: 3 repositori, Sehingga 50K baris repo terindeks, tanpa kad.

Satu entri context_servers: satu URL dan satu pengepala Authorization.

Apa yang perlu diketahui tentang Zed

Empat fakta khusus untuk Zed. Tiada yang sukar.

// fail konfigurasi

settings.json

Pelayan jauh diletakkan di bawah context_servers. Buka fail dengan zed: open settings file, atau tambah pelayan daripada Settings → AI → MCP Servers.

// pengangkutan

Jauh, melalui URL

Zed bersambung ke titik akhir jauh Maguyva melalui HTTP. Tiada proses tempatan, tiada Node.js.

// kunci

Pengepala literal

Panduan ini meletakkan kunci terus dalam pengepala Authorization, kerana pengembangan pemboleh ubah persekitaran dalam pengepala Zed belum disahkan di sini. Simpan dalam tetapan pengguna anda, bukan dalam fail yang anda commit.

// kelulusan

Kebenaran alat

Secara lalai, Zed meminta kelulusan sebelum setiap panggilan alat. Benarkan alat Maguyva satu demi satu di bawah agent.tool_permissions.tools, dengan kunci seperti mcp:maguyva:find_symbol.

Arahan projek ialah persetujuan kerja. Gunakannya.

# .rules
- Jalankan arahan ujian repo sebelum menganggap perubahan selesai.
- Hadkan suntingan dalam pakej yang diminta untuk diubah.

Zed memuatkan satu fail arahan projek: padanan pertama daripada senarai tetap yang bermula dengan .rules dan merangkumi AGENTS.md serta CLAUDE.md. Arahan peribadi diletakkan dalam ~/.config/zed/AGENTS.md. Gunakannya untuk:

Arahan build, ujian dan lint.
Konvensyen yang asyik disalah buat oleh ejen.
Direktori yang tidak boleh disentuh oleh ejen.

Fail arahan memberitahu ejen cara bekerja. Ia tidak dapat memberitahu yang mana antara empat ribu fail memanggil fungsi yang hendak diubahnya.

Apabila penimbal yang terbuka tidak mencukupi

Tiga perkara yang ejen Zed tidak dapat pelajari daripada fail di hadapannya.

// fail yang terbuka bukan repo

Ejen melihat apa yang anda buka dan apa yang ia grep. Fungsi pembantu bernama sama dalam pakej lain kelihatan serupa sehingga yang salah dihantar.

// pemanggil tiada di skrin

“Apa yang rosak jika saya ubah tandatangan ini?” ialah soalan graf. Tanpa indeks, ejen membaca fail satu demi satu sehingga kehabisan giliran atau konteks.

// konteks ada bajet

Setiap fail yang dibuka ejen untuk orientasi menggunakan token yang tidak dapat dibelanjakan untuk perubahan itu. Satu jawapan tersusun dengan file:line lebih murah daripada sepuluh bacaan penerokaan.

Maguyva sebagai pelayan konteks Zed

Satu entri context_servers memberi ejen Zed:

11 alat merentasi repo anda yang diindeks carian semantik, struktur (AST), graf dan teks, ditambah carian simbol, dependen dan pengambilan fail.
Jawapan dengan laluan fail dan nombor baris merentasi 285+ bahasa, jadi ejen membuka fail yang betul dahulu.
Senarai alat yang sentiasa terkini Zed memuat semula alat sesuatu pelayan apabila pelayan mengumumkan perubahan, tanpa mula semula.

Zed memberi ejen editor yang pantas.
Maguyva memberi ejen peta kod.

Dua aliran kerja

Tanya peta dahulu, kemudian sunting.

// workflow 01

Cari pelaksanaan sebelum ejen membuka tab

zed agent> di mana dasar cuba semula untuk webhook keluar?

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

→ Ejen membuka dispatch.ts:41, bukan mock.
[exit 0]

Satu carian tersusun menggantikan satu pusingan grep. Jawapan kembali sebagai laluan dan baris yang boleh terus dibuka oleh ejen.

// workflow 02

Semak dependen sebelum mengubah tandatangan

zed agent> tambah argumen timeout pada fetchInvoice

dependency_search("fetchInvoice", dependents)
  7 pemanggil merentasi 4 pakej

→ Ejen mengemas kini ketujuh-tujuh tapak panggilan sekali gus.
[exit 0]

Lingkungan impak tiba sebelum suntingan pertama, bukan selepas build gagal.

Sediakan Zed

Tiga langkah. Peringkat Free: 3 repositori, Sehingga 50K baris repo terindeks, tanpa kad.

// step 01

Indeks repo di maguyva.ai

Pilih satu yang anda sudah kenali, supaya anda boleh menilai jawapannya.

// step 02

Tambah Maguyva pada context_servers dalam tetapan Zed anda

~/.config/zed/settings.json

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

// step 03

Ganti pemegang tempat dan tanya satu soalan

Tukar mgv_xxxx kepada kunci API anda dan simpan. Tanya ejen satu soalan yang anda sudah tahu jawapannya, kemudian buka fail yang disebut.