Til Zed-brugere

Zed er hurtig. Agenten skal stadig finde koden.

Zed-agenten arbejder ud fra de filer, du åbner, og de instruktioner, du giver den. Maguyva indekserer hele repoet og leverer det tilbage over MCP, så agenten spørger, hvor et symbol ligger, i stedet for at gætte.

Start gratis Læs Zed-opsætningen

Free-niveau: 3 repos, Op til 50K indekserede repo-linjer, intet kreditkort.

Én post i context_servers: en URL og en Authorization-header.

Det skal du vide om Zed

Fire fakta, der gælder netop Zed. Ingen af dem er svære.

// konfigurationsfil

settings.json

Eksterne servere ligger under context_servers. Åbn filen med zed: open settings file, eller tilføj en server via Settings → AI → MCP Servers.

// transport

Eksternt, via URL

Zed forbinder direkte til Maguyvas eksterne endpoint over HTTP. Ingen lokal proces, ingen Node.js.

// nøgle

En header i klartekst

Denne guide skriver nøglen direkte i Authorization-headeren, fordi udfoldning af miljøvariabler i Zed-headers ikke er verificeret her. Gem den i dine brugerindstillinger, ikke i en fil, du committer.

// godkendelser

Værktøjstilladelser

Zed spørger som standard før hvert værktøjskald. Tillad Maguyvas værktøjer ét ad gangen under agent.tool_permissions.tools, med nøgler som mcp:maguyva:find_symbol.

Projektinstruktioner er en arbejdsaftale. Brug dem.

# .rules
- Kør repoets testkommando, før du kalder en ændring færdig.
- Ret kun i den pakke, du blev bedt om at ændre.

Zed indlæser én projektinstruktionsfil: det første match fra en fast liste, der starter med .rules og omfatter AGENTS.md og CLAUDE.md. Personlige instruktioner hører til i ~/.config/zed/AGENTS.md. Brug dem til:

Kommandoer til build, test og lint.
Konventioner, agenten bliver ved med at ramme forkert.
Mapper, agenten ikke må røre.

En instruktionsfil fortæller agenten, hvordan den skal arbejde. Den kan ikke fortælle, hvilke af fire tusind filer der kalder den funktion, den er ved at ændre.

Hvor den åbne buffer slipper op

Tre ting, Zed-agenten ikke kan lære af filerne foran sig.

// den åbne fil er ikke repoet

Agenten ser det, du har åbnet, og det, den finder med grep. En hjælpefunktion med samme navn i en anden pakke ser identisk ud, indtil den forkerte bliver sendt i produktion.

// kaldere er ikke på skærmen

“Hvad går i stykker, hvis jeg ændrer denne signatur?” er et grafspørgsmål. Uden et indeks læser agenten filer én ad gangen, indtil den løber tør for ture eller kontekst.

// kontekst har et budget

Hver fil, agenten åbner for at orientere sig, koster tokens, den ikke kan bruge på selve ændringen. Ét rangeret svar med file:line koster mindre end ti famlende læsninger.

Maguyva som kontekstserver i Zed

Én post i context_servers giver Zed-agenten:

11 værktøjer til dit indekserede repo semantisk, strukturel (AST-), graf- og tekstsøgning, plus symbolopslag, afhængige og filhentning.
Svar med filstier og linjenumre på tværs af over 285 sprog, så agenten åbner den rigtige fil første gang.
En værktøjsliste, der holder sig opdateret Zed genindlæser en servers værktøjer, når serveren melder en ændring, uden genstart.

Zed giver agenten en hurtig editor.
Maguyva giver agenten et kort over koden.

To arbejdsgange

Spørg kortet først, ret bagefter.

// workflow 01

Find implementeringen, før agenten åbner en fane

zed agent> hvor ligger retry-politikken for udgående webhooks?

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

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

Ét rangeret opslag erstatter en omgang grep. Svaret kommer tilbage som en sti og en linje, agenten kan åbne direkte.

// workflow 02

Tjek afhængige før en signaturændring

zed agent> tilføj et timeout-argument til fetchInvoice

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

→ Agenten opdaterer alle syv kaldsteder i ét hug.
[exit 0]

Blast radius kommer før første rettelse, ikke efter at buildet fejler.

Opsætning i Zed

Tre trin. Free-niveau: 3 repos, Op til 50K indekserede repo-linjer, intet kreditkort.

// step 01

Indekser et repo på maguyva.ai

Vælg et, du allerede kender, så du kan vurdere svarene.

// step 02

Tilføj Maguyva til context_servers i dine Zed-indstillinger

~/.config/zed/settings.json

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

// step 03

Udskift pladsholderen og stil ét spørgsmål

Udskift mgv_xxxx med din API-nøgle, og gem. Stil agenten ét spørgsmål, du allerede kender svaret på, og åbn så den citerede fil.