Zed-käyttäjille

Zed on nopea. Agentin pitää silti löytää koodi.

Zed-agentti työskentelee avaamiesi tiedostojen ja antamiesi ohjeiden varassa. Maguyva indeksoi koko repon ja tarjoaa sen takaisin MCP:n yli, joten agentti kysyy, missä symboli on, eikä arvaa.

Aloita ilmaiseksi Lue Zed-asennus

Free-taso: 3 repositoriota, Enintään 50 000 indeksoitua repo-riviä, ei luottokorttia.

Yksi context_servers-merkintä: URL ja Authorization-otsake.

Mitä Zed-editorista pitää tietää

Neljä Zed-editorille ominaista asiaa. Mikään niistä ei ole vaikea.

// asetustiedosto

settings.json

Etäpalvelimet määritetään kohtaan context_servers. Avaa tiedosto komennolla zed: open settings file tai lisää palvelin kohdasta Settings → AI → MCP Servers.

// siirto

Etänä, URL-osoitteella

Zed-editori yhdistää Maguyva-palvelun etäpäätepisteeseen suoraan HTTP:n yli. Ei paikallista prosessia, ei Node.js:ää.

// avain

Otsake sellaisenaan

Tämä ohje kirjoittaa avaimen suoraan Authorization-otsakkeeseen, koska ympäristömuuttujien laajennusta Zed-otsakkeissa ei ole tässä varmistettu. Pidä avain käyttäjäasetuksissa, älä tiedostossa, jonka commitoit.

// hyväksynnät

Työkalujen oikeudet

Zed-editori kysyy oletuksena ennen jokaista työkalukutsua. Salli Maguyva-työkalut yksi kerrallaan kohdassa agent.tool_permissions.tools avaimilla kuten mcp:maguyva:find_symbol.

Projektiohjeet ovat työskentelysopimus. Käytä niitä.

# .rules
- Aja repon testikomento ennen kuin julistat muutoksen valmiiksi.
- Muokkaa vain sitä pakettia, jota pyydettiin muuttamaan.

Zed-editori lataa yhden projektiohjetiedoston: ensimmäisen osuman kiinteästä listasta, joka alkaa tiedostolla .rules ja sisältää tiedostot AGENTS.md ja CLAUDE.md. Henkilökohtaiset ohjeet kuuluvat tiedostoon ~/.config/zed/AGENTS.md. Käytä niitä näihin:

Build-, testi- ja lint-komennot.
Käytännöt, joissa agentti erehtyy kerta toisensa jälkeen.
Hakemistot, joihin agentti ei saa koskea.

Ohjetiedosto kertoo agentille, miten työskennellä. Se ei voi kertoa, mitkä neljästätuhannesta tiedostosta kutsuvat funktiota, jota agentti on muuttamassa.

Missä avoin puskuri ei enää riitä

Kolme asiaa, joita Zed-agentti ei opi edessään olevista tiedostoista.

// avoin tiedosto ei ole repo

Agentti näkee sen, minkä avasit, ja sen, minkä se löytää grepillä. Samanniminen apufunktio toisessa paketissa näyttää samalta, kunnes väärä päätyy tuotantoon.

// kutsujat eivät näy ruudulla

“Mikä hajoaa, jos muutan tätä signatuuria?” on graafikysymys. Ilman indeksiä agentti lukee tiedostoja yksi kerrallaan, kunnes vuorot tai konteksti loppuvat.

// kontekstilla on budjetti

Jokainen tiedosto, jonka agentti avaa suunnistaakseen, kuluttaa tokeneita, joita se ei voi käyttää itse muutokseen. Yksi priorisoitu vastaus file:line-tiedoin maksaa vähemmän kuin kymmenen hapuilevaa lukua.

Maguyva Zed-editorin kontekstipalvelimena

Yksi context_servers-merkintä antaa Zed-agentille:

11 työkalua indeksoituun repoosi semanttinen, rakenteellinen (AST-), graafi- ja tekstihaku sekä symbolihaku, riippuvaiset ja tiedostojen haku.
Vastaukset tiedostopoluilla ja rivinumeroilla yli 285 kielellä, joten agentti avaa oikean tiedoston heti.
Ajan tasalla pysyvä työkalulista Zed-editori lataa palvelimen työkalut uudelleen, kun palvelin ilmoittaa muutoksesta, ilman uudelleenkäynnistystä.

Zed-editori antaa agentille nopean editorin.
Maguyva antaa agentille kartan koodista.

Kaksi työnkulkua

Kysy ensin kartalta, muokkaa sitten.

// workflow 01

Löydä toteutus ennen kuin agentti avaa välilehden

zed agent> missä on lähtevien webhookien uudelleenyrityskäytäntö?

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

→ Agentti avaa tiedoston dispatch.ts:41, ei mockia.
[exit 0]

Yksi priorisoitu haku korvaa grep-kierroksen. Vastaus palaa polkuna ja rivinä, jotka agentti voi avata suoraan.

// workflow 02

Tarkista riippuvaiset ennen signatuurin muutosta

zed agent> lisää fetchInvoiceen timeout-argumentti

dependency_search("fetchInvoice", dependents)
  7 kutsujaa 4 paketissa

→ Agentti päivittää kaikki seitsemän kutsukohtaa yhdellä kertaa.
[exit 0]

Vaikutusalue selviää ennen ensimmäistä muokkausta, ei vasta kun build kaatuu.

Asennus Zed-editorissa

Kolme vaihetta. Free-taso: 3 repositoriota, Enintään 50 000 indeksoitua repo-riviä, ei luottokorttia.

// step 01

Indeksoi repo osoitteessa maguyva.ai

Valitse jo tuntemasi repo, jotta voit arvioida vastauksia.

// step 02

Lisää Maguyva Zed-asetusten context_servers-kohtaan

~/.config/zed/settings.json

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

// step 03

Korvaa paikkamerkki ja kysy yksi kysymys

Korvaa mgv_xxxx omalla API-avaimellasi ja tallenna. Kysy agentilta yksi kysymys, jonka vastauksen jo tiedät, ja avaa sitten viitattu tiedosto.