Für VS Code-Nutzer

Copilot sieht deinen Workspace. Maguyva kartiert das Repo.

Der Agent in VS Code liest die Dateien, die du anhängst, und die, die er selbst findet. Maguyva indexiert das ganze Repo und liefert es über MCP aus, sodass der Agent vor dem Bearbeiten fragt, wo ein Symbol liegt und wer es aufruft.

Kostenlos starten VS Code-Setup lesen

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

Ein servers-Eintrag in .vscode/mcp.json: eine URL und ein Authorization-Header.

Was VS Code wissen muss

Vier Fakten speziell zu VS Code.

// Konfigurationsdatei

.vscode/mcp.json

Server stehen unter servers, nicht unter mcpServers. Für alle Workspaces führst du MCP: Open User Configuration aus und fügst denselben Eintrag in die mcp.json deines Profils ein.

// transport

type: http

VS Code verbindet sich per Streamable HTTP mit dem Endpunkt von Maguyva und weicht nur dann auf SSE aus, wenn ein Server es nicht unterstützt. Lokal läuft nichts.

// Schlüssel

Eine Umgebungsvariablen-Referenz

Der Header lautet Bearer ${env:MAGUYVA_API_KEY}. VS Code löst ihn aus der Umgebung auf, in der es gestartet wurde, also bleibt der Schlüssel aus der Datei, die du committest. Lieber eine Abfrage? Eine Input-Variable fragt einmal und speichert den Schlüssel.

// Vertrauen

Workspace Trust

Server in .vscode/mcp.json starten ohne eigene Rückfrage, sobald du dem Workspace vertraust, und im eingeschränkten Modus nie. Mit Configure Tools in der Chat-Eingabe schaltest du einzelne Tools ein oder aus.

Benutzerdefinierte Anweisungen sind eine Arbeitsvereinbarung. Nutze sie.

# .github/copilot-instructions.md
- Führe npm test aus, bevor du eine Änderung für fertig erklärst.
- Bearbeite nie generierte Dateien unter src/gen/.

VS Code liest projektweite Anweisungen aus .github/copilot-instructions.md oder AGENTS.md und gezielte aus .github/instructions/*.instructions.md-Dateien mit einem applyTo-Muster. Nutze sie für:

Build-, Test- und Lint-Befehle.
Konventionen, die der Agent immer wieder falsch macht.
Ordner, die der Agent in Ruhe lassen soll.

Anweisungen sagen dem Agenten, wie er arbeiten soll. Sie können ihm nicht sagen, welche von viertausend Dateien den Typ importieren, den er gleich umbenennt.

Wo der Blick auf den Workspace endet

Drei Dinge, die der Agent aus seinen offenen Dateien nicht lernen kann.

// Angehängt ist nicht alles

Der Agent arbeitet mit dem, was du anhängst, und dem, was seine Suchen liefern. Der Aufrufer in einem anderen Paket, der nach der Änderung bricht, stand auf keiner der beiden Listen.

// Ein Texttreffer ist keine Referenz

Die Workspace-Suche findet den String. Sie kann einen echten Aufruf nicht von einem Kommentar, einem Mock oder einer gleichnamigen Methode einer anderen Klasse unterscheiden.

// Jedes Lesen kostet Kontext

Jede Datei, die der Agent zur Orientierung öffnet, verbraucht Kontext, den er für die Änderung braucht. Eine gerankte Antwort mit file:line kostet weniger als zehn erkundende Lesevorgänge.

Maguyva als MCP-Server in VS Code

Ein servers-Eintrag gibt dem 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.
Tools, die nur lesen Die Tools von Maguyva fragen den Index ab. Keines bearbeitet deine Dateien, also geht es bei jeder Freigabe ums Lesen, nicht ums Schreiben.

VS Code gibt dem Agenten deinen Workspace.
Maguyva gibt dem Agenten eine Karte des Repos.

Zwei Workflows

Erst die Karte fragen, dann editieren.

// workflow 01

Die Tests finden, bevor sich ein Parser ändert

vscode agent> welche Tests decken parseConfig ab?

dependency_search("parseConfig", dependents)
  tests/config/parse.test.ts:12
  tests/cli/flags.test.ts:88

→ Der Agent führt nach der Änderung diese beiden Dateien aus, nicht die ganze Suite.
[exit 0]

Die Antwort nennt die zwei Testdateien, die den Parser erreichen, also prüft der Agent die Änderung dort, wo sie brechen kann.

// workflow 02

Eine Umbenennung abschätzen, bevor die erste Änderung fällt

vscode agent> benenne OrderStatus.PENDING in OrderStatus.QUEUED um

find_symbol("OrderStatus", references)
  23 Referenzen in 9 Dateien

→ Der Agent plant einen Durchgang über neun Dateien.
[exit 0]

Die Zahl der Referenzen kommt vor der Änderung, nicht erst, wenn der Typprüfer scheitert.

Einrichtung in VS Code

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

.vscode/mcp.json

{
  "servers": {
    "maguyva": {
      "type": "http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

// step 03

Schlüssel setzen und den Server starten

Setze MAGUYVA_API_KEY in der Umgebung, aus der du VS Code startest, und starte den Server über die Code Lens über seinem Eintrag. Stell dem Agenten eine Frage, deren Antwort du schon kennst.