Zum Inhalt springen

Für Cline-Nutzer

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

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.

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

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

// Konfigurationsdatei

cline_mcp_settings.json

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

// Transport

Remote, per URL

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

// Schlüssel

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.

// Typ

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.

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

// workflow 01

Eine Änderung anhand echter Aufrufstellen planen

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.

// workflow 02

Die echte Implementierung finden, nicht die Test-Fixture

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.

  1. // step 01

    Ein Repo auf maguyva.ai indexieren

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

  2. // step 02

    Maguyva zu den MCP-Einstellungen von Cline hinzufügen

    cline_mcp_settings.json

    {
      "mcpServers": {
        "maguyva": {
          "type": "streamableHttp",
          "url": "https://maguyva.tools/mcp",
          "headers": {
            "Authorization": "Bearer mgv_xxxx"
          },
          "disabled": false,
          "autoApprove": []
        }
      }
    }
  3. // step 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.