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

Canonical source: https://maguyva.ai/de/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).

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.

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

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

### Remote, per URL

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

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

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

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

### 01. Die Implementierung finden, bevor der Agent einen Tab öffnet

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

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

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

### 01. Ein Repo auf maguyva.ai indexieren

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

### 02. Maguyva zu context_servers in deinen Zed-Einstellungen hinzufügen

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

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

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

Die [MCP-Doku](https://zed.dev/docs/ai/mcp) von Zed erklärt Kontextserver, Agent-Profile und Tool-Berechtigungen.

## Indexiere ein Repo, das du schon kennst.

Verbinde Zed über MCP und stell eine Frage, die du überprüfen kannst.