Hopp til innhold

For VS Code-brukere

Copilot ser arbeidsområdet ditt. Maguyva kartlegger repoet.

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.

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

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

// konfigurasjonsfil

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

// transport

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.

// nøkkel

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.

// tillit

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.

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

// workflow 01

Finn testene før en parser endres

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.

// workflow 02

Mål et navnebytte før den første endringen

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.

  1. // step 01

    Indekser et repo på maguyva.ai

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

  2. // step 02

    Legg Maguyva til i .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

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