Für Warp-Nutzer

Der Agent von Warp lebt im Terminal. Gib ihm eine Karte des Repos.

Der Agent von Warp führt Befehle aus und liest, was sie ausgeben. Maguyva indexiert das ganze Repo und liefert es über MCP aus, sodass der Agent fragt, wo Code liegt, statt grep und cat laufen zu lassen, bis etwas passt.

Kostenlos starten Warp-Setup lesen

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

Ein mcpServers-Eintrag in ~/.warp/.mcp.json: eine URL und ein Authorization-Header.

Was Warp wissen muss

Vier Fakten speziell zu Warp.

// Konfigurationsdatei

~/.warp/.mcp.json

Warp startet die Server aus dieser globalen Datei von selbst. Du kannst dasselbe JSON auch unter Settings → Agents → MCP servers → + Add einfügen.

// transport

Remote, per URL

Ein url-Eintrag verbindet sich per Streamable HTTP oder SSE. Lokal läuft nichts, und Node.js wird nicht gebraucht.

// Schlüssel

Ein literaler Header

Der Schlüssel kommt direkt in den Authorization-Header. Lass ihn in der globalen Datei, nicht in der .warp/.mcp.json eines Projekts, die du committest.

// Projektdateien

Nie automatisch gestartet

Warp erkennt .warp/.mcp.json in einem geklonten Repo, wartet aber, bis du jeden Server selbst startest. Wenn du es einschaltest, liest es auch Server aus den Konfigurationen von Claude Code und Codex.

Projektregeln sind eine Arbeitsvereinbarung. Nutze sie.

# AGENTS.md
- Führe make test aus, bevor du eine Änderung für fertig erklärst.
- Nutze die Skripte in bin/, keine spontanen Befehle.

Warp liest Projektregeln aus AGENTS.md (oder WARP.md, das Vorrang hat, wenn beide existieren) und wendet Global Rules überall an. Nutze sie für:

Build-, Test- und Deploy-Befehle.
Konventionen, die der Agent immer wieder falsch macht.
Befehle, die der Agent nie ausführen darf.

Regeln sagen dem Agenten, wie er arbeiten soll. Sie können ihm nicht sagen, welcher Dienst die Umgebungsvariable noch liest, die du gleich entfernst.

Wo grep im Terminal endet

Drei Dinge, die eine Shell-Sitzung nicht billig lernt.

// Ausgabe rauscht vorbei

Jedes grep und cat, das der Agent ausführt, landet im Gespräch. Eine Suche, die zweihundert Zeilen ausgibt, verbraucht Kontext, bevor die eigentliche Arbeit beginnt.

// Ein Treffer ist kein Aufrufer

grep kann einen echten Aufruf nicht von einem Kommentar, einer Fixture oder einer gleichnamigen Methode einer anderen Klasse unterscheiden.

// Die Shell startet kalt

Eine neue Sitzung weiß nichts über das Repo. Der Index von Maguyva ist schon gebaut, also bekommt die erste Frage eine gerankte Antwort.

Maguyva als MCP-Server in Warp

Ein mcpServers-Eintrag gibt dem Agenten von Warp:

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 in über 285 Sprachen, kurz genug für einen Terminal-Bereich.
Tools, die nur lesen Die Tools von Maguyva fragen den Index ab. Keines bearbeitet Dateien oder führt Befehle aus.

Warp gibt dem Agenten ein Terminal.
Maguyva gibt dem Agenten eine Karte des Codes.

Zwei Workflows

Erst die Karte fragen, dann Befehle ausführen.

// workflow 01

Ein fehlschlagendes Skript bis zur Ursache verfolgen

warp agent> deploy.sh schlägt fehl: BUILD_ID ist nicht gesetzt. wo wird sie gesetzt?

text_pattern_search("BUILD_ID=")
  ci/env.sh:9   export BUILD_ID=...
  docs/deploy.md:31   ← Fließtext

→ Der Agent lädt ci/env.sh und startet das Deployment neu.
[exit 0]

Eine indexierte Suche ersetzt ein rekursives grep über das Repo samt seiner Ausgabe.

// workflow 02

Aufrufer prüfen, bevor sich ein Startschritt ändert

warp agent> können wir die Migrationen beim Start weglassen?

dependency_search("runMigrations", dependents)
  3 Aufrufer: server.ts, worker.ts, scripts/seed.ts

→ Der Agent verlegt alle drei in den Release-Schritt.
[exit 0]

Die Aufrufer kommen vor der Änderung, also startet der Worker nicht gegen ein altes Schema.

Einrichtung in Warp

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 ~/.warp/.mcp.json hinzufügen

~/.warp/.mcp.json

{
  "mcpServers": {
    "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. Prüf unter Settings → Agents → MCP servers, dass der Server läuft, und stell dann eine Frage, deren Antwort du schon kennst.