# Copilot ser din arbetsyta. Maguyva kartlägger repot.

Canonical source: https://maguyva.ai/sv/for-vscode

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

Agenten i VS Code läser filerna du bifogar och de den själv hittar. Maguyva indexerar hela repot och levererar det via MCP, så agenten frågar var en symbol finns och vem som anropar den innan den redigerar.

> En servers-post i .vscode/mcp.json: en URL och en Authorization-header.

## Vad VS Code behöver veta

Fyra fakta som gäller just VS Code.

### .vscode/mcp.json

Servrar ligger under `servers`, inte `mcpServers`. För alla arbetsytor kör du `MCP: Open User Configuration` och lägger till samma post i din profils `mcp.json`.

### type: http

VS Code ansluter till Maguyvas endpoint via Streamable HTTP och faller bara tillbaka på SSE om en server saknar stöd för det. Inget körs lokalt.

### En referens till en miljövariabel

Headern är `Bearer ${env:MAGUYVA_API_KEY}`, som VS Code löser upp från miljön det startades i, så nyckeln hålls utanför filen du committar. Vill du hellre bli tillfrågad? En indatavariabel frågar en gång och sparar nyckeln.

### Workspace Trust

Servrar i `.vscode/mcp.json` startar utan separat fråga när du litar på arbetsytan, och aldrig i begränsat läge. Configure Tools i chattens inmatningsfält slår på eller av enskilda verktyg.

## Anpassade instruktioner är en arbetsöverenskommelse. Använd dem.

```text
# .github/copilot-instructions.md
- Kör npm test innan du säger att en ändring är klar.
- Redigera aldrig genererade filer under src/gen/.
```

VS Code läser instruktioner för hela projektet från `.github/copilot-instructions.md` eller `AGENTS.md`, och riktade instruktioner från `.github/instructions/*.instructions.md`-filer med ett `applyTo`-mönster. Använd dem för:

- Kommandon för bygge, test och lint.
- Konventioner som agenten gång på gång gör fel.
- Mappar som agenten ska låta bli.

Instruktioner talar om för agenten hur den ska arbeta. De kan inte tala om vilka av fyratusen filer som importerar typen den snart ska byta namn på.

## Där överblicken över arbetsytan tar slut

Tre saker agenten inte kan lära sig av filerna den har öppna.

### // bifogat är inte allt

Agenten arbetar med det du bifogar och det dess sökningar ger. Anroparen i ett annat paket som går sönder efter ändringen fanns inte på någon av listorna.

### // en textträff är ingen referens

Sökningen i arbetsytan hittar strängen. Den kan inte skilja ett riktigt anrop från en kommentar, en mock eller en metod med samma namn i en annan klass.

### // varje läsning kostar kontext

Varje fil agenten öppnar för att orientera sig tar kontext den behöver för ändringen. Ett rankat svar med file:line kostar mindre än tio utforskande läsningar.

## Maguyva som MCP-server i VS Code

En servers-post ger agenten:

- **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 agenten öppnar rätt fil direkt.
- **Verktyg som bara läser**: Maguyvas verktyg frågar indexet. Inget av dem redigerar dina filer, så varje godkännande gäller läsning, inte skrivning.

> VS Code ger agenten *din arbetsyta*.
> Maguyva ger agenten *en karta över repot*.

## Två arbetsflöden

Fråga kartan först, redigera sedan.

### 01. Hitta testerna innan en parser ändras

```text
vscode agent> vilka tester går igenom parseConfig?

dependency_search("parseConfig", dependents)
  tests/config/parse.test.ts:12
  tests/cli/flags.test.ts:88

→ Efter ändringen kör agenten de här två filerna, inte hela sviten.
[exit 0]
```

Svaret pekar ut de två testfilerna som når parsern, så agenten kontrollerar ändringen där den kan gå sönder.

### 02. Mäta ett namnbyte före första ändringen

```text
vscode agent> byt namn på OrderStatus.PENDING till OrderStatus.QUEUED

find_symbol("OrderStatus", references)
  23 referenser i 9 filer

→ Agenten planerar ett enda varv genom nio filer.
[exit 0]
```

Antalet referenser kommer före ändringen, inte efter att typkontrollen fallerar.

## Installation i VS Code

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

### 01. Indexera ett repo på maguyva.ai

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

### 02. Lägg till Maguyva i .vscode/mcp.json

`.vscode/mcp.json`

```json
{
  "servers": {
    "maguyva": {
      "type": "http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}
```

### 03. Ange din nyckel och starta servern

Ange `MAGUYVA_API_KEY` i miljön du startar VS Code från och starta servern via code lens ovanför posten. Ställ en fråga till agenten som du redan vet svaret på.

VS Codes [MCP-dokumentation](https://code.visualstudio.com/docs/agent-customization/mcp-servers) tar upp indatavariabler, det portabla .mcp.json-formatet och förtroende för servrar.

## Indexera ett repo du redan känner till.

Anslut VS Code via MCP och ställ en fråga du kan kontrollera.