# Claude Desktop sieht dein Repo nicht. Gib ihm eins.

Canonical source: https://maguyva.ai/de/for-claude-desktop

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

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.

> Kein Checkout nötig. Frag den Index.

## Was du über Claude Desktop wissen musst

Vier Fakten speziell für Claude Desktop.

### claude_desktop_config.json

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

### Die lokale Bridge

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

### Ein env-Eintrag

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

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

### 01. Einen Codepfad im Review erklären

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

### 02. Eine Änderung abschätzen, bevor du sie planst

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

### 01. Ein Repo auf maguyva.ai indexieren

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

### 02. Maguyva zu claude_desktop_config.json hinzufügen

`claude_desktop_config.json`

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

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

Der [MCP-Leitfaden zu lokalen Servern](https://modelcontextprotocol.io/docs/develop/connect-local-servers) erklärt die Konfigurationsdatei und ihre Logs ausführlicher.

## Indexiere ein Repo, das du schon kennst.

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