Voor Claude Desktop-gebruikers

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

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.

Start gratis Lees de Claude Desktop-setup

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

Geen checkout nodig. Vraag het de index.

Wat je over Claude Desktop moet weten

Vier feiten die specifiek zijn voor Claude Desktop.

// configbestand

claude_desktop_config.json

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

// transport

De lokale bridge

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

// sleutel

Een env-entry

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

// herstart

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.

// workflow 01

Leg een codepad uit tijdens een review

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.

// workflow 02

Schat een wijziging in voordat je die plant

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.

// step 01

Indexeer een repo op maguyva.ai

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

// step 02

Voeg Maguyva toe aan claude_desktop_config.json

claude_desktop_config.json

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

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