Dla użytkowników Zed

Zed jest szybki. Agent i tak musi znaleźć kod.

Agent Zed pracuje na plikach, które otwierasz, i instrukcjach, które mu dajesz. Maguyva indeksuje całe repo i zwraca je przez MCP, więc agent pyta, gdzie leży symbol, zamiast zgadywać.

Zacznij za darmo Przeczytaj konfigurację dla Zed

Plan Free: 3 repozytoria, Do 50 tys. zindeksowanych linii repo, bez karty kredytowej.

Jeden wpis w context_servers: URL i nagłówek Authorization.

Co warto wiedzieć o Zed

Cztery fakty specyficzne dla Zed. Żaden nie jest trudny.

// plik konfiguracji

settings.json

Zdalne serwery trafiają pod context_servers. Otwórz plik poleceniem zed: open settings file albo dodaj serwer w Settings → AI → MCP Servers.

// transport

Zdalnie, przez URL

Zed łączy się przez HTTP bezpośrednio ze zdalnym endpointem Maguyva. Bez lokalnego procesu, bez Node.js.

// klucz

Nagłówek wprost

Ten przewodnik wpisuje klucz bezpośrednio do nagłówka Authorization, bo rozwijanie zmiennych środowiskowych w nagłówkach Zed nie zostało tu zweryfikowane. Trzymaj go w ustawieniach użytkownika, a nie w pliku, który commitujesz.

// zatwierdzenia

Uprawnienia narzędzi

Domyślnie Zed pyta przed każdym wywołaniem narzędzia. Zezwalaj na narzędzia Maguyva pojedynczo w agent.tool_permissions.tools, z kluczami w rodzaju mcp:maguyva:find_symbol.

Instrukcje projektu to umowa robocza. Korzystaj z nich.

# .rules
- Uruchom komendę testów repo, zanim uznasz zmianę za gotową.
- Edytuj tylko pakiet, o którego zmianę cię poproszono.

Zed wczytuje jeden plik instrukcji projektu: pierwsze trafienie ze stałej listy, która zaczyna się od .rules i obejmuje AGENTS.md oraz CLAUDE.md. Osobiste instrukcje trafiają do ~/.config/zed/AGENTS.md. Używaj ich do:

Komend build, testów i lint.
Konwencji, które agent ciągle myli.
Katalogów, których agent ma nie ruszać.

Plik instrukcji mówi agentowi, jak pracować. Nie powie mu, które z czterech tysięcy plików wywołują funkcję, którą właśnie zmienia.

Gdzie otwarty bufor przestaje wystarczać

Trzy rzeczy, których agent Zed nie wyczyta z plików, które ma przed sobą.

// otwarty plik to nie repo

Agent widzi to, co otworzyłeś, i to, co znalazł grepem. Helper o tej samej nazwie w innym pakiecie wygląda identycznie, dopóki na produkcję nie trafi ten zły.

// wywołujących nie widać na ekranie

“Co się zepsuje, jeśli zmienię tę sygnaturę?” to pytanie o graf. Bez indeksu agent czyta pliki jeden po drugim, aż skończą mu się tury albo kontekst.

// kontekst ma budżet

Każdy plik, który agent otwiera, żeby się zorientować, zużywa tokeny, których zabraknie na samą zmianę. Jedna uszeregowana odpowiedź z file:line kosztuje mniej niż dziesięć odczytów po omacku.

Maguyva jako serwer kontekstu w Zed

Jeden wpis w context_servers daje agentowi Zed:

11 narzędzi dla zaindeksowanego repo wyszukiwanie semantyczne, strukturalne (AST), grafowe i tekstowe, a do tego wyszukiwanie symboli, zależności i pobieranie plików.
Odpowiedzi ze ścieżkami plików i numerami linii w ponad 285 językach, żeby agent od razu otwierał właściwy plik.
Zawsze aktualna lista narzędzi Zed przeładowuje narzędzia serwera, gdy ten ogłosi zmianę, bez restartu.

Zed daje agentowi szybki edytor.
Maguyva daje agentowi mapę kodu.

Dwa przepływy pracy

Najpierw zapytaj mapę, potem edytuj.

// workflow 01

Znajdź implementację, zanim agent otworzy kartę

zed agent> gdzie jest polityka ponowień dla wychodzących webhooków?

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

→ Agent otwiera dispatch.ts:41, a nie atrapę.
[exit 0]

Jedno uszeregowane zapytanie zastępuje rundę grepowania. Odpowiedź wraca jako ścieżka i linia, które agent może od razu otworzyć.

// workflow 02

Sprawdź elementy zależne przed zmianą sygnatury

zed agent> dodaj do fetchInvoice argument timeout

dependency_search("fetchInvoice", dependents)
  7 wywołujących w 4 pakietach

→ Agent aktualizuje wszystkie siedem miejsc wywołania za jednym razem.
[exit 0]

Zasięg wpływu znasz przed pierwszą edycją, a nie po tym, jak padnie build.

Konfiguracja w Zed

Trzy kroki. Plan Free: 3 repozytoria, Do 50 tys. zindeksowanych linii repo, bez karty kredytowej.

// step 01

Zaindeksuj repo na maguyva.ai

Wybierz takie, które już znasz, żeby móc ocenić odpowiedzi.

// step 02

Dodaj Maguyva do context_servers w ustawieniach Zed

~/.config/zed/settings.json

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

// step 03

Podmień placeholder i zadaj jedno pytanie

Zamień mgv_xxxx na swój klucz API i zapisz. Zadaj agentowi pytanie, na które znasz już odpowiedź, a potem otwórz cytowany plik.