Hoppa till innehåll

För Zed-användare

Zed är snabbt. Agenten måste ändå hitta koden.

Zed-agenten arbetar utifrån filerna du öppnar och instruktionerna du ger. Maguyva indexerar hela repot och levererar det via MCP, så att agenten frågar var en symbol finns i stället för att gissa.

Free-nivå: 3 repositorier, Upp till 50K indexerade repo-rader, inget kreditkort krävs.

En post i context_servers: en URL och en Authorization-header.

Det här behöver du veta om Zed

Fyra fakta som gäller just Zed. Inget av dem är svårt.

// konfigurationsfil

settings.json

Fjärrservrar ligger under context_servers. Öppna filen med zed: open settings file eller lägg till en server via Settings → AI → MCP Servers.

// transport

Fjärr, via URL

Zed ansluter direkt till Maguyvas fjärrendpoint över HTTP. Ingen lokal process, inget Node.js.

// nyckel

En header i klartext

Den här guiden lägger nyckeln direkt i Authorization-headern, eftersom expansion av miljövariabler i Zed-headers inte är verifierad här. Förvara den i dina användarinställningar, inte i en fil du committar.

// godkännanden

Verktygsbehörigheter

Zed frågar som standard före varje verktygsanrop. Tillåt Maguyvas verktyg ett i taget under agent.tool_permissions.tools, med nycklar som mcp:maguyva:find_symbol.

Projektinstruktioner är en arbetsöverenskommelse. Använd dem.

# .rules
- Kör repots testkommando innan du kallar en ändring klar.
- Redigera bara paketet du ombads ändra.

Zed läser in en enda projektinstruktionsfil: den första träffen i en fast lista som börjar med .rules och innehåller AGENTS.md och CLAUDE.md. Personliga instruktioner läggs i ~/.config/zed/AGENTS.md. Använd dem för:

  • Kommandon för bygge, test och lint.
  • Konventioner som agenten hela tiden gör fel på.
  • Kataloger som agenten inte ska röra.

En instruktionsfil säger åt agenten hur den ska arbeta. Den kan inte tala om vilka av fyratusen filer som anropar funktionen den just ska ändra.

Där den öppna bufferten inte räcker

Tre saker som Zed-agenten inte kan lära sig av filerna framför sig.

// den öppna filen är inte repot

Agenten ser det du öppnat och det den hittar med grep. En hjälpfunktion med samma namn i ett annat paket ser likadan ut, tills fel version går ut i produktion.

// anroparna syns inte på skärmen

“Vad går sönder om jag ändrar den här signaturen?” är en grafråga. Utan index läser agenten en fil i taget tills turerna eller kontexten tar slut.

// kontext har en budget

Varje fil agenten öppnar för att orientera sig kostar tokens som den inte kan lägga på själva ändringen. Ett rangordnat svar med file:line kostar mindre än tio trevande läsningar.

Maguyva som kontextserver i Zed

En post i context_servers ger Zed-agenten:

  • 11 verktyg för ditt indexerade repo semantisk, strukturell (AST-), graf- och textsökning, plus symbolsökning, beroenden och filhämtning.
  • Svar med filsökvägar och radnummer över mer än 285 språk, så att agenten öppnar rätt fil direkt.
  • En verktygslista som håller sig aktuell Zed laddar om en servers verktyg när servern meddelar en ändring, utan omstart.

Zed ger agenten en snabb editor.

Maguyva ger agenten en karta över koden.

Två arbetsflöden

Fråga kartan först, redigera sedan.

// workflow 01

Hitta implementationen innan agenten öppnar en flik

zed agent> var finns retry-policyn för utgående webhooks?

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

→ Agenten öppnar dispatch.ts:41, inte mocken.
[exit 0]

En rangordnad sökning ersätter en omgång grep. Svaret kommer tillbaka som en sökväg och en rad som agenten kan öppna direkt.

// workflow 02

Kontrollera beroenden innan en signatur ändras

zed agent> lägg till ett timeout-argument i fetchInvoice

dependency_search("fetchInvoice", dependents)
  7 anropare i 4 paket

→ Agenten uppdaterar alla sju anropsställen i ett svep.
[exit 0]

Påverkansradien kommer före första redigeringen, inte efter att bygget fallerat.

Installation i Zed

Tre steg. Free-nivå: 3 repositorier, Upp till 50K indexerade repo-rader, inget kreditkort krävs.

  1. // step 01

    Indexera ett repo på maguyva.ai

    Välj ett du redan känner till, så du kan bedöma svaren.

  2. // step 02

    Lägg till Maguyva i context_servers i Zeds inställningar

    ~/.config/zed/settings.json

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

    Byt ut platshållaren och ställ en fråga

    Byt ut mgv_xxxx mot din API-nyckel och spara. Ställ en fråga till agenten som du redan vet svaret på, och öppna sedan den citerade filen.