# Copilot ser dit workspace. Maguyva kortlægger repoet.

Canonical source: https://maguyva.ai/da/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 de filer, du vedhæfter, og dem, den selv finder. Maguyva indekserer hele repoet og leverer det via MCP, så agenten spørger, hvor et symbol ligger, og hvem der kalder det, før den redigerer.

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

## Hvad VS Code skal vide

Fire fakta, der gælder netop VS Code.

### .vscode/mcp.json

Servere ligger under `servers`, ikke `mcpServers`. Til alle workspaces kører du `MCP: Open User Configuration` og tilføjer den samme post til din profils `mcp.json`.

### type: http

VS Code forbinder til Maguyvas endpoint via Streamable HTTP og falder kun tilbage til SSE, hvis en server ikke understøtter det. Intet kører lokalt.

### En reference til en miljøvariabel

Headeren lyder `Bearer ${env:MAGUYVA_API_KEY}`, som VS Code slår op i det miljø, det blev startet fra, så nøglen holdes ude af den fil, du committer. Vil du hellere spørges? En inputvariabel spørger én gang og gemmer nøglen.

### Workspace Trust

Servere i `.vscode/mcp.json` starter uden en separat forespørgsel, når du har tillid til workspacet, og aldrig i begrænset tilstand. Configure Tools i chattens inputfelt slår enkelte værktøjer til eller fra.

## Brugerdefinerede instruktioner er en arbejdsaftale. Brug dem.

```text
# .github/copilot-instructions.md
- Kør npm test, før du kalder en ændring færdig.
- Redigér aldrig genererede filer under src/gen/.
```

VS Code læser instruktioner for hele projektet fra `.github/copilot-instructions.md` eller `AGENTS.md`, og målrettede instruktioner fra `.github/instructions/*.instructions.md`-filer med et `applyTo`-mønster. Brug dem til:

- Build-, test- og lint-kommandoer.
- Konventioner, agenten bliver ved med at ramme forkert.
- Mapper, agenten skal holde sig fra.

Instruktioner fortæller agenten, hvordan den skal arbejde. De kan ikke fortælle, hvilke af fire tusind filer der importerer den type, den er ved at omdøbe.

## Hvor overblikket over workspacet slutter

Tre ting, agenten ikke kan lære af de filer, den har åbne.

### // vedhæftet er ikke alt

Agenten arbejder med det, du vedhæfter, og det, dens søgninger returnerer. Kalderen i en anden pakke, der går i stykker efter ændringen, var ikke på nogen af listerne.

### // et teksthit er ikke en reference

Søgningen i workspacet finder strengen. Den kan ikke skelne et rigtigt kald fra en kommentar, en mock eller en metode med samme navn i en anden klasse.

### // hver læsning koster kontekst

Hver fil, agenten åbner for at orientere sig, bruger kontekst, den skal bruge til ændringen. Ét rangeret svar med file:line koster mindre end ti udforskende læsninger.

## Maguyva som MCP-server i VS Code

Én servers-post giver agenten:

- **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å agenten åbner den rigtige fil første gang.
- **Værktøjer, der kun læser**: Maguyvas værktøjer spørger indekset. Ingen af dem redigerer dine filer, så hver godkendelse handler om læsning, ikke skrivning.

> VS Code giver agenten *dit workspace*.
> Maguyva giver agenten *et kort over repoet*.

## To arbejdsgange

Spørg kortet først, ret bagefter.

### 01. Find testene, før en parser ændres

```text
vscode agent> hvilke tests går gennem parseConfig?

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

→ Efter ændringen kører agenten de to filer, ikke hele suiten.
[exit 0]
```

Svaret peger på de to testfiler, der når parseren, så agenten tjekker ændringen der, hvor den kan gå i stykker.

### 02. Vurdér en omdøbning før den første ændring

```text
vscode agent> omdøb OrderStatus.PENDING til OrderStatus.QUEUED

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

→ Agenten planlægger én gennemgang af ni filer.
[exit 0]
```

Antallet af referencer kommer før ændringen, ikke efter at typetjekket fejler.

## Opsætning i VS Code

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

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

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

### 02. Føj Maguyva til .vscode/mcp.json

`.vscode/mcp.json`

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

### 03. Sæt din nøgle, og start serveren

Sæt `MAGUYVA_API_KEY` i det miljø, du starter VS Code fra, og start serveren fra code lens over posten. Stil agenten ét spørgsmål, du allerede kender svaret på.

VS Codes [MCP-dokumentation](https://code.visualstudio.com/docs/agent-customization/mcp-servers) dækker inputvariabler, det portable .mcp.json-format og tillid til servere.

## Indekser ét repo, du allerede kender.

Forbind VS Code via MCP, og stil ét spørgsmål, du kan tjekke.