Spring til indhold

Til Claude Desktop-brugere

Claude Desktop kan ikke se dit repo. Giv det et.

I Claude Desktop spørger mange om kode, de ikke retter i lige nu: reviews, onboarding, incident-opkald. Maguyva indekserer repoet og leverer det over MCP, så svarene citerer filer og linjer i stedet for hukommelsen.

Free-niveau: 3 repos, Op til 50K indekserede repo-linjer, intet kreditkort.

Ingen checkout nødvendig. Spørg indekset.

Det skal du vide om Claude Desktop

Fire fakta, der gælder netop Claude Desktop.

// konfigurationsfil

claude_desktop_config.json

Settings → Developer → Edit Config åbner den. På macOS ligger den i ~/Library/Application Support/Claude/, på Windows i %APPDATA%\Claude\.

// transport

Den lokale bro

Denne fil starter lokale processer, så guiden kører @maguyva/mcp via npx. Node.js skal være installeret.

// nøgle

En env-post

Broen læser MAGUYVA_API_KEY fra serverens env-blok i samme fil.

// genstart

Luk, og åbn igen

Claude Desktop læser filen ved opstart. Luk appen helt, når du har rettet i den; serveren starter ved næste opstart.

Projektinstruktioner sætter rammen. Brug dem.

Claude Projects rummer instruktioner og filer, som hver chat i projektet starter med. De er det rette sted til:

  • Hvem svarene er til: en reviewer, en nyansat, en vagthavende ingeniør.
  • Husets stil for forklaringer og opsummeringer.
  • Et par dokumenter, du gerne vil have citeret, fx et arkitekturoverblik.

Uploadede filer er et øjebliksbillede. Repoet er videre dagen efter, du uploadede dem.

Hvor indsat kode slipper op

Tre måder, en chat om kode går galt på uden koden.

// indsatte uddrag bliver forældede

En fil, der blev sat ind i chatten i sidste uge, beskriver sidste uges kode. Claude svarer selvsikkert ud fra den version, det fik.

// uddraget er ikke systemet

Én fil svarer sjældent på “hvad sker der, når det her fejler?” Handleren, retry og alarmen bor som regel i tre forskellige pakker.

// ingen checkout, ingen grep

Claude Desktop har ingen arbejdskopi af dit repo. Uden et værktøj afhænger hvert svar om strukturen af, hvad du huskede at sætte ind.

Maguyva som MCP-server i Claude Desktop

Én post i mcpServers giver Claude:

  • 11 værktøjer til dit indekserede repo semantisk, strukturel (AST-), graf- og tekstsøgning, plus symbolopslag, afhængige og filhentning.
  • Svar med filstier og linjenumre på tværs af over 285 sprog, så du kan tjekke hver påstand.
  • Branch-bevidste resultater så Claude svarer om den branch, du nævner, ikke om en fil, nogen uploadede i sidste måned.

Projektinstruktioner fortæller Claude, hvordan det skal svare.

Maguyva giver Claude koden at svare ud fra.

To arbejdsgange

Spørgsmål, du ellers ville åbne en IDE for at besvare.

// workflow 01

Forklar en kodesti under et review

claude> hvad sker der, når en betalings-webhook fejler signaturtjekket?

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

→ Claude svarer og citerer begge linjer.
[exit 0]

Hvert trin i svaret peger på en fil og en linje, du kan åbne.

// workflow 02

Vurder en ændrings omfang, før du planlægger den

claude> hvor mange steder læser det gamle felt plan_code?

text_pattern_search("plan_code")
  14 match i 9 filer
dependency_search("getPlanCode", dependents)
  6 kaldere

→ Estimatet starter med et tal, ikke et gæt.
[exit 0]

Nyttigt til et planlægningsmøde, når ingen har repoet åbent.

Opsætning i Claude Desktop

Tre trin. Free-niveau: 3 repos, Op til 50K indekserede repo-linjer, intet kreditkort.

  1. // step 01

    Indekser et repo på maguyva.ai

    Vælg et, du allerede kender, så du kan vurdere svarene.

  2. // step 02

    Tilføj Maguyva til claude_desktop_config.json

    claude_desktop_config.json

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

    Udskift pladsholderen, genstart og stil ét spørgsmål

    Udskift mgv_xxxx med din API-nøgle, luk Claude Desktop helt, og åbn det igen. Hvis serveren ikke dukker op, så læs mcp-server-maguyva.log i Claudes logmappe (~/Library/Logs/Claude på macOS).