// 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.
For Zed-brukere
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. Fire fakta som gjelder akkurat Zed. Ingen av dem er vanskelige.
// konfigurasjonsfil
Eksterne servere ligger under context_servers. Åpne filen med zed: open settings file, eller legg til en server via Settings → AI → MCP Servers.
// transport
Zed kobler seg direkte til Maguyvas eksterne endepunkt over HTTP. Ingen lokal prosess, ingen Node.js.
// nøkkel
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
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.
# .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:
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.
Tre ting Zed-agenten ikke kan lære av filene foran seg.
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.
“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.
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.
Én oppføring i context_servers gir Zed-agenten:
Zed gir agenten en rask editor.
Maguyva gir agenten et kart over koden.
Spør kartet først, rediger etterpå.
// workflow 01
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
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.
Tre steg. Free-planen: 3 repoer, Opptil 50K indekserte kodelinjer, uten kredittkort.
// step 01
Velg ett du allerede kjenner, så du kan vurdere svarene.
// step 02
~/.config/zed/settings.json
{
"context_servers": {
"maguyva": {
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer mgv_xxxx"
}
}
}
} // step 03
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.