Voor Zed-gebruikers

Zed is snel. De agent moet de code nog steeds vinden.

De Zed-agent werkt met de bestanden die je opent en de instructies die je geeft. Maguyva indexeert de hele repo en levert die via MCP terug, zodat de agent vraagt waar een symbool staat in plaats van te gokken.

Start gratis Lees de Zed-setup

Free-abonnement: 3 repositories, Tot 50K geïndexeerde repo-regels, geen creditcard nodig.

Eén context_servers-entry: een URL en een Authorization-header.

Wat je over Zed moet weten

Vier feiten die specifiek zijn voor Zed. Geen ervan is moeilijk.

// configbestand

settings.json

Remote servers staan onder context_servers. Open het bestand met zed: open settings file of voeg een server toe via Settings → AI → MCP Servers.

// transport

Remote, via URL

Zed maakt via HTTP rechtstreeks verbinding met het remote endpoint van Maguyva. Geen lokaal proces, geen Node.js.

// sleutel

Een letterlijke header

Deze gids zet de sleutel rechtstreeks in de Authorization-header, omdat het uitvouwen van omgevingsvariabelen in Zed-headers hier niet is geverifieerd. Bewaar hem in je gebruikersinstellingen, niet in een bestand dat je commit.

// goedkeuringen

Toolrechten

Zed vraagt standaard om bevestiging vóór elke toolaanroep. Sta de tools van Maguyva één voor één toe onder agent.tool_permissions.tools, met sleutels als mcp:maguyva:find_symbol.

Projectinstructies zijn een werkafspraak. Gebruik ze.

# .rules
- Draai het testcommando van de repo voordat je een wijziging klaar noemt.
- Bewerk alleen het pakket dat je moest aanpassen.

Zed laadt één projectinstructiebestand: de eerste match uit een vaste lijst die begint met .rules en AGENTS.md en CLAUDE.md bevat. Persoonlijke instructies gaan in ~/.config/zed/AGENTS.md. Gebruik ze voor:

Build-, test- en lintcommando’s.
Conventies die de agent steeds fout doet.
Mappen waar de agent niet aan mag komen.

Een instructiebestand vertelt de agent hoe hij moet werken. Het kan hem niet vertellen welke van vierduizend bestanden de functie aanroepen die hij gaat wijzigen.

Waar de open buffer tekortschiet

Drie dingen die de Zed-agent niet kan leren uit de bestanden voor zijn neus.

// het open bestand is niet de repo

De agent ziet wat jij opende en wat hij met grep vindt. Een helper met dezelfde naam in een ander pakket ziet er identiek uit, tot de verkeerde wordt uitgerold.

// aanroepers staan niet op het scherm

“Wat breekt er als ik deze signatuur verander?” is een graafvraag. Zonder index leest de agent bestand na bestand tot zijn beurten of context op zijn.

// context heeft een budget

Elk bestand dat de agent opent om zich te oriënteren, kost tokens die hij niet aan de wijziging kan besteden. Eén gerangschikt antwoord met file:line kost minder dan tien verkennende leesacties.

Maguyva als contextserver in Zed

Eén context_servers-entry geeft de Zed-agent:

11 tools voor je geïndexeerde repo semantisch, structureel (AST-), graaf- en tekstzoeken, plus symbolen opzoeken, afhankelijken en bestanden ophalen.
Antwoorden met bestandspaden en regelnummers over meer dan 285 talen, zodat de agent meteen het juiste bestand opent.
Een toollijst die actueel blijft Zed laadt de tools van een server opnieuw zodra die een wijziging meldt, zonder herstart.

Zed geeft de agent een snelle editor.
Maguyva geeft de agent een kaart van de code.

Twee workflows

Vraag eerst de kaart, bewerk daarna.

// workflow 01

Vind de implementatie voordat de agent een tab opent

zed agent> waar staat het retrybeleid voor uitgaande webhooks?

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

→ De agent opent dispatch.ts:41, niet de mock.
[exit 0]

Eén gerangschikte zoekopdracht vervangt een ronde grep. Het antwoord komt terug als pad en regel die de agent direct kan openen.

// workflow 02

Controleer afhankelijken vóór een signatuurwijziging

zed agent> voeg een timeout-argument toe aan fetchInvoice

dependency_search("fetchInvoice", dependents)
  7 aanroepers in 4 pakketten

→ De agent werkt alle zeven aanroepplekken in één keer bij.
[exit 0]

De impactradius komt vóór de eerste bewerking, niet nadat de build faalt.

Instellen in Zed

Drie stappen. Free-abonnement: 3 repositories, Tot 50K geïndexeerde repo-regels, geen creditcard nodig.

// step 01

Indexeer een repo op maguyva.ai

Kies er een die je al kent, zodat je de antwoorden kunt beoordelen.

// step 02

Voeg Maguyva toe aan context_servers in je Zed-instellingen

~/.config/zed/settings.json

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

// step 03

Vervang de placeholder en stel één vraag

Vervang mgv_xxxx door je API-sleutel en sla op. Stel de agent één vraag waarvan je het antwoord al weet en open daarna het geciteerde bestand.