Für Zed-Nutzer

Zed ist schnell. Den Code finden muss der Agent trotzdem.

Der Zed-Agent arbeitet mit den Dateien, die du öffnest, und den Anweisungen, die du ihm gibst. Maguyva indexiert das ganze Repo und liefert es über MCP zurück, damit der Agent fragt, wo ein Symbol liegt, statt zu raten.

Kostenlos starten Zed-Setup lesen

Free-Stufe: 3 Repositories, Bis zu 50K indexierte Repo-Zeilen, keine Kreditkarte.

Ein Eintrag in context_servers: eine URL und ein Authorization-Header.

Was du über Zed wissen musst

Vier Fakten speziell für Zed. Keiner davon ist schwer.

// Konfigurationsdatei

settings.json

Remote-Server stehen unter context_servers. Öffne die Datei mit zed: open settings file oder füge einen Server über Settings → AI → MCP Servers hinzu.

// Transport

Remote, per URL

Zed verbindet sich per HTTP direkt mit dem Remote-Endpunkt von Maguyva. Kein lokaler Prozess, kein Node.js.

// Schlüssel

Ein literaler Header

Diese Anleitung schreibt den Schlüssel direkt in den Authorization-Header, weil die Expansion von Umgebungsvariablen in Zed-Headern hier nicht verifiziert ist. Bewahr ihn in deinen Benutzereinstellungen auf, nicht in einer Datei, die du committest.

// Freigaben

Tool-Berechtigungen

Zed fragt standardmäßig vor jedem Tool-Aufruf nach. Gib die Tools von Maguyva einzeln unter agent.tool_permissions.tools frei, mit Schlüsseln wie mcp:maguyva:find_symbol.

Projektanweisungen sind eine Arbeitsvereinbarung. Nutz sie.

# .rules
- Führ den Test-Befehl des Repos aus, bevor du eine Änderung für fertig erklärst.
- Bearbeite nur das Paket, um das du gebeten wurdest.

Zed lädt genau eine Projektanweisungsdatei: den ersten Treffer aus einer festen Liste, die mit .rules beginnt und AGENTS.md sowie CLAUDE.md enthält. Persönliche Anweisungen gehören nach ~/.config/zed/AGENTS.md. Nutz sie für:

Build-, Test- und Lint-Befehle.
Konventionen, die der Agent immer wieder falsch macht.
Verzeichnisse, die der Agent nicht anfassen soll.

Eine Anweisungsdatei sagt dem Agenten, wie er arbeiten soll. Sie kann ihm nicht sagen, welche von viertausend Dateien die Funktion aufrufen, die er gleich ändert.

Wo der offene Buffer an seine Grenzen stößt

Drei Dinge, die der Zed-Agent aus den Dateien vor ihm nicht lernen kann.

// die offene Datei ist nicht das Repo

Der Agent sieht, was du geöffnet hast und was er per grep findet. Ein gleichnamiger Helper in einem anderen Paket sieht identisch aus – bis der falsche ausgeliefert wird.

// Aufrufer sind nicht auf dem Bildschirm

“Was geht kaputt, wenn ich diese Signatur ändere?” ist eine Graph-Frage. Ohne Index liest der Agent eine Datei nach der anderen, bis ihm die Turns oder der Kontext ausgehen.

// Kontext hat ein Budget

Jede Datei, die der Agent zur Orientierung öffnet, kostet Tokens, die ihm für die eigentliche Änderung fehlen. Eine priorisierte Antwort mit file:line kostet weniger als zehn tastende Lesezugriffe.

Maguyva als Kontextserver in Zed

Ein Eintrag in context_servers gibt dem Zed-Agenten:

11 Tools für dein indexiertes Repo semantische, strukturelle (AST-), Graph- und Textsuche, plus Symbol-Lookup, Abhängige und Dateiabruf.
Antworten mit Dateipfaden und Zeilennummern über 285+ Sprachen, damit der Agent gleich die richtige Datei öffnet.
Eine Tool-Liste, die aktuell bleibt Zed lädt die Tools eines Servers neu, sobald der Server eine Änderung meldet – ohne Neustart.

Zed gibt dem Agenten einen schnellen Editor.
Maguyva gibt dem Agenten eine Karte des Codes.

Zwei Workflows

Erst die Karte fragen, dann editieren.

// workflow 01

Die Implementierung finden, bevor der Agent einen Tab öffnet

zed agent> wo ist die Retry-Policy für ausgehende Webhooks?

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

→ Der Agent öffnet dispatch.ts:41, nicht den Mock.
[exit 0]

Eine priorisierte Abfrage ersetzt eine Runde grep. Die Antwort kommt als Pfad und Zeile zurück, die der Agent direkt öffnen kann.

// workflow 02

Abhängige prüfen, bevor sich eine Signatur ändert

zed agent> füg fetchInvoice ein timeout-Argument hinzu

dependency_search("fetchInvoice", dependents)
  7 Aufrufer in 4 Paketen

→ Der Agent aktualisiert alle sieben Aufrufstellen in einem Durchgang.
[exit 0]

Der Auswirkungsradius kommt vor der ersten Änderung, nicht erst, wenn der Build fehlschlägt.

Einrichtung in Zed

Drei Schritte. Free-Stufe: 3 Repositories, Bis zu 50K indexierte Repo-Zeilen, keine Kreditkarte.

// step 01

Ein Repo auf maguyva.ai indexieren

Wähl eins, das du schon kennst, damit du die Antworten bewerten kannst.

// step 02

Maguyva zu context_servers in deinen Zed-Einstellungen hinzufügen

~/.config/zed/settings.json

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

// step 03

Platzhalter ersetzen und eine Frage stellen

Ersetz mgv_xxxx durch deinen API-Schlüssel und speichere. Stell dem Agenten eine Frage, deren Antwort du schon kennst, und öffne dann die zitierte Datei.