Pro uživatele Zed

Zed je rychlý. Kód ale agent stejně musí najít.

Agent v Zed pracuje se soubory, které otevřete, a s pokyny, které mu dáte. Maguyva indexuje celý repozitář a vrací ho přes MCP, takže se agent zeptá, kde symbol leží, místo aby hádal.

Začít zdarma Přečtěte si nastavení pro Zed

Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez kreditní karty.

Jeden záznam v context_servers: URL a hlavička Authorization.

Co potřebujete vědět o Zed

Čtyři fakta specifická pro Zed. Žádné není těžké.

// konfigurační soubor

settings.json

Vzdálené servery patří pod context_servers. Soubor otevřete příkazem zed: open settings file, nebo server přidáte v Settings → AI → MCP Servers.

// transport

Vzdáleně, přes URL

Zed se připojuje přes HTTP přímo ke vzdálenému endpointu Maguyva. Žádný lokální proces, žádný Node.js.

// klíč

Hlavička natvrdo

Tento návod zapisuje klíč přímo do hlavičky Authorization, protože rozbalování proměnných prostředí v hlavičkách Zed tu není ověřené. Držte ho v uživatelském nastavení, ne v souboru, který commitujete.

// schvalování

Oprávnění nástrojů

Zed se ve výchozím stavu ptá před každým voláním nástroje. Nástroje Maguyva povolujte jednotlivě v agent.tool_permissions.tools s klíči jako mcp:maguyva:find_symbol.

Pokyny projektu jsou dohoda o spolupráci. Používejte je.

# .rules
- Než změnu prohlásíš za hotovou, spusť testovací příkaz repozitáře.
- Upravuj jen balíček, o jehož změnu tě někdo požádal.

Zed načítá jeden soubor s pokyny projektu: první shodu z pevného seznamu, který začíná .rules a obsahuje AGENTS.md a CLAUDE.md. Osobní pokyny patří do ~/.config/zed/AGENTS.md. Použijte je pro:

Příkazy pro build, testy a lint.
Konvence, ve kterých se agent pořád plete.
Adresáře, na které agent nemá sahat.

Soubor s pokyny říká agentovi, jak pracovat. Neřekne mu ale, které ze čtyř tisíc souborů volají funkci, kterou se chystá změnit.

Kde otevřený buffer přestává stačit

Tři věci, které se agent v Zed nedozví ze souborů, které má před sebou.

// otevřený soubor není repozitář

Agent vidí, co jste otevřeli, a co najde grepem. Helper se stejným jménem v jiném balíčku vypadá stejně, dokud do produkce nepůjde ten špatný.

// volající nejsou na obrazovce

“Co se rozbije, když změním tuhle signaturu?” je otázka pro graf. Bez indexu agent čte soubory jeden po druhém, dokud mu nedojdou tahy nebo kontext.

// kontext má rozpočet

Každý soubor, který agent otevře, aby se zorientoval, spotřebuje tokeny, které pak chybí na samotnou změnu. Jedna seřazená odpověď s file:line stojí méně než deset průzkumných čtení.

Maguyva jako kontextový server v Zed

Jeden záznam v context_servers dá agentovi v Zed:

11 nástrojů nad vaším indexovaným repozitářem sémantické, strukturální (AST), grafové a textové vyhledávání, plus vyhledávání symbolů, závislé a načítání souborů.
Odpovědi s cestami k souborům a čísly řádků napříč 285+ jazyky, aby agent hned otevřel ten správný soubor.
Seznam nástrojů, který je vždy aktuální Zed znovu načte nástroje serveru, jakmile server oznámí změnu, bez restartu.

Zed dává agentovi rychlý editor.
Maguyva dává agentovi mapu kódu.

Dva pracovní postupy

Nejdřív se zeptejte mapy, pak upravujte.

// workflow 01

Najděte implementaci dřív, než agent otevře záložku

zed agent> kde je retry politika pro odchozí webhooky?

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

→ Agent otevře dispatch.ts:41, ne mock.
[exit 0]

Jeden seřazený dotaz nahradí kolečko grepu. Odpověď se vrátí jako cesta a řádek, které agent může rovnou otevřít.

// workflow 02

Zkontrolujte závislé před změnou signatury

zed agent> přidej do fetchInvoice argument timeout

dependency_search("fetchInvoice", dependents)
  7 volajících ve 4 balíčcích

→ Agent upraví všech sedm míst volání najednou.
[exit 0]

Rozsah dopadu znáte před první úpravou, ne až když spadne build.

Nastavení v Zed

Tři kroky. Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez kreditní karty.

// step 01

Indexujte repozitář na maguyva.ai

Vyberte si takový, který už znáte, abyste mohli posoudit odpovědi.

// step 02

Přidejte Maguyva do context_servers v nastavení Zed

~/.config/zed/settings.json

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

// step 03

Nahraďte zástupný text a položte jednu otázku

Nahraďte mgv_xxxx svým API klíčem a uložte. Položte agentovi otázku, na kterou už znáte odpověď, a pak otevřete citovaný soubor.