Hopp til innhold

For Zed-brukere

Zed er rask. Agenten må fortsatt finne koden.

Zed-agenten jobber ut fra filene du åpner og instruksjonene du gir den. Maguyva indekserer hele repoet og leverer det tilbake over MCP, så agenten spør hvor et symbol ligger i stedet for å gjette.

Free-planen: 3 repoer, Opptil 50K indekserte kodelinjer, uten kredittkort.

Én oppføring i context_servers: en URL og en Authorization-header.

Dette må du vite om Zed

Fire fakta som gjelder akkurat Zed. Ingen av dem er vanskelige.

// konfigurasjonsfil

settings.json

Eksterne servere ligger under context_servers. Åpne filen med zed: open settings file, eller legg til en server via Settings → AI → MCP Servers.

// transport

Eksternt, via URL

Zed kobler seg direkte til Maguyvas eksterne endepunkt over HTTP. Ingen lokal prosess, ingen Node.js.

// nøkkel

En header i klartekst

Denne veiledningen legger nøkkelen rett i Authorization-headeren, fordi utvidelse av miljøvariabler i Zed-headere ikke er verifisert her. Hold den i brukerinnstillingene dine, ikke i en fil du committer.

// godkjenninger

Verktøytillatelser

Zed spør som standard før hvert verktøykall. Tillat Maguyvas verktøy ett om gangen under agent.tool_permissions.tools, med nøkler som mcp:maguyva:find_symbol.

Prosjektinstruksjoner er en samarbeidsavtale. Bruk dem.

# .rules
- Kjør testkommandoen i repoet før du kaller en endring ferdig.
- Rediger bare pakken du ble bedt om å endre.

Zed laster inn én prosjektinstruksjonsfil: det første treffet i en fast liste som starter med .rules og inkluderer AGENTS.md og CLAUDE.md. Personlige instruksjoner hører hjemme i ~/.config/zed/AGENTS.md. Bruk dem til:

  • Kommandoer for bygg, test og lint.
  • Konvensjoner agenten stadig tar feil av.
  • Mapper agenten ikke skal røre.

En instruksjonsfil forteller agenten hvordan den skal jobbe. Den kan ikke fortelle hvilke av fire tusen filer som kaller funksjonen den er i ferd med å endre.

Der den åpne bufferen kommer til kort

Tre ting Zed-agenten ikke kan lære av filene foran seg.

// den åpne filen er ikke repoet

Agenten ser det du har åpnet og det den finner med grep. En hjelpefunksjon med samme navn i en annen pakke ser helt lik ut, helt til feil versjon går i produksjon.

// kallerne er ikke på skjermen

“Hva brekker hvis jeg endrer denne signaturen?” er et grafspørsmål. Uten indeks leser agenten filer én om gangen til den går tom for runder eller kontekst.

// kontekst har et budsjett

Hver fil agenten åpner for å orientere seg, koster tokens den ikke kan bruke på selve endringen. Ett rangert svar med file:line koster mindre enn ti famlende lesinger.

Maguyva som kontekstserver i Zed

Én oppføring i context_servers gir Zed-agenten:

  • 11 verktøy for det indekserte repoet ditt semantisk, strukturelt (AST-), graf- og tekstsøk, pluss symboloppslag, avhengige og filhenting.
  • Svar med filstier og linjenumre på tvers av over 285 språk, så agenten åpner riktig fil med en gang.
  • En verktøyliste som holder seg oppdatert Zed laster inn en servers verktøy på nytt når serveren melder en endring, uten omstart.

Zed gir agenten en rask editor.

Maguyva gir agenten et kart over koden.

To arbeidsflyter

Spør kartet først, rediger etterpå.

// workflow 01

Finn implementasjonen før agenten åpner en fane

zed agent> hvor er retry-policyen for utgående webhooks?

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

→ Agenten åpner dispatch.ts:41, ikke mocken.
[exit 0]

Ett rangert oppslag erstatter en runde med grep. Svaret kommer tilbake som en sti og en linje agenten kan åpne direkte.

// workflow 02

Sjekk avhengige før en signaturendring

zed agent> legg til et timeout-argument i fetchInvoice

dependency_search("fetchInvoice", dependents)
  7 kallere i 4 pakker

→ Agenten oppdaterer alle sju kallstedene i én omgang.
[exit 0]

Påvirkningsradiusen kommer før første redigering, ikke etter at bygget feiler.

Oppsett i Zed

Tre steg. Free-planen: 3 repoer, Opptil 50K indekserte kodelinjer, uten kredittkort.

  1. // step 01

    Indekser et repo på maguyva.ai

    Velg ett du allerede kjenner, så du kan vurdere svarene.

  2. // step 02

    Legg Maguyva til i context_servers i Zed-innstillingene

    ~/.config/zed/settings.json

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

    Bytt ut plassholderen og still ett spørsmål

    Bytt ut mgv_xxxx med API-nøkkelen din og lagre. Still agenten ett spørsmål du allerede vet svaret på, og åpne så den siterte filen.