Hopp til innhold

For Warp-brukere

Agenten i Warp bor i terminalen. Gi den et kart over repoet.

Agenten i Warp kjører kommandoer og leser det de skriver ut. Maguyva indekserer hele repoet og leverer det via MCP, så agenten spør hvor koden ligger i stedet for å kjøre grep og cat til noe passer.

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

Én mcpServers-oppføring i ~/.warp/.mcp.json: en URL og en Authorization-header.

Hva Warp må vite

Fire fakta som gjelder akkurat Warp.

// konfigurasjonsfil

~/.warp/.mcp.json

Warp starter serverne i denne globale filen på egen hånd. Du kan også lime inn samme JSON under Settings → Agents → MCP servers → + Add.

// transport

Eksternt, via URL

En url-oppføring kobler til via Streamable HTTP eller SSE. Ingenting kjører lokalt, og Node.js trengs ikke.

// nøkkel

En header i klartekst

Nøkkelen går rett i Authorization-headeren. Hold den i den globale filen, ikke i et prosjekts .warp/.mcp.json som du committer.

// prosjektfiler

Startes aldri automatisk

Warp oppdager .warp/.mcp.json i et klonet repo, men venter på at du starter hver server. Slår du det på, kan Warp også lese servere fra konfigurasjonene til Claude Code og Codex.

Prosjektregler er en samarbeidsavtale. Bruk dem.

# AGENTS.md
- Kjør make test før du kaller en endring ferdig.
- Bruk skriptene i bin/, ikke tilfeldige kommandoer.

Warp leser prosjektregler fra AGENTS.md (eller WARP.md, som går foran hvis begge finnes) og bruker Global Rules overalt. Bruk dem til:

  • Kommandoer for bygg, test og utrulling.
  • Konvensjoner agenten stadig gjør feil.
  • Kommandoer agenten aldri skal kjøre.

Regler forteller agenten hvordan den skal jobbe. De kan ikke fortelle hvilken tjeneste som fortsatt leser miljøvariabelen du snart fjerner.

Der grep i terminalen tar slutt

Tre ting en skalløkt ikke lærer billig.

// utdata ruller forbi

Hver grep og cat agenten kjører, havner i samtalen. Et søk som skriver ut to hundre linjer, bruker kontekst før det egentlige arbeidet begynner.

// et treff er ikke en kaller

grep kan ikke skille et ekte kall fra en kommentar, en fixture eller en metode med samme navn i en annen klasse.

// skallet starter kaldt

En ny økt vet ingenting om repoet. Indeksen til Maguyva er allerede bygd, så det første spørsmålet får et rangert svar.

Maguyva som MCP-server i Warp

Én mcpServers-oppføring gir agenten i Warp:

  • 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å over 285 språk, korte nok til å lese i et terminalpanel.
  • Verktøy som bare leser Verktøyene til Maguyva spør indeksen. Ingen av dem redigerer filer eller kjører kommandoer.

Warp gir agenten en terminal.

Maguyva gir agenten et kart over koden.

To arbeidsflyter

Spør kartet først, kjør kommandoer etterpå.

// workflow 01

Spor et feilende skript tilbake til kilden

warp agent> deploy.sh feiler: BUILD_ID er ikke satt. hvor blir den satt?

text_pattern_search("BUILD_ID=")
  ci/env.sh:9   export BUILD_ID=...
  docs/deploy.md:31   ← tekst

→ Agenten laster inn ci/env.sh og kjører utrullingen på nytt.
[exit 0]

Ett indeksert søk erstatter en rekursiv grep gjennom repoet og all utdataen.

// workflow 02

Sjekk kallere før et oppstartssteg endres

warp agent> kan vi slutte å kjøre migreringer ved oppstart?

dependency_search("runMigrations", dependents)
  3 kallere: server.ts, worker.ts, scripts/seed.ts

→ Agenten flytter alle tre til release-steget.
[exit 0]

Kallerne kommer før endringen, så workeren starter ikke mot et gammelt skjema.

Oppsett i Warp

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 ~/.warp/.mcp.json

    ~/.warp/.mcp.json

    {
      "mcpServers": {
        "maguyva": {
          "url": "https://maguyva.tools/mcp",
          "headers": {
            "Authorization": "Bearer mgv_xxxx"
          }
        }
      }
    }
  3. // step 03

    Bytt ut plassholderen og still ett spørsmål

    Bytt ut mgv_xxxx med API-nøkkelen din og lagre. Sjekk under Settings → Agents → MCP servers at serveren kjører, og still så ett spørsmål du allerede vet svaret på.