Hoppa till innehåll

För Claude Desktop-användare

Claude Desktop ser inte ditt repo. Ge det ett.

I Claude Desktop frågar många om kod de inte redigerar just då: granskningar, onboarding, incidentsamtal. Maguyva indexerar repot och levererar det via MCP, så att svaren citerar filer och rader i stället för minnet.

Free-nivå: 3 repositorier, Upp till 50K indexerade repo-rader, inget kreditkort krävs.

Ingen checkout behövs. Fråga indexet.

Det här behöver du veta om Claude Desktop

Fyra fakta som gäller just Claude Desktop.

// konfigurationsfil

claude_desktop_config.json

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

// transport

Den lokala bryggan

Den här filen startar lokala processer, så guiden kör @maguyva/mcp via npx. Node.js måste vara installerat.

// nyckel

En env-post

Bryggan läser MAGUYVA_API_KEY från serverns env-block i samma fil.

// omstart

Avsluta och öppna igen

Claude Desktop läser filen vid start. Avsluta appen helt efter att du redigerat den; servern startar vid nästa uppstart.

Projektinstruktioner sätter ramarna. Använd dem.

Claude Projects innehåller instruktioner och filer som varje chatt i projektet startar med. De passar för:

  • Vem svaren är till: en granskare, en nyanställd, en jourhavande ingenjör.
  • Husstilen för förklaringar och sammanfattningar.
  • Ett par dokument du vill få citerade, som en arkitekturöversikt.

Uppladdade filer är en ögonblicksbild. Repot har gått vidare dagen efter att du laddade upp dem.

Där inklistrad kod inte räcker

Tre sätt som en chatt om kod går fel utan koden.

// inklistrade kodsnuttar blir inaktuella

En fil som klistrades in i chatten förra veckan beskriver förra veckans kod. Claude svarar självsäkert utifrån den version det fick.

// kodsnutten är inte systemet

En enskild fil svarar sällan på “vad händer när det här misslyckas?” Hanteraren, retryn och larmet ligger oftast i tre olika paket.

// ingen checkout, ingen grep

Claude Desktop har ingen arbetskopia av ditt repo. Utan ett verktyg beror varje svar om strukturen på vad du kom ihåg att klistra in.

Maguyva som MCP-server i Claude Desktop

En post i mcpServers ger Claude:

  • 11 verktyg för ditt indexerade repo semantisk, strukturell (AST-), graf- och textsökning, plus symbolsökning, beroenden och filhämtning.
  • Svar med filsökvägar och radnummer över mer än 285 språk, så att du kan kontrollera varje påstående.
  • Grenmedvetna resultat så att Claude svarar om grenen du anger, inte om en fil som någon laddade upp förra månaden.

Projektinstruktioner talar om för Claude hur det ska svara.

Maguyva ger Claude koden att svara utifrån.

Två arbetsflöden

Frågor du annars skulle öppna en IDE för att besvara.

// workflow 01

Förklara en kodväg under en granskning

claude> vad händer när en betalningswebhook inte klarar signaturkontrollen?

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

→ Claude svarar och citerar båda raderna.
[exit 0]

Varje steg i svaret pekar på en fil och en rad som du kan öppna.

// workflow 02

Uppskatta en ändring innan du planerar den

claude> hur många ställen läser det gamla fältet plan_code?

text_pattern_search("plan_code")
  14 träffar i 9 filer
dependency_search("getPlanCode", dependents)
  6 anropare

→ Uppskattningen börjar med ett tal, inte en gissning.
[exit 0]

Användbart på ett planeringsmöte, när ingen har repot öppet.

Installation i Claude Desktop

Tre steg. Free-nivå: 3 repositorier, Upp till 50K indexerade repo-rader, inget kreditkort krävs.

  1. // step 01

    Indexera ett repo på maguyva.ai

    Välj ett du redan känner till, så du kan bedöma svaren.

  2. // step 02

    Lägg till Maguyva i 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

    Byt ut platshållaren, starta om och ställ en fråga

    Byt ut mgv_xxxx mot din API-nyckel, avsluta Claude Desktop helt och öppna det igen. Om servern inte syns, läs mcp-server-maguyva.log i Claudes loggmapp (~/Library/Logs/Claude på macOS).