# Cline plant, bevor es handelt. Gib dem Plan eine Karte.

Canonical source: https://maguyva.ai/de/for-cline

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

Cline liest Dateien, führt Befehle aus und fragt nach, bevor es etwas ändert. Maguyva indexiert das ganze Repo und liefert es über MCP zurück, damit der Plan-Modus bei echten Aufrufstellen beginnt statt bei einem Verzeichnislisting.

> .clinerules für die Arbeitsweise. Maguyva für das, was der Code jetzt sagt.

## Was du über Cline wissen musst

Vier Fakten speziell für Cline.

### cline_mcp_settings.json

Öffne sie über das MCP Servers-Symbol im Cline-Panel: Tab Configure, dann Configure MCP Servers. Server stehen unter `mcpServers`.

### Remote, per URL

Cline verbindet sich per Streamable HTTP mit dem Endpunkt von Maguyva. Kein lokaler Prozess, kein Node.js.

### Ein literaler Header

Der Schlüssel kommt direkt in den `Authorization`-Header, wie in den Beispielen von Cline selbst. Die Einstellungsdatei liegt im Benutzerspeicher deines Editors, nicht in deinem Repo.

### streamableHttp, nicht SSE

Lass `"type": "streamableHttp"` im Eintrag stehen: Ohne Typ nimmt Cline das alte SSE an. Trag die Tools, denen du vertraust, in `autoApprove` ein, um ihre Freigabeabfrage zu überspringen.

## Cline-Regeln sind eine Arbeitsvereinbarung. Nutz sie.

```text
# .clinerules/testing.md
- Führ die Testsuite aus, bevor du eine Aufgabe als erledigt markierst.
- Frag nach, bevor du eine Abhängigkeit hinzufügst.
```

Workspace-Regeln sind Markdown-Dateien in `.clinerules/` oder `.cline/rules/`; Cline liest außerdem `AGENTS.md`, `.cursorrules` und `.windsurfrules`. Regeln sind der richtige Ort für:

- Befehle, die Cline ausführen soll.
- Leitplanken, die per Frontmatter-Glob auf einen Pfad beschränkt sind.
- Team-Konventionen, die du nicht mehr ständig wiederholen willst.

Regeln sagen Cline, wie es sich verhalten soll. Sie sagen ihm nicht, welche Services die Tabelle lesen, die es gleich migriert.

## Wo Regeln und Datei-Lesen an ihre Grenzen stoßen

Drei Lücken, die Cline füllt, indem es mehr Dateien liest – eine Anfrage nach der anderen.

### // ein Plan aus einem Listing

Der Plan-Modus schlussfolgert aus dem, was Cline bisher gelesen hat. In einem großen Repo ist das ein Verzeichnisbaum und eine Handvoll Dateien, und der Plan erbt die Lücken.

### // jeder Lesezugriff ist ein Roundtrip

Jede Datei, die Cline zur Orientierung öffnet, kostet Tokens und eine Modellanfrage. Die Orientierung in einem unbekannten Paket kann einen großen Teil des Kontextfensters verbrauchen, bevor die erste Änderung steht.

### // Textsuche findet Strings, keine Aufrufer

“Wer ruft das sonst noch auf?” ist eine Graph-Frage. Eine Textsuche findet den String, trennt aber die echten Aufrufer nicht von einem Kommentar, einem Mock und einer gleichnamigen Methode.

## Maguyva als MCP-Server in Cline

Ein Eintrag in mcpServers gibt Cline:

- **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 ein Plan echte Dateien zitiert.
- **Tools, die nur lesen**: Die Tools von Maguyva fragen den Index ab. Keines davon ändert deine Dateien.

> Cline-Regeln sagen Cline, *wie es arbeiten soll*.
> Maguyva gibt Cline *eine Karte zum Planen*.

## Zwei Workflows

Nach der Karte planen, dann handeln.

### 01. Eine Änderung anhand echter Aufrufstellen planen

```text
cline plan> verschieb das Session-Refresh ins auth-Paket

dependency_search("refreshSession", dependents)
  src/api/middleware.ts:58
  src/jobs/renew.ts:12
  src/web/hooks/useSession.ts:30

→ Der Plan listet drei Aufrufstellen, bevor der Act-Modus startet.
[exit 0]
```

Der Plan nennt jede Datei, die er anfasst – du genehmigst eine Liste, kein Bauchgefühl.

### 02. Die echte Implementierung finden, nicht die Test-Fixture

```text
cline> wie berechnen wir die anteilige Abrechnung?

semantic_search("proration calculation")
  src/billing/proration.ts:22   prorate()   ← Implementierung
  test/billing/proration.spec.ts:7   ← Fixture

→ Cline liest eine Datei statt sechs.
[exit 0]
```

Priorisierte Ergebnisse setzen die Implementierung über die gleichnamige Fixture.

## Einrichtung in Cline

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 den MCP-Einstellungen von Cline hinzufügen

`cline_mcp_settings.json`

```json
{
  "mcpServers": {
    "maguyva": {
      "type": "streamableHttp",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

### 03. Platzhalter ersetzen und eine Frage stellen

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

Die [MCP-Doku](https://docs.cline.bot/mcp/mcp-overview) von Cline behandelt Remote-Server, Timeouts und automatische Freigaben.

## Indexiere ein Repo, das du schon kennst.

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