Spring til indhold

Til VS Code-brugere

Copilot ser dit workspace. Maguyva kortlægger repoet.

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.

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

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

// konfigurationsfil

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

// transport

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.

// nøgle

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.

// tillid

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.

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

// workflow 01

Find testene, før en parser ændres

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.

// workflow 02

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

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.

  1. // step 01

    Indekser et repo på maguyva.ai

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

  2. // step 02

    Føj Maguyva til .vscode/mcp.json

    .vscode/mcp.json

    {
      "servers": {
        "maguyva": {
          "type": "http",
          "url": "https://maguyva.tools/mcp",
          "headers": {
            "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
          }
        }
      }
    }
  3. // step 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å.