# Claude Desktop ziet je repo niet. Laat er een zien.

Canonical source: https://maguyva.ai/nl/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 stellen veel mensen vragen over code die ze op dat moment niet bewerken: reviews, onboarding, incidentcalls. Maguyva indexeert de repo en serveert die via MCP, zodat de antwoorden bestanden en regels citeren in plaats van geheugen.

> Geen checkout nodig. Vraag het de index.

## Wat je over Claude Desktop moet weten

Vier feiten die specifiek zijn voor Claude Desktop.

### claude_desktop_config.json

Settings → Developer → Edit Config opent het. Op macOS staat het in `~/Library/Application Support/Claude/`, op Windows in `%APPDATA%\Claude\`.

### De lokale bridge

Dit bestand start lokale processen, dus deze gids draait `@maguyva/mcp` via `npx`. Node.js moet geïnstalleerd zijn.

### Een env-entry

De bridge leest `MAGUYVA_API_KEY` uit het `env`-blok van de server in hetzelfde bestand.

### Afsluiten, dan opnieuw openen

Claude Desktop leest het bestand bij het opstarten. Sluit de app na het bewerken volledig af; de server start bij de volgende keer opstarten.

## Projectinstructies zetten de opdracht neer. Gebruik ze.

Claude Projects bevatten instructies en bestanden waarmee elke chat in het project begint. Ze zijn de juiste plek voor:

- Voor wie de antwoorden zijn: een reviewer, een nieuwe collega, een engineer met dienst.
- De huisstijl voor uitleg en samenvattingen.
- Een paar documenten die je geciteerd wilt zien, zoals een architectuuroverzicht.

Geüploade bestanden zijn een momentopname. De repo was de dag na je upload alweer verder.

## Waar geplakte code tekortschiet

Drie manieren waarop een chat over code misgaat zonder de code.

### // geplakte snippets verouderen

Een bestand dat vorige week in de chat is geplakt, beschrijft de code van vorige week. Claude antwoordt zelfverzekerd op basis van de versie die het kreeg.

### // de snippet is niet het systeem

Eén bestand beantwoordt zelden “wat gebeurt er als dit faalt?” De handler, de retry en de alert zitten meestal in drie verschillende pakketten.

### // geen checkout, geen grep

Claude Desktop heeft geen werkkopie van je repo. Zonder tool hangt elk antwoord over de structuur af van wat je eraan dacht te plakken.

## Maguyva als MCP-server in Claude Desktop

Eén mcpServers-entry geeft Claude:

- **11 tools voor je geïndexeerde repo**: semantisch, structureel (AST-), graaf- en tekstzoeken, plus symbolen opzoeken, afhankelijken en bestanden ophalen.
- **Antwoorden met bestandspaden en regelnummers**: over meer dan 285 talen, zodat je elke bewering kunt controleren.
- **Branch-aware resultaten**: zodat Claude antwoordt over de branch die jij noemt, niet over een bestand dat iemand vorige maand uploadde.

> Projectinstructies vertellen Claude *hoe het moet antwoorden*.
> Maguyva geeft Claude *de code om op te bouwen*.

## Twee workflows

Vragen waarvoor je anders een IDE zou openen.

### 01. Leg een codepad uit tijdens een review

```text
claude> wat gebeurt er als een betaalwebhook de handtekeningcontrole niet doorstaat?

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

→ Claude antwoordt met beide regels geciteerd.
[exit 0]
```

Elke stap van het antwoord wijst naar een bestand en een regel die je kunt openen.

### 02. Schat een wijziging in voordat je die plant

```text
claude> hoeveel plekken lezen het oude veld plan_code?

text_pattern_search("plan_code")
  14 matches in 9 bestanden
dependency_search("getPlanCode", dependents)
  6 aanroepers

→ De schatting begint bij een getal, niet bij een gok.
[exit 0]
```

Handig in een planningsoverleg, als niemand de repo open heeft.

## Instellen in Claude Desktop

Drie stappen. Free-abonnement: 3 repositories, Tot 50K geïndexeerde repo-regels, geen creditcard nodig.

### 01. Indexeer een repo op maguyva.ai

Kies er een die je al kent, zodat je de antwoorden kunt beoordelen.

### 02. Voeg Maguyva toe aan claude_desktop_config.json

`claude_desktop_config.json`

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

### 03. Vervang de placeholder, herstart en stel één vraag

Vervang `mgv_xxxx` door je API-sleutel, sluit Claude Desktop volledig af en open het opnieuw. Verschijnt de server niet, lees dan `mcp-server-maguyva.log` in de logmap van Claude (`~/Library/Logs/Claude` op macOS).

De [MCP-gids over lokale servers](https://modelcontextprotocol.io/docs/develop/connect-local-servers) behandelt het configbestand en de logs uitgebreider.

## Indexeer één repo die je al kent.

Verbind Claude Desktop via MCP en stel één vraag die je kunt controleren.