Für Claude Desktop-Nutzer

Claude Desktop sieht dein Repo nicht. Gib ihm eins.

In Claude Desktop fragen viele nach Code, den sie gerade nicht bearbeiten: Reviews, Onboarding, Incident-Calls. Maguyva indexiert das Repo und stellt es über MCP bereit, damit die Antworten Dateien und Zeilen zitieren statt Erinnerungen.

Kostenlos starten Claude Desktop-Setup lesen

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

Kein Checkout nötig. Frag den Index.

Was du über Claude Desktop wissen musst

Vier Fakten speziell für Claude Desktop.

// Konfigurationsdatei

claude_desktop_config.json

Settings → Developer → Edit Config öffnet sie. Unter macOS liegt sie in ~/Library/Application Support/Claude/, unter Windows in %APPDATA%\Claude\.

// Transport

Die lokale Bridge

Diese Datei startet lokale Prozesse, also führt diese Anleitung @maguyva/mcp über npx aus. Node.js muss installiert sein.

// Schlüssel

Ein env-Eintrag

Die Bridge liest MAGUYVA_API_KEY aus dem env-Block des Servers in derselben Datei.

// Neustart

Beenden, dann neu öffnen

Claude Desktop liest die Datei beim Start. Beende die App nach dem Bearbeiten vollständig; der Server startet beim nächsten Start.

Projektanweisungen setzen den Rahmen. Nutz sie.

Claude Projects enthalten Anweisungen und Dateien, mit denen jeder Chat im Projekt beginnt. Sie sind der richtige Ort für:

Für wen die Antworten sind: Reviewer, neue Teammitglieder, On-Call-Engineers.
Den Hausstil für Erklärungen und Zusammenfassungen.
Ein paar Dokumente, die zitiert werden sollen, etwa eine Architekturübersicht.

Hochgeladene Dateien sind ein Snapshot. Das Repo ist schon am Tag nach dem Upload weitergezogen.

Wo eingefügter Code an seine Grenzen stößt

Drei Arten, wie ein Chat über Code ohne den Code schiefgeht.

// eingefügte Snippets veralten

Eine Datei, die letzte Woche in den Chat kopiert wurde, beschreibt den Code von letzter Woche. Claude antwortet selbstsicher auf Basis der Version, die es bekommen hat.

// das Snippet ist nicht das System

Eine einzelne Datei beantwortet selten “was passiert, wenn das fehlschlägt?” Handler, Retry und Alert liegen meist in drei verschiedenen Paketen.

// kein Checkout, kein grep

Claude Desktop hat keine Arbeitskopie deines Repos. Ohne Tool hängt jede Antwort zur Struktur davon ab, was du einzufügen nicht vergessen hast.

Maguyva als MCP-Server in Claude Desktop

Ein Eintrag in mcpServers gibt Claude:

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 du jede Aussage prüfen kannst.
Branch-bewusste Ergebnisse damit Claude über den Branch antwortet, den du nennst, nicht über eine Datei, die jemand letzten Monat hochgeladen hat.

Projektanweisungen sagen Claude, wie es antworten soll.
Maguyva gibt Claude den Code, auf den es sich stützen kann.

Zwei Workflows

Fragen, für die du sonst eine IDE öffnen würdest.

// workflow 01

Einen Codepfad im Review erklären

claude> was passiert, wenn ein Payment-Webhook die Signaturprüfung nicht besteht?

semantic_search("webhook signature verification failure")
  src/payments/webhooks.ts:64   verifySignature()
  src/payments/webhooks.ts:91   rejectAndAlert()

→ Claude antwortet und zitiert beide Zeilen.
[exit 0]

Jeder Schritt der Antwort zeigt auf eine Datei und eine Zeile, die du öffnen kannst.

// workflow 02

Eine Änderung abschätzen, bevor du sie planst

claude> an wie vielen Stellen wird das alte Feld plan_code gelesen?

text_pattern_search("plan_code")
  14 Treffer in 9 Dateien
dependency_search("getPlanCode", dependents)
  6 Aufrufer

→ Die Schätzung beginnt bei einer Zahl, nicht bei einer Vermutung.
[exit 0]

Praktisch im Planungsmeeting, wenn niemand das Repo offen hat.

Einrichtung in Claude Desktop

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 claude_desktop_config.json hinzufügen

claude_desktop_config.json

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

// step 03

Platzhalter ersetzen, neu starten und eine Frage stellen

Ersetz mgv_xxxx durch deinen API-Schlüssel, beende Claude Desktop vollständig und öffne es wieder. Wenn der Server nicht erscheint, lies mcp-server-maguyva.log im Log-Ordner von Claude (~/Library/Logs/Claude unter macOS).