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

Canonical source: https://maguyva.ai/cs/for-zed

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

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.

> 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é.

### 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.

### 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.

### 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.

### 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.

```text
# .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.

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

```text
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.

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

```text
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.

### 01. Indexujte repozitář na maguyva.ai

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

### 02. Přidejte Maguyva do context_servers v nastavení Zed

`~/.config/zed/settings.json`

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

### 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.

[Dokumentace MCP](https://zed.dev/docs/ai/mcp) v Zed popisuje kontextové servery, profily agenta a oprávnění nástrojů.

## Indexujte jeden repozitář, který už znáte.

Připojte Zed přes MCP a položte otázku, kterou si můžete ověřit.