# Copilot ser arbeidsområdet ditt. Maguyva kartlegger repoet.

Canonical source: https://maguyva.ai/nb/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 leser filene du legger ved, og dem den finner selv. Maguyva indekserer hele repoet og leverer det via MCP, så agenten spør hvor et symbol ligger og hvem som kaller det, før den redigerer.

> Én servers-oppføring i .vscode/mcp.json: en URL og en Authorization-header.

## Hva VS Code må vite

Fire fakta som gjelder akkurat VS Code.

### .vscode/mcp.json

Servere ligger under `servers`, ikke `mcpServers`. For alle arbeidsområder kjører du `MCP: Open User Configuration` og legger samme oppføring i profilens `mcp.json`.

### type: http

VS Code kobler til Maguyvas endepunkt via Streamable HTTP og faller bare tilbake til SSE hvis en server ikke støtter det. Ingenting kjører lokalt.

### En referanse til en miljøvariabel

Headeren er `Bearer ${env:MAGUYVA_API_KEY}`, som VS Code henter fra miljøet det ble startet i, så nøkkelen holdes utenfor filen du committer. Vil du heller bli spurt? En inndatavariabel spør én gang og lagrer nøkkelen.

### Workspace Trust

Servere i `.vscode/mcp.json` starter uten egen forespørsel når du stoler på arbeidsområdet, og aldri i begrenset modus. Configure Tools i chatfeltet slår enkeltverktøy av eller på.

## Tilpassede instruksjoner er en samarbeidsavtale. Bruk dem.

```text
# .github/copilot-instructions.md
- Kjør npm test før du kaller en endring ferdig.
- Rediger aldri genererte filer under src/gen/.
```

VS Code leser instruksjoner for hele prosjektet fra `.github/copilot-instructions.md` eller `AGENTS.md`, og målrettede instruksjoner fra `.github/instructions/*.instructions.md`-filer med et `applyTo`-mønster. Bruk dem til:

- Kommandoer for bygg, test og lint.
- Konvensjoner agenten stadig gjør feil.
- Mapper agenten skal la være.

Instruksjoner forteller agenten hvordan den skal jobbe. De kan ikke fortelle hvilke av fire tusen filer som importerer typen den snart skal gi nytt navn.

## Der oversikten over arbeidsområdet tar slutt

Tre ting agenten ikke kan lære av filene den har åpne.

### // vedlagt er ikke alt

Agenten jobber med det du legger ved og det søkene dens returnerer. Kalleren i en annen pakke som brekker etter endringen, sto ikke på noen av listene.

### // et teksttreff er ikke en referanse

Søket i arbeidsområdet finner strengen. Det kan ikke skille et ekte kall fra en kommentar, en mock eller en metode med samme navn i en annen klasse.

### // hver lesing koster kontekst

Hver fil agenten åpner for å orientere seg, bruker kontekst den trenger til endringen. Ett rangert svar med file:line koster mindre enn ti utforskende lesinger.

## Maguyva som MCP-server i VS Code

Én servers-oppføring gir agenten:

- **11 verktøy for det indekserte repoet ditt**: semantisk, strukturelt (AST-), graf- og tekstsøk, pluss symboloppslag, avhengige og filhenting.
- **Svar med filstier og linjenumre**: på tvers av over 285 språk, så agenten åpner riktig fil med en gang.
- **Verktøy som bare leser**: Verktøyene til Maguyva spør indeksen. Ingen av dem redigerer filene dine, så hver godkjenning gjelder lesing, ikke skriving.

> VS Code gir agenten *arbeidsområdet ditt*.
> Maguyva gir agenten *et kart over repoet*.

## To arbeidsflyter

Spør kartet først, rediger etterpå.

### 01. Finn testene før en parser endres

```text
vscode agent> hvilke tester går gjennom parseConfig?

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

→ Etter endringen kjører agenten disse to filene, ikke hele suiten.
[exit 0]
```

Svaret peker ut de to testfilene som når parseren, så agenten sjekker endringen der den kan brekke.

### 02. Mål et navnebytte før den første endringen

```text
vscode agent> gi OrderStatus.PENDING nytt navn til OrderStatus.QUEUED

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

→ Agenten planlegger én runde gjennom ni filer.
[exit 0]
```

Antallet referanser kommer før endringen, ikke etter at typesjekken feiler.

## Oppsett i VS Code

Tre steg. Free-planen: 3 repoer, Opptil 50K indekserte kodelinjer, uten kredittkort.

### 01. Indekser et repo på maguyva.ai

Velg ett du allerede kjenner, så du kan vurdere svarene.

### 02. Legg Maguyva til 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. Sett nøkkelen og start serveren

Sett `MAGUYVA_API_KEY` i miljøet du starter VS Code fra, og start serveren fra code lens over oppføringen. Still agenten ett spørsmål du allerede vet svaret på.

[MCP-dokumentasjonen](https://code.visualstudio.com/docs/agent-customization/mcp-servers) til VS Code dekker inndatavariabler, det portable .mcp.json-formatet og tillit til servere.

## Indekser ett repo du allerede kjenner.

Koble VS Code til via MCP, og still ett spørsmål du kan sjekke.